@augment-vir/node 31.32.3 → 31.33.1

package/dist/augments/path/contains.d.ts

@@ -0,0 +1,16 @@
+import { type PartialWithUndefined } from '@augment-vir/common';
+/**
+ * Checks to see if a potential child path is inside of a potential parent path.
+ *
+ * @category Path : Node
+ * @category Package : @augment-vir/node
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export declare function doesPathContain(potentialParentPath: string, potentialChildPath: string, options?: PartialWithUndefined<{
+    /**
+     * Set this to `true` to return `true` if the paths are exactly equal.
+     *
+     * @default false
+     */
+    allowSelf: boolean;
+}>): boolean;

package/dist/augments/path/contains.js

@@ -0,0 +1,33 @@
+import { isAbsolute, normalize, relative, resolve, sep } from 'node:path';
+import { isOperatingSystem, OperatingSystem } from '../os/operating-system.js';
+/**
+ * Checks to see if a potential child path is inside of a potential parent path.
+ *
+ * @category Path : Node
+ * @category Package : @augment-vir/node
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export function doesPathContain(potentialParentPath, potentialChildPath, options = {}) {
+    if (!potentialParentPath || !potentialChildPath) {
+        return false;
+    }
+    const parent = normalizePath(potentialParentPath);
+    const child = normalizePath(potentialChildPath);
+    const relativePath = relative(parent, child);
+    if (!relativePath) {
+        /** Paths are identical. */
+        return !!options.allowSelf;
+        /* node:coverage ignore next 4: cannot test Windows specific behavior on all systems. */
+    }
+    else if (isAbsolute(relativePath)) {
+        /** On Windows, paths on different drives yield an absolute relative path. */
+        return false;
+    }
+    /** Contained if it does not traverse up out of parent. */
+    return relativePath !== '..' && !relativePath.startsWith('..' + sep);
+}
+function normalizePath(inputPath) {
+    const absolutePath = normalize(resolve(inputPath));
+    /* node:coverage ignore next 1: cannot test Windows specific behavior on all systems. */
+    return isOperatingSystem(OperatingSystem.Windows) ? absolutePath.toLowerCase() : absolutePath;
+}

package/dist/augments/prisma.js

@@ -149,6 +149,6 @@ export const prisma = {
          *
          * @see {@link PrismaDataDumpOptions}
          */
-        dumpData: dumpData,
+        dumpData,
     },
 };

package/dist/docker/containers/run-container.mock.js

