elrh-cosca 0.1.4 → 0.2.0

package/dist/types/lib/update-config-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Update the single object-literal config found in a file.
+ *
+ * The function:
+ * - Reads and edits the file as code (no execution).
+ * - Uses `defu(newConfig, existingConfig)` so `newConfig` takes precedence.
+ * - Applies the merged result back onto the AST to preserve TS/ESM structure.
+ *
+ * @param {string} pathToFile - Path to file, relative to project root (process.cwd()).
+ * @param {object} newConfig - Config to merge in (takes precedence).
+ * @returns {Promise<void>}
+ */
+export declare function updateConfigFile(pathToFile: string, newConfig: Record<string | number | symbol, any>, force?: boolean): Promise<void>;

package/dist/types/lib/update-json-file.d.ts

@@ -1 +1 @@
-export declare function updateJsonFile(pathToFile: string, jsonKey: string, newValues: Record<string, string>, force?: boolean): Promise<void>;
+export declare function updateJsonFile(pathToFile: string, jsonKey: string, newValues: Record<string | number | symbol, any>, force?: boolean): Promise<void>;

package/dist/types/main.d.ts

@@ -1,5 +1,6 @@
 import { createFileFromTemplate } from './lib/create-file-from-template';
 import { promptUser } from './lib/prompt-user';
+import { updateConfigFile } from './lib/update-config-file';
 import { updateJsonFile } from './lib/update-json-file';
 import { updateTextFile } from './lib/update-text-file';
-export { createFileFromTemplate, promptUser, updateJsonFile, updateTextFile, };
+export { createFileFromTemplate, promptUser, updateConfigFile, updateJsonFile, updateTextFile, };

package/dist/types/utils/better-deep-merge.d.ts

@@ -0,0 +1 @@
+export declare function deepMergeObject(magicast: any, object: any): void;

package/dist/types/utils/resolve-package.d.ts

@@ -8,6 +8,7 @@ export declare function parseTemplatePath(input: string): {
 };
 /**
  * Resolve a package's installed root directory *from the target app*.
+ * Package name can be scoped.
  * Works with npm/yarn/pnpm, hoisting or not.
  */
 export declare function resolvePackagePath(packageName: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elrh-cosca",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "type": "module",
   "files": [
     "dist"
@@ -21,6 +21,7 @@
   "types": "./dist/types/index.d.ts",
   "devDependencies": {
     "@types/node": "^24.3.0",
+    "magicast": "^0.3.5",
     "typescript": "^5.9.2",
     "vite": "^7.1.3",
     "vite-plugin-dts": "^4.5.4",

package/test/cosca-test.js

@@ -1,10 +1,13 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 // manual test script for COSCA functions
 
-import { createFileFromTemplate, promptUser, updateJsonFile, updateTextFile } from '../dist/elrh-cosca.mjs'
+import { 
+  createFileFromTemplate, promptUser, updateConfigFile, updateJsonFile, updateTextFile 
+} from '../dist/elrh-cosca.mjs'
 
 async function main() {
+  /*
   console.log('Test promptUser')
   const input = await promptUser('Is it today?')
   console.log('User input:', input)
@@ -12,12 +15,18 @@ async function main() {
   console.log('\nTest createFileFromTemplate')
   await createFileFromTemplate('vite:README.md', 'test.file1')
   await createFileFromTemplate('elrh-cosca:README.md', 'test.file2')
+  */
 
+  console.log('\nTest updateConfigFile')
+  await updateConfigFile('test/cosca-test-config.ts', { compatibilityDate: '2025-08-26', extends: ['nuxt-iignis'], cosca: { exists: true, data: ['some', 'other'], raw: 'war' } })
+
+  /*
   console.log('\nTest updateJsonFile')
   await updateJsonFile('package.json', 'scripts', { 'cosca' : 'cosca' })
 
   console.log('\nTest updateTextFile')
   await updateTextFile('.gitignore', ['# COSCA'])
+  */
 }
 
 main().catch((err) => {

package/dist/elrh-cosca.cjs

@@ -1,4 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("node:path"),n=require("node:fs"),w=require("node:readline"),g=require("node:module"),y=e=>e&&e.__esModule?e:{default:e},h=y(w);async function p(e){const t=h.default.createInterface({input:process.stdin,output:process.stdout});return new Promise(o=>{t.question(e+" (y/N): ",r=>{t.close(),o(/^y(es)?$/i.test(r.trim()))})})}function m(e){const t=e.indexOf(":");if(t<=0||t===e.length-1)throw new Error(`Invalid input "${e}". Expected format is "package:relative/path/to/file".`);const o=e.slice(0,t).trim(),r=e.slice(t+1).replace(/^[/\\]+/,"");if(!o||o.endsWith("/")||o.includes(" "))throw new Error(`Invalid package name in templatePath: "${o}"`);return{pkg:o,file:r}}function $(e){try{const t=process.cwd(),o=a.join(t,"package.json"),r=n.readFileSync(o,"utf8");if(JSON.parse(r)?.name===e)return t}catch{}try{const o=g.createRequire(a.resolve(process.cwd(),"package.json")).resolve(`${e}/package.json`);return a.dirname(o)}catch{throw new Error(`Cannot find package "${e}" from ${process.cwd()}. Make sure it's installed or linked in this project.`)}}async function k(e,t,o=!1){if(o||await p(`This will create '${t}' file. Continue?`)){const{pkg:c,file:d}=m(e),l=$(c),s=a.resolve(l,d),i=a.resolve(process.cwd(),t);n.existsSync(s)||(console.error(`Template file not found at ${s}`),process.exit(1)),n.existsSync(i)&&(o||await p(`File '${t}' already exists. Overwrite?`)||(console.log("Aborted."),process.exit(0))),n.copyFileSync(s,i),console.log(`New file '${t}' successfully created.`)}else console.log(`Creation of '${t}' skipped.`)}async function x(e,t,o,r=!1){if(r||await p(`This will update '${e}' file. Continue?`)){const d=a.resolve(process.cwd(),e);if(!n.existsSync(d)){console.warn(`No '${e}' found in project root — skipping updates.`);return}const l=n.readFileSync(d,"utf8");let s;try{s=JSON.parse(l)}catch{console.error(`Could not parse '${e}' — skipping updates.`);return}s[t]=s[t]||{};let i=!1;for(const[u,f]of Object.entries(o))s[t][u]!==f&&(s[t][u]=f,i=!0);i?(n.writeFileSync(d,JSON.stringify(s,null,2)+`
-`,"utf8"),console.log(`'${e}' file updated.`)):console.log(`'${e}' file already up to date.`)}else console.log(`Updating '${e}' skipped.`)}async function P(e,t,o=!1){if(o||await p(`This will update '${e}' file. Continue?`)){const c=a.resolve(process.cwd(),e);if(!n.existsSync(c)){console.warn(`No '${e}' found in project root — skipping updates.`);return}const l=n.readFileSync(c,"utf8").split(/\r?\n/);let s=!1;for(const i of t)l.includes(i)||(l.push(i),s=!0);s?(n.writeFileSync(c,l.join(`
-`)+`
-`,"utf8"),console.log(`'${e}' file updated.`)):console.log(`'${e}' file already up to date.`)}else console.log(`Updating '${e}' skipped.`)}exports.createFileFromTemplate=k;exports.promptUser=p;exports.updateJsonFile=x;exports.updateTextFile=P;