@ankhorage/devtools 1.2.1 → 1.3.0

package/dist/tools/shared/managedFiles.js

@@ -16,10 +16,13 @@ export async function resolveManagedTargetDirectory(cwd, requestedPath) {
 }
 export async function inspectManagedFiles(targetDirectory, definitions) {
     return await Promise.all(definitions.map(async (definition) => {
-        const canonicalContents = await readCanonicalContents(definition);
         const targetPath = resolve(targetDirectory, definition.relativePath);
         try {
             const targetContents = await readFile(targetPath, 'utf8');
+            if ((definition.mode ?? 'replace') === 'create-only') {
+                return { relativePath: definition.relativePath, state: 'current' };
+            }
+            const canonicalContents = await readCanonicalContents(definition, targetDirectory);
             return {
                 relativePath: definition.relativePath,
                 state: targetContents === canonicalContents ? 'current' : 'outdated',
@@ -27,10 +30,7 @@ export async function inspectManagedFiles(targetDirectory, definitions) {
         }
         catch (error) {
             if (isMissingFileError(error)) {
-                return {
-                    relativePath: definition.relativePath,
-                    state: 'missing',
-                };
+                return { relativePath: definition.relativePath, state: 'missing' };
             }
             throw new Error(`Failed to inspect managed file: ${targetPath}`, { cause: error });
         }
@@ -41,39 +41,50 @@ export async function syncManagedFiles(targetDirectory, definitions, options) {
     const definitionsByPath = new Map(definitions.map((definition) => [definition.relativePath, definition]));
     const results = [];
     for (const status of statuses) {
-        if (status.state === 'current') {
-            results.push({ relativePath: status.relativePath, action: 'unchanged' });
-            continue;
-        }
-        const definition = definitionsByPath.get(status.relativePath);
-        if (definition === undefined) {
-            throw new Error(`Missing managed file definition for ${status.relativePath}.`);
-        }
-        if (options.dryRun) {
-            results.push({
-                relativePath: status.relativePath,
-                action: status.state === 'missing' ? 'would-create' : 'would-update',
-            });
-            continue;
-        }
-        const targetPath = resolve(targetDirectory, definition.relativePath);
-        await mkdir(dirname(targetPath), { recursive: true });
-        await writeFile(targetPath, await readCanonicalContents(definition), 'utf8');
-        results.push({
-            relativePath: status.relativePath,
-            action: status.state === 'missing' ? 'created' : 'updated',
-        });
+        const result = await syncManagedFile(targetDirectory, status, definitionsByPath, options);
+        results.push(result);
     }
     return results;
 }
-async function readCanonicalContents(definition) {
-    try {
+async function syncManagedFile(targetDirectory, status, definitionsByPath, options) {
+    if (status.state === 'current') {
+        return { relativePath: status.relativePath, action: 'unchanged' };
+    }
+    const definition = definitionsByPath.get(status.relativePath);
+    if (definition === undefined) {
+        throw new Error(`Missing managed file definition for ${status.relativePath}.`);
+    }
+    if (options.dryRun) {
+        return {
+            relativePath: status.relativePath,
+            action: status.state === 'missing' ? 'would-create' : 'would-update',
+        };
+    }
+    const targetPath = resolve(targetDirectory, definition.relativePath);
+    await mkdir(dirname(targetPath), { recursive: true });
+    await writeFile(targetPath, await readCanonicalContents(definition, targetDirectory), 'utf8');
+    return {
+        relativePath: status.relativePath,
+        action: status.state === 'missing' ? 'created' : 'updated',
+    };
+}
+async function readCanonicalContents(definition, targetDirectory) {
+    assertSingleContentSource(definition);
+    if (definition.sourceUrl !== undefined) {
         return await readFile(definition.sourceUrl, 'utf8');
     }
-    catch (error) {
-        throw new Error(`Failed to read canonical managed file: ${definition.relativePath}`, {
-            cause: error,
-        });
+    if (definition.contents !== undefined) {
+        return definition.contents;
+    }
+    if (definition.render !== undefined) {
+        return await definition.render(targetDirectory);
+    }
+    throw new Error(`Managed file has no content source: ${definition.relativePath}`);
+}
+function assertSingleContentSource(definition) {
+    const sourceCount = [definition.sourceUrl, definition.contents, definition.render].filter((value) => value !== undefined).length;
+    if (sourceCount !== 1) {
+        throw new Error(`Managed file must define exactly one content source: ${definition.relativePath}`);
     }
 }
 function isMissingFileError(error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Shared development tools and repository standards for Ankhorage",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",
@@ -24,6 +24,14 @@
       "devtools.knip",
       "devtools.sync",
       "devtools.status",
+      "devtools.eslint.sync",
+      "devtools.eslint.status",
+      "devtools.prettier.sync",
+      "devtools.prettier.status",
+      "devtools.knip.sync",
+      "devtools.knip.status",
+      "devtools.package.sync",
+      "devtools.package.status",
       "devtools.workflows.sync",
       "devtools.workflows.status",
       "devtools.vscode.sync",
@@ -59,7 +67,9 @@
       "import": "./dist/tools/knip/index.js"
     },
     "./prettier": {
-      "require": "./dist/tools/prettier/index.cjs"
+      "import": "./dist/tools/prettier/index.cjs",
+      "require": "./dist/tools/prettier/index.cjs",
+      "default": "./dist/tools/prettier/index.cjs"
     }
   },
   "files": [
@@ -85,11 +95,16 @@
     "version-packages": "changeset version"
   },
   "dependencies": {
+    "@ankhorage/utility": "^0.1.1",
     "@eslint/js": "^10.0.1",
     "eslint": "^10.2.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-native": "^5.0.0",
+    "eslint-plugin-security": "^4.0.1",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.4.1",
     "knip": "^6.12.2",