@@ -1,7 +1,7 @@
 import { docker } from '../../augments/docker.js';
 export async function runMockLongLivingContainer(containerName, args = {}) {
     await docker.container.run({
-        containerName: containerName,
+        containerName,
         detach: true,
         imageName: 'alpine:3.20.2',
         dockerFlags: [

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export * from './augments/npm/query-workspace.js';
 export * from './augments/npm/read-package-json.js';
 export * from './augments/os/operating-system.js';
 export * from './augments/path/ancestor.js';
+export * from './augments/path/contains.js';
 export * from './augments/path/os-path.js';
 export * from './augments/path/resolve-import.js';
 export * from './augments/path/root.js';

package/dist/index.js

@@ -11,6 +11,7 @@ export * from './augments/npm/query-workspace.js';
 export * from './augments/npm/read-package-json.js';
 export * from './augments/os/operating-system.js';
 export * from './augments/path/ancestor.js';
+export * from './augments/path/contains.js';
 export * from './augments/path/os-path.js';
 export * from './augments/path/resolve-import.js';
 export * from './augments/path/root.js';

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

@@ -16,23 +16,32 @@
  */
 import { log } from '@augment-vir/common';
 import { interpolationSafeWindowsPath, runShellCommand } from '@augment-vir/node';
-import { rm, writeFile } from 'node:fs/promises';
+import { readFile, rm, writeFile } from 'node:fs/promises';
 import { join, sep } from 'node:path/posix';
 const packagesToFix = [
+    {
+        packageName: 'runstorm',
+        binName: 'runstorm',
+        scriptPath: join('runstorm', 'src', 'cli', 'cli.script.ts'),
+        fixImport: true,
+    },
     {
         packageName: 'mono-vir',
         binName: 'mono-vir',
         scriptPath: join('mono-vir', 'src', 'cli', 'cli.script.ts'),
+        fixImport: true,
     },
     {
         packageName: 'virmator',
         binName: 'virmator',
         scriptPath: join('virmator', 'src', 'cli.script.ts'),
+        fixImport: true,
     },
     {
         packageName: 'prettier',
         binName: 'prettier',
         scriptPath: join('prettier', 'bin', 'prettier.cjs'),
+        fixImport: false,
     },
 ];
 function createBinFileContents({ scriptPath }) {
@@ -47,6 +56,17 @@ async function fixTsBin(packageToFix) {
     await rm(binFilePath, { force: true });
     await writeFile(binFilePath, createBinFileContents(packageToFix));
     await runShellCommand(`chmod +x ${interpolationSafeWindowsPath(binFilePath)}`);
+    await fixPackageJson(packageToFix);
     log.success(`Fixed ${packageToFix.packageName} bin.`);
 }
+async function fixPackageJson(packageToFix) {
+    if (!packageToFix.fixImport) {
+        return;
+    }
+    const packageJsonPath = join(process.cwd(), 'node_modules', packageToFix.packageName, 'package.json');
+    const original = String(await readFile(packageJsonPath));
+    await writeFile(packageJsonPath, original
+        .replace('"main": "dist/index.js"', '"main": "src/index.ts"')
+        .replace('"module": "dist/index.js"', '"module": "src/index.ts"'));
+}
 await Promise.all(packagesToFix.map(async (packageToFix) => await fixTsBin(packageToFix)));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/node",
-    "version": "31.32.3",
+    "version": "31.33.1",
     "description": "A collection of augments, helpers types, functions, and classes only for Node.js (backend) JavaScript environments.",
     "keywords": [
         "augment",
@@ -33,33 +33,32 @@
     "types": "dist/index.d.ts",
     "scripts": {
         "compile": "virmator compile",
-        "test": "virmator --no-deps test node --test-concurrency 1",
-        "test:coverage": "virmator test node coverage --test-concurrency 1",
+        "test": "virmator --no-deps test node --test-concurrency=1",
+        "test:coverage": "virmator test node coverage --test-concurrency=1",
         "test:update": "npm test"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.32.3",
-        "@augment-vir/common": "^31.32.3",
-        "@date-vir/duration": "^7.4.0",
+        "@augment-vir/assert": "^31.33.1",
+        "@augment-vir/common": "^31.33.1",
+        "@date-vir/duration": "^7.4.2",
         "ansi-styles": "^6.2.1",
         "terminate": "^2.8.0",
-        "tsx": "^4.20.3",
+        "tsx": "^4.20.5",
         "type-fest": "^4.41.0",
         "typed-event-target": "^4.1.0"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.32.3",
-        "@prisma/client": "^6.13.0",
-        "@types/node": "^24.2.0",
+        "@augment-vir/test": "^31.33.1",
+        "@prisma/client": "^6.15.0",
+        "@types/node": "^24.3.0",
         "@web/dev-server-esbuild": "^1.0.4",
         "@web/test-runner": "^0.20.2",
         "@web/test-runner-commands": "^0.9.0",
         "@web/test-runner-playwright": "^0.11.1",
         "@web/test-runner-visual-regression": "^0.10.0",
         "c8": "^10.1.3",
-        "concurrently": "^9.2.0",
         "istanbul-smart-text-reporter": "^1.1.5",
-        "prisma": "^6.13.0",
+        "prisma": "^6.15.0",
         "typescript": "^5.9.2"
     },
     "peerDependencies": {

package/src/augments/path/contains.ts

@@ -0,0 +1,51 @@
+import {type PartialWithUndefined} from '@augment-vir/common';
+import {isAbsolute, normalize, relative, resolve, sep} from 'node:path';
+import {isOperatingSystem, OperatingSystem} from '../os/operating-system.js';
+
+/**
+ * Checks to see if a potential child path is inside of a potential parent path.
+ *
+ * @category Path : Node
+ * @category Package : @augment-vir/node
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export function doesPathContain(
+    potentialParentPath: string,
+    potentialChildPath: string,
+    options: PartialWithUndefined<{
+        /**
+         * Set this to `true` to return `true` if the paths are exactly equal.
+         *
+         * @default false
+         */
+        allowSelf: boolean;
+    }> = {},
+): boolean {
+    if (!potentialParentPath || !potentialChildPath) {
+        return false;
+    }
+
+    const parent = normalizePath(potentialParentPath);
+    const child = normalizePath(potentialChildPath);
+
+    const relativePath = relative(parent, child);
+
+    if (!relativePath) {
+        /** Paths are identical. */
+        return !!options.allowSelf;
+        /* node:coverage ignore next 4: cannot test Windows specific behavior on all systems. */
+    } else if (isAbsolute(relativePath)) {
+        /** On Windows, paths on different drives yield an absolute relative path. */
+        return false;
+    }
+
+    /** Contained if it does not traverse up out of parent. */
+    return relativePath !== '..' && !relativePath.startsWith('..' + sep);
+}
+
+function normalizePath(inputPath: string): string {
+    const absolutePath = normalize(resolve(inputPath));
+
+    /* node:coverage ignore next 1: cannot test Windows specific behavior on all systems. */
+    return isOperatingSystem(OperatingSystem.Windows) ? absolutePath.toLowerCase() : absolutePath;
+}

package/src/augments/prisma.ts

@@ -169,6 +169,6 @@ export const prisma = {
          *
          * @see {@link PrismaDataDumpOptions}
          */
-        dumpData: dumpData,
+        dumpData,
     },
 };

package/src/docker/containers/run-container.mock.ts

@@ -6,7 +6,7 @@ export async function runMockLongLivingContainer(
     args: Partial<RunDockerContainerParams> = {},
 ) {
     await docker.container.run({
-        containerName: containerName,
+        containerName,
         detach: true,
         imageName: 'alpine:3.20.2',
         dockerFlags: [

package/src/index.ts

@@ -11,6 +11,7 @@ export * from './augments/npm/query-workspace.js';
 export * from './augments/npm/read-package-json.js';
 export * from './augments/os/operating-system.js';
 export * from './augments/path/ancestor.js';
+export * from './augments/path/contains.js';
 export * from './augments/path/os-path.js';
 export * from './augments/path/resolve-import.js';
 export * from './augments/path/root.js';

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

@@ -18,30 +18,40 @@
 
 import {log} from '@augment-vir/common';
 import {interpolationSafeWindowsPath, runShellCommand} from '@augment-vir/node';
-import {rm, writeFile} from 'node:fs/promises';
+import {readFile, rm, writeFile} from 'node:fs/promises';
 import {join, sep} from 'node:path/posix';
 
 type PackageToFix = {
     packageName: string;
     binName: string;
     scriptPath: string;
+    fixImport: boolean;
 };
 
 const packagesToFix: ReadonlyArray<Readonly<PackageToFix>> = [
+    {
+        packageName: 'runstorm',
+        binName: 'runstorm',
+        scriptPath: join('runstorm', 'src', 'cli', 'cli.script.ts'),
+        fixImport: true,
+    },
     {
         packageName: 'mono-vir',
         binName: 'mono-vir',
         scriptPath: join('mono-vir', 'src', 'cli', 'cli.script.ts'),
+        fixImport: true,
     },
     {
         packageName: 'virmator',
         binName: 'virmator',
         scriptPath: join('virmator', 'src', 'cli.script.ts'),
+        fixImport: true,
     },
     {
         packageName: 'prettier',
         binName: 'prettier',
         scriptPath: join('prettier', 'bin', 'prettier.cjs'),
+        fixImport: false,
     },
 ];
 
@@ -58,7 +68,28 @@ async function fixTsBin(packageToFix: Readonly<PackageToFix>) {
     await rm(binFilePath, {force: true});
     await writeFile(binFilePath, createBinFileContents(packageToFix));
     await runShellCommand(`chmod +x ${interpolationSafeWindowsPath(binFilePath)}`);
+    await fixPackageJson(packageToFix);
     log.success(`Fixed ${packageToFix.packageName} bin.`);
 }
 
+async function fixPackageJson(packageToFix: Readonly<PackageToFix>) {
+    if (!packageToFix.fixImport) {
+        return;
+    }
+
+    const packageJsonPath = join(
+        process.cwd(),
+        'node_modules',
+        packageToFix.packageName,
+        'package.json',
+    );
+    const original = String(await readFile(packageJsonPath));
+    await writeFile(
+        packageJsonPath,
+        original
+            .replace('"main": "dist/index.js"', '"main": "src/index.ts"')
+            .replace('"module": "dist/index.js"', '"module": "src/index.ts"'),
+    );
+}
+
 await Promise.all(packagesToFix.map(async (packageToFix) => await fixTsBin(packageToFix)));