elrh-cosca 0.3.1 → 0.3.2

package/README.md

@@ -147,6 +147,18 @@ By default the function asks for confirmation before attempting to delete the `t
 
 ### List of content checkers
 
+#### `fileExists`
+
+```ts
+function fileExists(
+    targetFile: string
+): boolean
+```
+
+Checks if the specified `targetFile` exists on FS. Path is resolved relatively to `process.cwd()`. Several checks are in place to prevent accidental and malicious paths being passed in. Path traversal outside of CWD or providing absolute paths is disallowed.
+
+If the file exists , the function returns true, false otherwise.
+
 #### `hasJsonKey`
 
 ```ts

package/dist/elrh-cosca.mjs

@@ -1,9 +1,9 @@
-import { resolve as Ae, sep as Ca, join as Ps, dirname as Ei } from "node:path";
+import { resolve as we, sep as Ca, join as Ps, dirname as Ei } from "node:path";
 import { existsSync as be, readFileSync as tt, access as Ia, constants as Na, mkdirSync as Ai, copyFileSync as ka, writeFileSync as Ot, rmSync as La, promises as Oa } from "node:fs";
 import Da from "node:readline";
 import Ma from "node:https";
 import "fs";
-function Ve(a) {
+function _e(a) {
   if (console.warn(a), !a)
     return { valid: !1, error: "Path cannot be empty" };
   if (/^[A-Za-z]:/.test(a) || a.startsWith("/"))
@@ -15,14 +15,21 @@ function Ve(a) {
     return { valid: !1, error: `Path contains mixed separators: '${a}'` };
   if (/(?:^|[\/\\])\.\.(?:[\/\\]|$)/.test(a))
     return { valid: !1, error: `Path traversal not allowed: '${a}'` };
-  const o = Ae(process.cwd(), a), u = Ae(process.cwd());
+  const o = we(process.cwd(), a), u = we(process.cwd());
   return !o.startsWith(u + Ca) && o !== u ? { valid: !1, error: `Path outside of CWD not allowed: '${a}'` } : { valid: !0 };
 }
-function Fl(a, l) {
-  const r = Ve(a);
+function Fl(a) {
+  const l = _e(a);
+  if (!l.valid)
+    throw new Error(l.error);
+  const r = we(process.cwd(), a);
+  return be(r);
+}
+function Bl(a, l) {
+  const r = _e(a);
   if (!r.valid)
     throw new Error(r.error);
-  const i = Ae(process.cwd(), a);
+  const i = we(process.cwd(), a);
   if (!be(i))
     throw new Error(`No '${a}' found in project root — cannot check its keys.`);
   const o = tt(i, "utf8");
@@ -46,16 +53,16 @@ function vi(a, l) {
   }
   return !1;
 }
-function Bl(a, l) {
-  const r = Ve(a);
+function _l(a, l) {
+  const r = _e(a);
   if (!r.valid)
     throw new Error(r.error);
-  const i = Ae(process.cwd(), a);
+  const i = we(process.cwd(), a);
   if (!be(i))
     throw new Error(`No '${a}' found in project root — cannot check its contents.`);
   return tt(i, "utf8").split(/\r?\n/).map((h) => h.trim()).includes(l.trim());
 }
-async function $e(a, l) {
+async function Ve(a, l) {
   const r = Da.createInterface({
     input: l?.input || process.stdin,
     output: l?.output || process.stdout
@@ -101,17 +108,17 @@ function Ba(a) {
   }
   throw new Error(`Cannot find package "${a}" from ${process.cwd()}. Make sure it's installed or linked in this project.`);
 }
-async function _l(a, l, r = !1, i = "") {
-  if (r || await $e(
+async function jl(a, l, r = !1, i = "") {
+  if (r || await Ve(
     i || `This will create '${l}' file. Continue?`
   )) {
-    const { pkg: u, file: h } = Fa(a), d = Ba(u), g = Ae(d, h), x = Ve(l);
+    const { pkg: u, file: h } = Fa(a), d = Ba(u), g = we(d, h), x = _e(l);
     if (!x.valid)
       throw new Error(x.error);
-    const S = Ae(process.cwd(), l);
+    const S = we(process.cwd(), l);
     if (!be(g))
       throw new Error(`Template file not found at ${g}`);
-    if (be(S) && !(r || await $e(
+    if (be(S) && !(r || await Ve(
       `File '${l}' already exists. Overwrite?`
     ))) {
       console.log("Aborted.");
@@ -137,8 +144,8 @@ async function _a(a) {
     }).on("error", r);
   });
 }
-async function jl(a, l, r = !1, i = "") {
-  if (r || await $e(
+async function Rl(a, l, r = !1, i = "") {
+  if (r || await Ve(
     i || `This will create '${l}' file. Continue?`
   )) {
     let u;
@@ -148,11 +155,11 @@ async function jl(a, l, r = !1, i = "") {
       throw new Error(`Failed to fetch template from external source ${a}:
 ${x}`);
     }
-    const h = Ve(l);
+    const h = _e(l);
     if (!h.valid)
       throw new Error(h.error);
-    const d = Ae(process.cwd(), l);
-    if (be(d) && !(r || await $e(
+    const d = we(process.cwd(), l);
+    if (be(d) && !(r || await Ve(
       `File '${l}' already exists. Overwrite?`
     ))) {
       console.log("Aborted.");
@@ -166,14 +173,14 @@ ${x}`);
   } else
     console.log(`Creation of '${l}' skipped.`);
 }
-async function Rl(a, l = !1, r = "") {
-  if (l || await $e(
+async function Ul(a, l = !1, r = "") {
+  if (l || await Ve(
     r || `This will delete '${a}'. Continue?`
   )) {
-    const o = Ve(a);
+    const o = _e(a);
     if (!o.valid)
       throw new Error(o.error);
-    const u = Ae(process.cwd(), a);
+    const u = we(process.cwd(), a);
     if (be(u))
       if (La(u, { recursive: !0, force: !0 }), !be(u))
         console.log(`'${a}' deleted from project.`);
@@ -184,14 +191,14 @@ async function Rl(a, l = !1, r = "") {
   } else
     console.log(`Removing '${a}' skipped.`);
 }
-async function Ul(a, l, r = !1, i = "") {
-  if (r || await $e(
+async function $l(a, l, r = !1, i = "") {
+  if (r || await Ve(
     i || `This will delete '${l}' from '${a}' file. Continue?`
   )) {
-    const u = Ve(a);
+    const u = _e(a);
     if (!u.valid)
       throw new Error(u.error);
-    const h = Ae(process.cwd(), a);
+    const h = we(process.cwd(), a);
     if (!be(h))
       throw new Error(`No '${a}' found in project root — cannot delete its keys.`);
     const d = tt(h, "utf8");
@@ -325,8 +332,8 @@ function Dt() {
         } else
           for (ce.push(_.slice(ye, he)); he < _.length && _[he] === "/"; )
             he++;
-      for (var _e, Le = 0, he = ce.length - 1; he >= 0; he--)
-        _e = ce[he], _e === "." ? ce.splice(he, 1) : _e === ".." ? Le++ : Le > 0 && (_e === "" ? (ce.splice(he + 1, Le), Le = 0) : (ce.splice(he, 2), Le--));
+      for (var je, Le = 0, he = ce.length - 1; he >= 0; he--)
+        je = ce[he], je === "." ? ce.splice(he, 1) : je === ".." ? Le++ : Le > 0 && (je === "" ? (ce.splice(he + 1, Le), Le = 0) : (ce.splice(he, 2), Le--));
       return _ = ce.join("/"), _ === "" && (_ = me ? "/" : "."), N ? (N.path = _, u(N)) : _;
     });
     a.normalize = g;
@@ -1935,7 +1942,7 @@ function Ha() {
   };
   k.template = new M("`", !0);
   const _ = !0, N = !0, me = !0, ce = !0, ye = !0, he = !0;
-  class _e {
+  class je {
     constructor(t, e = {}) {
       this.label = void 0, this.keyword = void 0, this.beforeExpr = void 0, this.startsExpr = void 0, this.rightAssociative = void 0, this.isLoop = void 0, this.isAssign = void 0, this.prefix = void 0, this.postfix = void 0, this.binop = void 0, this.label = t, this.keyword = e.keyword, this.beforeExpr = !!e.beforeExpr, this.startsExpr = !!e.startsExpr, this.rightAssociative = !!e.rightAssociative, this.isLoop = !!e.isLoop, this.isAssign = !!e.isAssign, this.prefix = !!e.prefix, this.postfix = !!e.postfix, this.binop = e.binop != null ? e.binop : null, this.updateContext = null;
     }
@@ -1956,11 +1963,11 @@ function Ha() {
   const V = [], X = [], Y = [], ie = [], ne = [], oe = [];
   function J(p, t = {}) {
     var e, s, n, c;
-    return ++z, X.push(p), Y.push((e = t.binop) != null ? e : -1), ie.push((s = t.beforeExpr) != null ? s : !1), ne.push((n = t.startsExpr) != null ? n : !1), oe.push((c = t.prefix) != null ? c : !1), V.push(new _e(p, t)), z;
+    return ++z, X.push(p), Y.push((e = t.binop) != null ? e : -1), ie.push((s = t.beforeExpr) != null ? s : !1), ne.push((n = t.startsExpr) != null ? n : !1), oe.push((c = t.prefix) != null ? c : !1), V.push(new je(p, t)), z;
   }
   function Q(p, t = {}) {
     var e, s, n, c;
-    return ++z, Le.set(p, z), X.push(p), Y.push((e = t.binop) != null ? e : -1), ie.push((s = t.beforeExpr) != null ? s : !1), ne.push((n = t.startsExpr) != null ? n : !1), oe.push((c = t.prefix) != null ? c : !1), V.push(new _e("name", t)), z;
+    return ++z, Le.set(p, z), X.push(p), Y.push((e = t.binop) != null ? e : -1), ie.push((s = t.beforeExpr) != null ? s : !1), ne.push((n = t.startsExpr) != null ? n : !1), oe.push((c = t.prefix) != null ? c : !1), V.push(new je("name", t)), z;
   }
   const st = {
     bracketL: J("[", {
@@ -2363,7 +2370,7 @@ function Ha() {
   function Ge(p) {
     return p <= 92;
   }
-  function we(p) {
+  function Ee(p) {
     return p >= 58 && p <= 133;
   }
   function _t(p) {
@@ -2414,7 +2421,7 @@ function Ha() {
   function Rt(p) {
     return p >= 24 && p <= 25;
   }
-  function je(p) {
+  function Re(p) {
     return V[p];
   }
   V[8].updateContext = (p) => {
@@ -2438,7 +2445,7 @@ function Ha() {
     }
     return !1;
   }
-  function Re(p) {
+  function Ue(p) {
     return p < 65 ? p === 36 : p <= 90 ? !0 : p < 97 ? p === 95 : p <= 122 ? !0 : p <= 65535 ? p >= 170 && xn.test(String.fromCharCode(p)) : us(p, Xs);
   }
   function rt(p) {
@@ -2465,7 +2472,7 @@ function Ha() {
     return Pn.has(p);
   }
   function An(p, t, e) {
-    return p === 64 && t === 64 && Re(e);
+    return p === 64 && t === 64 && Ue(e);
   }
   const vn = /* @__PURE__ */ new Set(["break", "case", "catch", "continue", "debugger", "default", "do", "else", "finally", "for", "function", "if", "return", "switch", "throw", "try", "var", "const", "while", "with", "new", "this", "super", "class", "extends", "export", "import", "null", "true", "false", "in", "instanceof", "typeof", "void", "delete", "implements", "interface", "let", "package", "private", "protected", "public", "static", "yield", "eval", "arguments", "enum", "await"]);
   function Cn(p) {
@@ -3257,7 +3264,7 @@ function Ha() {
     parseStatementLike(e) {
       if (this.state.strict && this.isContextual(129)) {
         const n = this.lookahead();
-        if (we(n.type)) {
+        if (Ee(n.type)) {
           const c = this.startNode();
           return this.next(), this.flowParseInterface(c);
         }
@@ -3545,9 +3552,9 @@ function Ha() {
       let w = !1;
       if (this.isContextual(93) && !this.isLookaheadContextual("as")) {
         const F = this.parseIdentifier(!0);
-        b !== null && !we(this.state.type) ? (e.imported = F, e.importKind = b, e.local = this.cloneIdentifier(F)) : (e.imported = y, e.importKind = null, e.local = this.parseIdentifier());
+        b !== null && !Ee(this.state.type) ? (e.imported = F, e.importKind = b, e.local = this.cloneIdentifier(F)) : (e.imported = y, e.importKind = null, e.local = this.parseIdentifier());
       } else {
-        if (b !== null && we(this.state.type))
+        if (b !== null && Ee(this.state.type))
           e.imported = this.parseIdentifier(!0), e.importKind = b;
         else {
           if (s)
@@ -4538,7 +4545,7 @@ function Ha() {
         return;
       }
       if (s === k.j_oTag || s === k.j_cTag) {
-        if (Re(e)) {
+        if (Ue(e)) {
           this.jsxReadWord();
           return;
         }
@@ -5373,7 +5380,7 @@ function Ha() {
         if (this.expectPlugin("recordAndTuple"), this.getPluginOption("recordAndTuple", "syntaxType") === "bar")
           throw this.raise(e === 123 ? m.RecordExpressionHashIncorrectStartSyntaxType : m.TupleExpressionHashIncorrectStartSyntaxType, this.state.curPosition());
         this.state.pos += 2, e === 123 ? this.finishToken(7) : this.finishToken(1);
-      } else Re(e) ? (++this.state.pos, this.finishToken(139, this.readWord1(e))) : e === 92 ? (++this.state.pos, this.finishToken(139, this.readWord1())) : this.finishOp(27, 1);
+      } else Ue(e) ? (++this.state.pos, this.finishToken(139, this.readWord1(e))) : e === 92 ? (++this.state.pos, this.finishToken(139, this.readWord1())) : this.finishOp(27, 1);
     }
     readToken_dot() {
       const t = this.input.charCodeAt(this.state.pos + 1);
@@ -5623,7 +5630,7 @@ function Ha() {
           this.readWord();
           return;
         default:
-          if (Re(t)) {
+          if (Ue(t)) {
             this.readWord(t);
             return;
           }
@@ -5698,7 +5705,7 @@ function Ha() {
         ++this.state.pos, n = !0;
       else if (f === 109)
         throw this.raise(m.InvalidDecimal, s);
-      if (Re(this.codePointAtPos(this.state.pos)))
+      if (Ue(this.codePointAtPos(this.state.pos)))
         throw this.raise(m.NumberIdentifier, this.state.curPosition());
       if (n) {
         const y = this.input.slice(e, this.state.pos).replace(/[_n]/g, "");
@@ -5725,7 +5732,7 @@ function Ha() {
         this.expectPlugin("decimal", this.state.curPosition()), (f || b) && this.raise(m.InvalidDecimal, s), ++this.state.pos;
         var C = !0;
       }
-      if (Re(this.codePointAtPos(this.state.pos)))
+      if (Ue(this.codePointAtPos(this.state.pos)))
         throw this.raise(m.NumberIdentifier, this.state.curPosition());
       const F = this.input.slice(e, this.state.pos).replace(/[_mn]/g, "");
       if (c) {
@@ -5783,7 +5790,7 @@ function Ha() {
           this.state.pos += c <= 65535 ? 1 : 2;
         else if (c === 92) {
           this.state.containsEsc = !0, e += this.input.slice(n, this.state.pos);
-          const f = this.state.curPosition(), y = this.state.pos === s ? Re : rt;
+          const f = this.state.curPosition(), y = this.state.pos === s ? Ue : rt;
           if (this.input.charCodeAt(++this.state.pos) !== 117) {
             this.raise(m.MissingUnicodeEscape, this.state.curPosition()), n = this.state.pos - 1;
             continue;
@@ -6932,7 +6939,7 @@ function Ha() {
         startLoc: n
       } = this.state;
       let c, f, y, b;
-      const C = we(this.state.type) ? this.lookaheadCharCode() : null;
+      const C = Ee(this.state.type) ? this.lookaheadCharCode() : null;
       if (C === 58)
         c = !0, y = !1, f = this.parseIdentifier(!0), this.expect(14), b = this.tsParseType();
       else if (C === 63) {
@@ -8046,9 +8053,9 @@ function Ha() {
         const W = this.parseIdentifier();
         if (this.isContextual(93)) {
           const K = this.parseIdentifier();
-          we(this.state.type) ? (w = !0, y = W, b = s ? this.parseIdentifier() : this.parseModuleExportName(), C = !1) : (b = K, C = !1);
-        } else we(this.state.type) ? (C = !1, b = s ? this.parseIdentifier() : this.parseModuleExportName()) : (w = !0, y = W);
-      } else we(this.state.type) && (w = !0, s ? (y = this.parseIdentifier(!0), this.isContextual(93) || this.checkReservedWord(y.name, y.loc.start, !0, !0)) : y = this.parseModuleExportName());
+          Ee(this.state.type) ? (w = !0, y = W, b = s ? this.parseIdentifier() : this.parseModuleExportName(), C = !1) : (b = K, C = !1);
+        } else Ee(this.state.type) ? (C = !1, b = s ? this.parseIdentifier() : this.parseModuleExportName()) : (w = !0, y = W);
+      } else Ee(this.state.type) && (w = !0, s ? (y = this.parseIdentifier(!0), this.isContextual(93) || this.checkReservedWord(y.name, y.loc.start, !0, !0)) : y = this.parseModuleExportName());
       w && n && this.raise(s ? H.TypeModifierIsUsedInTypeImports : H.TypeModifierIsUsedInTypeExports, F), e[c] = y, e[f] = b;
       const $ = s ? "importKind" : "exportKind";
       e[$] = w ? "type" : "value", C && this.eatContextual(93) && (e[f] = s ? this.parseIdentifier() : this.parseModuleExportName()), e[f] || (e[f] = this.cloneIdentifier(e[c])), s && this.checkIdentifier(e[f], w ? 4098 : 4096);
@@ -8778,7 +8785,7 @@ function Ha() {
         }
         case 47: {
           const c = this.input.codePointAt(this.nextTokenStart());
-          Re(c) || c === 62 ? this.expectOnePlugin(["jsx", "flow", "typescript"]) : this.unexpected();
+          Ue(c) || c === 62 ? this.expectOnePlugin(["jsx", "flow", "typescript"]) : this.unexpected();
           break;
         }
         default:
@@ -9104,7 +9111,7 @@ function Ha() {
           value: n
         } = this.state;
         let c;
-        if (we(s))
+        if (Ee(s))
           c = this.parseIdentifier(!0);
         else
           switch (s) {
@@ -9237,7 +9244,7 @@ function Ha() {
         startLoc: s,
         type: n
       } = this.state;
-      we(n) ? e = this.state.value : this.unexpected();
+      Ee(n) ? e = this.state.value : this.unexpected();
       const c = Ge(n);
       return t ? c && this.replaceToken(132) : this.checkReservedWord(e, s, c, !1), this.next(), e;
     }
@@ -9482,14 +9489,14 @@ function Ha() {
               end: w
             } = n, C = y + 1, F = i(f.start, 1);
             p.splice(s, 1, new Je({
-              type: je(27),
+              type: Re(27),
               value: "#",
               start: y,
               end: C,
               startLoc: f.start,
               endLoc: F
             }), new Je({
-              type: je(132),
+              type: Re(132),
               value: b,
               start: C,
               end: w,
@@ -9507,14 +9514,14 @@ function Ha() {
             } = n, C = y + 1, F = i(f.start, 1);
             let $;
             t.charCodeAt(y - e) === 96 ? $ = new Je({
-              type: je(22),
+              type: Re(22),
               value: "`",
               start: y,
               end: C,
               startLoc: f.start,
               endLoc: F
             }) : $ = new Je({
-              type: je(8),
+              type: Re(8),
               value: "}",
               start: y,
               end: C,
@@ -9523,21 +9530,21 @@ function Ha() {
             });
             let W, K, ee, fe;
             c === 24 ? (K = w - 1, ee = i(f.end, -1), W = b === null ? null : b.slice(1, -1), fe = new Je({
-              type: je(22),
+              type: Re(22),
               value: "`",
               start: K,
               end: w,
               startLoc: ee,
               endLoc: f.end
             })) : (K = w - 2, ee = i(f.end, -2), W = b === null ? null : b.slice(1, -2), fe = new Je({
-              type: je(23),
+              type: Re(23),
               value: "${",
               start: K,
               end: w,
               startLoc: ee,
               endLoc: f.end
             })), p.splice(s, 1, $, new Je({
-              type: je(20),
+              type: Re(20),
               value: W,
               start: C,
               end: K,
@@ -9547,7 +9554,7 @@ function Ha() {
             continue;
           }
         }
-        n.type = je(c);
+        n.type = Re(c);
       }
     }
     return p;
@@ -9611,7 +9618,7 @@ function Ha() {
       return !1;
     }
     chStartsBindingIdentifier(t, e) {
-      if (Re(t)) {
+      if (Ue(t)) {
         if (Ts.lastIndex = e, Ts.test(this.input)) {
           const s = this.codePointAtPos(Ts.lastIndex);
           if (!rt(s) && s !== 92)
@@ -10407,7 +10414,7 @@ function Ha() {
       const s = this.startNode(), n = this.parseIdentifierName(!0), {
         type: c
       } = this.state;
-      return (we(c) ? c !== 98 || this.lookaheadCharCode() === 102 : c !== 12) ? (this.applyImportPhase(t, e, n, s.loc.start), null) : (this.applyImportPhase(t, e, null), this.createIdentifier(s, n));
+      return (Ee(c) ? c !== 98 || this.lookaheadCharCode() === 102 : c !== 12) ? (this.applyImportPhase(t, e, n, s.loc.start), null) : (this.applyImportPhase(t, e, null), this.createIdentifier(s, n));
     }
     isPrecedingIdImportPhase(t) {
       const {
@@ -10479,7 +10486,7 @@ function Ha() {
       if (e) {
         const s = this.startNodeAtNode(e);
         return s.local = e, t.specifiers.push(this.finishImportSpecifier(s, "ImportDefaultSpecifier")), !0;
-      } else if (we(this.state.type))
+      } else if (Ee(this.state.type))
         return this.parseImportSpecifierLocal(t, this.startNode(), "ImportDefaultSpecifier"), !0;
       return !1;
     }
@@ -10574,7 +10581,7 @@ function Ha() {
   function Ea(p) {
     const t = {};
     for (const e of Object.keys(p))
-      t[e] = je(p[e]);
+      t[e] = Re(p[e]);
     return t;
   }
   const Aa = Ea(st);
@@ -10899,10 +10906,10 @@ function pe(a) {
           else if (st.defaultFn)
             Ge = st.defaultFn.call(ie);
           else {
-            var we = "no value or default function given for field " + JSON.stringify(ne) + " of " + this.typeName + "(" + this.buildParams.map(function(_t) {
+            var Ee = "no value or default function given for field " + JSON.stringify(ne) + " of " + this.typeName + "(" + this.buildParams.map(function(_t) {
               return Q[_t];
             }).join(", ") + ")";
-            throw new Error(we);
+            throw new Error(Ee);
           }
           if (!se.check(Ge))
             throw new Error(
@@ -10965,7 +10972,7 @@ function pe(a) {
         Object.defineProperty(N, this.typeName, {
           enumerable: !0,
           value: this.type
-        }), this.finalized = !0, Le(this.typeName, this.supertypeList), this.buildable && this.supertypeList.lastIndexOf("Expression") >= 0 && _e(this.typeName);
+        }), this.finalized = !0, Le(this.typeName, this.supertypeList), this.buildable && this.supertypeList.lastIndexOf("Expression") >= 0 && je(this.typeName);
       }
     }
   }
@@ -11052,7 +11059,7 @@ function pe(a) {
       return V.call(this, Y, ce(z, Y));
     }, X);
   }
-  function _e(z) {
+  function je(z) {
     var V = _(z);
     if (R[V])
       return;
@@ -12771,7 +12778,7 @@ const {
   builders: Bt,
   builtInTypes: Fe,
   getFieldNames: xo,
-  getFieldValue: Ue,
+  getFieldValue: $e,
   namedTypes: bo,
   NodePath: To,
   someField: Po
@@ -13617,12 +13624,12 @@ function jo(a, l) {
   return u.push(l(a)), L(u);
 }
 function di(a, l) {
-  const r = a.getValue(), i = l(a), o = ft.Node.check(r) && Ue(r, "comments");
+  const r = a.getValue(), i = l(a), o = ft.Node.check(r) && $e(r, "comments");
   if (!o || o.length === 0)
     return i;
   const u = [], h = [i];
   return a.each(function(d) {
-    const g = d.getValue(), x = Ue(g, "leading"), S = Ue(g, "trailing");
+    const g = d.getValue(), x = $e(g, "leading"), S = $e(g, "trailing");
     x || S && !(ft.Statement.check(r) || g.type === "Block" || g.type === "CommentBlock") ? u.push(_o(d, l)) : S && h.push(jo(d, l));
   }, "comments"), u.push.apply(u, h), L(u);
 }
@@ -14184,7 +14191,7 @@ function Us(a, l, r) {
   for (let d in u) {
     if (d.charAt(0) === "_")
       continue;
-    a.stack.push(d, Ue(i, d)), l.stack.push(d, Ue(o, d));
+    a.stack.push(d, $e(i, d)), l.stack.push(d, $e(o, d));
     const g = tn(a, l, r);
     if (a.stack.length -= 2, l.stack.length -= 2, !g)
       return !1;
@@ -14329,7 +14336,7 @@ function sl(a, l, r) {
     case "MemberExpression":
     case "OptionalMemberExpression": {
       o.push(a.call(r, "object"));
-      const u = a.call(r, "property"), h = Ue(i, "optional");
+      const u = a.call(r, "property"), h = $e(i, "optional");
       return i.computed ? o.push(h ? "?.[" : "[", u, "]") : o.push(h ? "?." : ".", u), L(o);
     }
     case "ChainExpression":
@@ -14482,7 +14489,7 @@ function sl(a, l, r) {
     }
     case "CallExpression":
     case "OptionalCallExpression":
-      return o.push(a.call(r, "callee")), i.typeParameters && o.push(a.call(r, "typeParameters")), i.typeArguments && o.push(a.call(r, "typeArguments")), Ue(i, "optional") && o.push("?."), o.push(Ti(a, l, r)), L(o);
+      return o.push(a.call(r, "callee")), i.typeParameters && o.push(a.call(r, "typeParameters")), i.typeArguments && o.push(a.call(r, "typeArguments")), $e(i, "optional") && o.push("?."), o.push(Ti(a, l, r)), L(o);
     case "RecordExpression":
       o.push("#");
     case "ObjectExpression":
@@ -15648,7 +15655,7 @@ function Qt(a) {
   return a.replace(/['"]/g, (l) => l === '"' ? "'" : '"');
 }
 function ht(a) {
-  const l = Ue(a, "value"), r = Ue(a, "extra");
+  const l = $e(a, "value"), r = $e(a, "extra");
   if (r && typeof r.raw == "string" && l == r.rawValue)
     return r.raw;
   if (a.type === "Literal") {
@@ -15857,7 +15864,7 @@ function ke(a, l, r) {
     }
   );
 }
-const Ee = Bt, ks = /* @__PURE__ */ new WeakMap();
+const Ae = Bt, ks = /* @__PURE__ */ new WeakMap();
 function dl(a, l, r) {
   if (ks.has(l))
     return ks.get(l);
@@ -15894,9 +15901,9 @@ function dl(a, l, r) {
           (h) => h.type === "ImportDeclaration" && h.source.value === o
         );
         u ? u.specifiers.push(l) : r.body.unshift(
-          Ee.importDeclaration(
+          Ae.importDeclaration(
             [l],
-            Ee.stringLiteral(o)
+            Ae.stringLiteral(o)
           )
         );
       },
@@ -15928,9 +15935,9 @@ function ml(a, l) {
     const x = r(), S = x.find((P) => P.local === h), A = d.local || h;
     if (S)
       return S.imported = d.imported, S.local = A, S.from = d.from, !0;
-    const v = d.imported === "default" ? Ee.importDefaultSpecifier(Ee.identifier(A)) : d.imported === "*" ? Ee.importNamespaceSpecifier(Ee.identifier(A)) : Ee.importSpecifier(
-      Ee.identifier(d.imported),
-      Ee.identifier(A)
+    const v = d.imported === "default" ? Ae.importDefaultSpecifier(Ae.identifier(A)) : d.imported === "*" ? Ae.importNamespaceSpecifier(Ae.identifier(A)) : Ae.importSpecifier(
+      Ae.identifier(d.imported),
+      Ae.identifier(A)
     ), I = x.find(
       (P) => P.from === d.from
     )?.$declaration;
@@ -15938,14 +15945,14 @@ function ml(a, l) {
       I.specifiers.push(v);
     else if (g === "prepend" || x.length === 0)
       a.body.unshift(
-        Ee.importDeclaration([v], Ee.stringLiteral(d.from))
+        Ae.importDeclaration([v], Ae.stringLiteral(d.from))
       );
     else {
       const P = x.at(-1).$declaration, E = a.body.indexOf(P);
       a.body.splice(
         E + 1,
         0,
-        Ee.importDeclaration([v], Ee.stringLiteral(d.from))
+        Ae.importDeclaration([v], Ae.stringLiteral(d.from))
       );
     }
     return !0;
@@ -16456,14 +16463,14 @@ function ln(a, l) {
       i && !o ? ln(a[r], l[r]) : o ? a[r] = a[r] ? [.../* @__PURE__ */ new Set([...a[r], ...l[r]])] : l[r] : a[r] = l[r];
     }
 }
-async function Hl(a, l, r = !1, i = "") {
-  if (r || await $e(
+async function Kl(a, l, r = !1, i = "") {
+  if (r || await Ve(
     i || `This will update '${a}' file. Continue?`
   )) {
-    const u = Ve(a);
+    const u = _e(a);
     if (!u.valid)
       throw new Error(u.error);
-    const h = Ae(process.cwd(), a);
+    const h = we(process.cwd(), a);
     if (!be(h))
       throw new Error(`No '${a}' found in project root — cannot update its contents.`);
     const d = await Nl(h);
@@ -16490,14 +16497,14 @@ async function Hl(a, l, r = !1, i = "") {
   } else
     console.log(`Updating '${a}' skipped.`);
 }
-async function Kl(a, l, r, i = !1, o = "") {
-  if (i || await $e(
+async function Xl(a, l, r, i = !1, o = "") {
+  if (i || await Ve(
     o || `This will update '${a}' file. Continue?`
   )) {
-    const h = Ve(a);
+    const h = _e(a);
     if (!h.valid)
       throw new Error(h.error);
-    const d = Ae(process.cwd(), a);
+    const d = we(process.cwd(), a);
     if (!be(d))
       throw new Error(`No '${a}' found in project root — cannot update its contents.`);
     const g = tt(d, "utf8");
@@ -16520,14 +16527,14 @@ ${A}`);
   } else
     console.log(`Updating '${a}' skipped.`);
 }
-async function Xl(a, l, r = !1, i = "") {
-  if (r || await $e(
+async function Gl(a, l, r = !1, i = "") {
+  if (r || await Ve(
     i || `This will update '${a}' file. Continue?`
   )) {
-    const u = Ve(a);
+    const u = _e(a);
     if (!u.valid)
       throw new Error(u.error);
-    const h = Ae(process.cwd(), a);
+    const h = we(process.cwd(), a);
     if (!be(h))
       throw new Error(`No '${a}' found in project root — cannot update its contents.`);
     const g = tt(h, "utf8").split(/\r?\n/);
@@ -16540,19 +16547,19 @@ async function Xl(a, l, r = !1, i = "") {
   } else
     console.log(`Updating '${a}' skipped.`);
 }
-function Gl(a, l = 1) {
+function Ql(a, l = 1) {
   process.stderr.write(a);
   for (let r = 0; r < l; r++)
     process.stderr.write(`
 `);
 }
-function Ql(a, l = 1) {
+function Yl(a, l = 1) {
   process.stdout.write(a);
   for (let r = 0; r < l; r++)
     process.stdout.write(`
 `);
 }
-function Yl(a, l = Ae(process.cwd(), ".env")) {
+function Zl(a, l = we(process.cwd(), ".env")) {
   if (!be(l))
     return;
   const r = tt(l, "utf-8");
@@ -16567,19 +16574,20 @@ function Yl(a, l = Ae(process.cwd(), ".env")) {
   }
 }
 export {
-  _l as createFileFromTemplate,
-  jl as createFileFromWebTemplate,
-  Rl as deletePath,
-  Yl as getEnvValue,
-  Fl as hasJsonKey,
-  Bl as hasText,
+  jl as createFileFromTemplate,
+  Rl as createFileFromWebTemplate,
+  Ul as deletePath,
+  Fl as fileExists,
+  Zl as getEnvValue,
+  Bl as hasJsonKey,
+  _l as hasText,
   Fa as parseQualifiedPath,
-  $e as promptUser,
-  Ul as removeFromJsonFile,
+  Ve as promptUser,
+  $l as removeFromJsonFile,
   Ba as resolvePackagePath,
-  Gl as showError,
-  Ql as showMessage,
-  Hl as updateConfigFile,
-  Kl as updateJsonFile,
-  Xl as updateTextFile
+  Ql as showError,
+  Yl as showMessage,
+  Kl as updateConfigFile,
+  Xl as updateJsonFile,
+  Gl as updateTextFile
 };

package/dist/types/checks/file-exists.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Checks if the specified file exists on FS.
+ *
+ * @param {string} targetFile - The path to the text file to be checked (relative to CWD).
+ * @returns {boolean} True if the file exists, false otherwise.
+ * @throws Will throw an error if the path is invalid (can't traverse past CWD).
+ */
+export declare function fileExists(targetFile: string): boolean;

package/dist/types/main.d.ts

@@ -1,3 +1,4 @@
+import { fileExists } from './checks/file-exists';
 import { hasJsonKey } from './checks/has-json-key';
 import { hasText } from './checks/has-text';
 import { createFileFromTemplate } from './functions/create-file-from-template';
@@ -13,4 +14,4 @@ import { showMessage } from './terminal/show-message';
 import { getEnvValue } from './utils/get-env-value';
 import { parseQualifiedPath } from './utils/parse-qualified-path';
 import { resolvePackagePath } from './utils/resolve-package-path';
-export { hasJsonKey, hasText, createFileFromTemplate, createFileFromWebTemplate, deletePath, removeFromJsonFile, updateConfigFile, updateJsonFile, updateTextFile, promptUser, showError, showMessage, getEnvValue, parseQualifiedPath, resolvePackagePath, };
+export { fileExists, hasJsonKey, hasText, createFileFromTemplate, createFileFromWebTemplate, deletePath, removeFromJsonFile, updateConfigFile, updateJsonFile, updateTextFile, promptUser, showError, showMessage, getEnvValue, parseQualifiedPath, resolvePackagePath, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elrh-cosca",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "files": [
     "dist"