elrh-cosca 0.3.1 → 0.3.3

package/README.md

@@ -1,5 +1,5 @@
 # COSCA
-Library of file-writting functions that help building CLI scripts for making changes in target projects - like adding default configuration files or new sections in `package.json`.
+Library of file-writing functions that help building CLI scripts for making changes in target projects - like adding default configuration files or new sections in `package.json`.
 
 The first experimental "customers" are my [Nuxt Spec](https://github.com/AloisSeckar/nuxt-spec) and [Nuxt Ignis](https://github.com/AloisSeckar/nuxt-ignis) projects.
 
@@ -27,12 +27,12 @@ Path to `templateFile` must be prefixed with the package name to allow proper re
 
 Path to `targetFile` is relative to `process.cwd()` which allows consumers to run `npx your-script` in their project roots during development.  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 target directory does not exist, it will be automatically created.
 
-By default the function asks for confirmation before attempting to create the file and if the file with the same name as `targetFile` is detected. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passsing a custom `prompt` allows tailoring your own question to the user.
+By default the function asks for confirmation before attempting to create the file and if the file with the same name as `targetFile` is detected. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passing a custom `prompt` allows tailoring your own question to the user.
 
 #### `createFileFromWebTemplate`
 
 ```ts
-async function createFileWebFromTemplate(
+async function createFileFromWebTemplate(
   url: string, targetFile: string, force: boolean = false, prompt: string = ''
 ): Promise<void>
 ```
@@ -43,7 +43,7 @@ Contents of `url` must be accessible via `node:https.get` function and will be f
 
 Path to `targetFile` is relative to `process.cwd()` which allows consumers to run `npx your-script` in their project roots during development.  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 target directory does not exist, it will be automatically created.
 
-By default the function asks for confirmation before attempting to create the file and if the file with the same name as `targetFile` is detected. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passsing a custom `prompt` allows tailoring your own question to the user.
+By default the function asks for confirmation before attempting to create the file and if the file with the same name as `targetFile` is detected. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passing a custom `prompt` allows tailoring your own question to the user.
 
 #### `updateConfigFile`
 
@@ -75,7 +75,7 @@ TypeError: 'set' on proxy: trap returned falsish for property '<YOUR_PROPERTY>'
 If possible, you need to alter your logic, e.g. by creating a new object via the spread operator.
 
 
-By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passsing a custom `prompt` allows tailoring your own question to the user.
+By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passing a custom `prompt` allows tailoring your own question to the user.
 
 #### `updateJsonFile`
 
@@ -99,7 +99,7 @@ Path to `targetFile` is relative to `process.cwd()`. Several checks are in place
 
 Currently it only allows adding new values under top-level keys. If the `jsonKey` exists, new values are merged into existing ones. Otherwise, new key is added. The function tracks if any real change was made and notifies the user if not.
 
-By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passsing a custom `prompt` allows tailoring your own question to the user.
+By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passing a custom `prompt` allows tailoring your own question to the user.
 
 #### `updateTextFile`
 
@@ -113,7 +113,7 @@ Takes a path to a plain text file and injects `rowsToAdd` at the end of the file
 
 Path to `targetFile` is relative 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. 
 
-By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passsing a custom `prompt` allows tailoring your own question to the user.
+By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passing a custom `prompt` allows tailoring your own question to the user.
 
 #### `removeFromJsonFile`
 
@@ -129,7 +129,7 @@ Path to `targetFile` is relative to `process.cwd()`. Several checks are in place
 
 Given `jsonKey` might point to a nested key using dot notation, e.g. `a.b.c`. If the key is not present, the function does nothing.
 
-By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passsing a custom `prompt` allows tailoring your own question to the user.
+By default the function asks for confirmation before attempting to alter the `targetFile`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passing a custom `prompt` allows tailoring your own question to the user.
 
 #### `deletePath`
 
@@ -143,10 +143,22 @@ Deletes given `targetPath` from FS. Path is resolved relatively to `process.cwd(
 
 If the `targetPath` does not exist, the function does nothing.
 
-By default the function asks for confirmation before attempting to delete the `targetPath`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passsing a custom `prompt` allows tailoring your own question to the user.
+By default the function asks for confirmation before attempting to delete the `targetPath`. Setting the last optional parameter `force` to `true` will suppress manual confirmation prompts. Passing a custom `prompt` allows tailoring your own question to the user.
 
 ### 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,10 +1,10 @@
-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) {
-  if (console.warn(a), !a)
+function _e(a) {
+  if (!a)
     return { valid: !1, error: "Path cannot be empty" };
   if (/^[A-Za-z]:/.test(a) || a.startsWith("/"))
     return { valid: !1, error: `Path must be relative to CWD: '${a}'` };
@@ -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/functions/delete-path.d.ts

@@ -1,10 +1,10 @@
 /**
  * Deletes given path from FS.
  *
- * @param {string} targetPath - The path to the JSON file to update (relative to CWD).
- * @param {boolean} force - Whether to force the update without prompting.
+ * @param {string} targetPath - The path to delete (relative to CWD).
+ * @param {boolean} force - Whether to force the deletion without prompting.
  * @param {string} prompt - Custom prompt message displayed in terminal.
- * @returns {Promise<void>} An empty promise that resolves when the file is updated.
- * @throws Will throw an error if the path is invalid, the file does not exist or cannot be parsed as JSON.
+ * @returns {Promise<void>} An empty promise that resolves when the path is deleted.
+ * @throws Will throw an error if the path is invalid.
  */
 export declare function deletePath(targetPath: string, force?: boolean, prompt?: string): Promise<void>;

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.3",
   "type": "module",
   "files": [
     "dist"
@@ -18,10 +18,10 @@
   "module": "./dist/elrh-cosca.mjs",
   "types": "./dist/types/index.d.ts",
   "devDependencies": {
-    "@types/node": "^24.3.0",
+    "@types/node": "^24.6.0",
     "magicast": "^0.3.5",
-    "typescript": "^5.9.2",
-    "vite": "^7.1.3",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.8",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^3.2.4"
   },