@augment-vir/node 31.12.0 → 31.14.0

package/dist/scripts/fix-src-imports.script.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/fix-src-imports.script.js

@@ -0,0 +1,73 @@
+/* node:coverage disable */
+/**
+ * This script is used to replace all `/src/` imports with `/dist/`. This is used for making a
+ * compiled, but not bundled (because that would affect relative file path variables), backend
+ * mono-repo be able to run without `tsx`. (Because `tsx` uses a lot more memory than plain
+ * `node`.)
+ *
+ * To use this script properly, call it after compiling your backend. It should be run from your
+ * mono-repo root. Like this:
+ *
+ * ```json
+ * {
+ *     "scripts": {
+ *         "build:backend": "npm run compile && npx tsx node_modules/@augment-vir/node/src/scripts/fix-src-imports.script.ts"
+ *     }
+ * }
+ * ```
+ */
+import { assert, check } from '@augment-vir/assert';
+import { filterMap, log } from '@augment-vir/common';
+import { joinFilesToDir, readJsonFile, runShellCommand, writeJsonFile } from '@augment-vir/node';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { queryNpmWorkspace } from '../augments/npm/query-workspace.js';
+const propertiesToReplace = [
+    'main',
+    'module',
+];
+async function findFilesThatNeedImportFixes(monoRepoPath) {
+    const { stdout } = await runShellCommand('find . -type d -name "node_modules" -prune -o -type f -path "*/dist/*.js" -exec grep -lE "from \'.*?/src/.*?\';" {} +', {
+        rejectOnError: true,
+        cwd: monoRepoPath,
+    });
+    const files = filterMap(stdout.trim().split('\n'), (line) => line.trim(), check.isTruthy);
+    return joinFilesToDir(monoRepoPath, files);
+}
+async function updateAllPackageJsonPaths(monoRepoPath) {
+    const workspaces = await queryNpmWorkspace(monoRepoPath);
+    await Promise.all(workspaces.map(async (workspace) => {
+        const packageJsonPath = join(workspace.path, 'package.json');
+        const packageJson = (await readJsonFile(packageJsonPath));
+        assert.isObject(packageJson);
+        let modified = false;
+        propertiesToReplace.forEach((property) => {
+            if (property in packageJson && check.isString(packageJson[property])) {
+                modified = true;
+                packageJson[property] = packageJson[property]
+                    .replace('src/', 'dist/')
+                    .replace('.ts', '.js');
+            }
+        });
+        if (modified) {
+            await writeJsonFile(packageJsonPath, packageJson);
+            log.faint(`Updated ${relative(monoRepoPath, packageJsonPath)}`);
+        }
+    }));
+}
+async function fixAllSrcImports(monoRepoPath) {
+    const filePaths = await findFilesThatNeedImportFixes(monoRepoPath);
+    await Promise.all(filePaths.map(async (filePath) => {
+        const contents = String(await readFile(filePath));
+        const fixedContents = contents.replaceAll(/(from ["'][^'"]+?)\/src\/([^'"]+)['"];/g, "$1/dist/$2';");
+        await writeFile(filePath, fixedContents);
+        log.faint(`Fixed imports in ${relative(monoRepoPath, filePath)}`);
+    }));
+}
+async function fixAll(monoRepoPath) {
+    await Promise.all([
+        updateAllPackageJsonPaths(monoRepoPath),
+        fixAllSrcImports(monoRepoPath),
+    ]);
+}
+await fixAll(process.cwd());

package/dist/scripts/fix-ts-bin.script.js

@@ -1,5 +1,9 @@
 /* node:coverage disable */
 /**
+ * This script is used to replace `node_modules/.bin` files so that they run with typescript. This
+ * is used in dev for packages that are dependencies of the listed packages (in `packagesToFix`),
+ * such as `augment-vir` itself.
+ *
  * To use this script properly, call it directly in your postinstall script. Like this:
  *
  * ```json

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/node",
-    "version": "31.12.0",
+    "version": "31.14.0",
     "description": "A collection of augments, helpers types, functions, and classes only for Node.js (backend) JavaScript environments.",
     "keywords": [
         "augment",
@@ -38,8 +38,8 @@
         "test:update": "npm test"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.12.0",
-        "@augment-vir/common": "^31.12.0",
+        "@augment-vir/assert": "^31.14.0",
+        "@augment-vir/common": "^31.14.0",
         "@date-vir/duration": "^7.3.1",
         "ansi-styles": "^6.2.1",
         "terminate": "^2.8.0",
@@ -48,7 +48,7 @@
         "typed-event-target": "^4.0.3"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.12.0",
+        "@augment-vir/test": "^31.14.0",
         "@prisma/client": "^6.6.0",
         "@types/node": "^22.14.1",
         "@web/dev-server-esbuild": "^1.0.4",

package/src/scripts/fix-src-imports.script.ts

@@ -0,0 +1,98 @@
+/* node:coverage disable */
+
+/**
+ * This script is used to replace all `/src/` imports with `/dist/`. This is used for making a
+ * compiled, but not bundled (because that would affect relative file path variables), backend
+ * mono-repo be able to run without `tsx`. (Because `tsx` uses a lot more memory than plain
+ * `node`.)
+ *
+ * To use this script properly, call it after compiling your backend. It should be run from your
+ * mono-repo root. Like this:
+ *
+ * ```json
+ * {
+ *     "scripts": {
+ *         "build:backend": "npm run compile && npx tsx node_modules/@augment-vir/node/src/scripts/fix-src-imports.script.ts"
+ *     }
+ * }
+ * ```
+ */
+
+import {assert, check} from '@augment-vir/assert';
+import {filterMap, log, type JsonCompatibleObject} from '@augment-vir/common';
+import {joinFilesToDir, readJsonFile, runShellCommand, writeJsonFile} from '@augment-vir/node';
+import {readFile, writeFile} from 'node:fs/promises';
+import {join, relative} from 'node:path';
+import {queryNpmWorkspace} from '../augments/npm/query-workspace.js';
+
+const propertiesToReplace = [
+    'main',
+    'module',
+];
+
+async function findFilesThatNeedImportFixes(monoRepoPath: string) {
+    const {stdout} = await runShellCommand(
+        'find . -type d -name "node_modules" -prune -o -type f -path "*/dist/*.js" -exec grep -lE "from \'.*?/src/.*?\';" {} +',
+        {
+            rejectOnError: true,
+            cwd: monoRepoPath,
+        },
+    );
+
+    const files = filterMap(stdout.trim().split('\n'), (line) => line.trim(), check.isTruthy);
+
+    return joinFilesToDir(monoRepoPath, files);
+}
+
+async function updateAllPackageJsonPaths(monoRepoPath: string) {
+    const workspaces = await queryNpmWorkspace(monoRepoPath);
+
+    await Promise.all(
+        workspaces.map(async (workspace) => {
+            const packageJsonPath = join(workspace.path, 'package.json');
+            const packageJson = (await readJsonFile(packageJsonPath)) as unknown;
+
+            assert.isObject(packageJson);
+            let modified = false as boolean;
+
+            propertiesToReplace.forEach((property) => {
+                if (property in packageJson && check.isString(packageJson[property])) {
+                    modified = true;
+                    packageJson[property] = packageJson[property]
+                        .replace('src/', 'dist/')
+                        .replace('.ts', '.js');
+                }
+            });
+
+            if (modified) {
+                await writeJsonFile(packageJsonPath, packageJson as JsonCompatibleObject);
+                log.faint(`Updated ${relative(monoRepoPath, packageJsonPath)}`);
+            }
+        }),
+    );
+}
+
+async function fixAllSrcImports(monoRepoPath: string) {
+    const filePaths = await findFilesThatNeedImportFixes(monoRepoPath);
+
+    await Promise.all(
+        filePaths.map(async (filePath) => {
+            const contents = String(await readFile(filePath));
+            const fixedContents = contents.replaceAll(
+                /(from ["'][^'"]+?)\/src\/([^'"]+)['"];/g,
+                "$1/dist/$2';",
+            );
+            await writeFile(filePath, fixedContents);
+            log.faint(`Fixed imports in ${relative(monoRepoPath, filePath)}`);
+        }),
+    );
+}
+
+async function fixAll(monoRepoPath: string) {
+    await Promise.all([
+        updateAllPackageJsonPaths(monoRepoPath),
+        fixAllSrcImports(monoRepoPath),
+    ]);
+}
+
+await fixAll(process.cwd());

package/src/scripts/fix-ts-bin.script.ts

@@ -1,6 +1,10 @@
 /* node:coverage disable */
 
 /**
+ * This script is used to replace `node_modules/.bin` files so that they run with typescript. This
+ * is used in dev for packages that are dependencies of the listed packages (in `packagesToFix`),
+ * such as `augment-vir` itself.
+ *
  * To use this script properly, call it directly in your postinstall script. Like this:
  *
  * ```json