@augment-vir/node 31.43.3 → 31.45.0

package/README.md

@@ -2,8 +2,6 @@
 
 A collection of augments, helpers types, functions, and classes only for Node.js (backend) JavaScript environments.
 
--   Includes a custom Prisma API built on its CLI: [`prisma`](https://electrovir.github.io/augment-vir/variables/prisma.html).
--   Includes a custom Docker API built on its CLI: [`docker`](https://electrovir.github.io/augment-vir/variables/docker.html).
 -   Includes an easy to use shell script runner: [`runShellCommand`](https://electrovir.github.io/augment-vir/functions/runShellCommand.html).
 -   and much more!
 

package/dist/augments/npm/npm-deps.d.ts

@@ -0,0 +1,38 @@
+/**
+ * All `package.json` keys that are parsed as direct dependencies.
+ *
+ * @category Internal
+ */
+export declare enum PackageJsonDependencyKey {
+    DevDependencies = "devDependencies",
+    Dependencies = "dependencies",
+    PeerDependencies = "peerDependencies"
+}
+/**
+ * A record of package names to package versions included in the direct dependencies. This is the
+ * output from {@link listAllDirectNpmDeps}.
+ *
+ * @category Internal
+ */
+export type NpmDeps = Record<string, NpmDep[]>;
+export type NpmDep = {
+    /** Path to the `package.json` file that depends on this. */
+    requiredBy: string;
+    dependencyKey: PackageJsonDependencyKey;
+    /**
+     * The version as it is directly noted in the `package.json` file. This might not necessarily
+     * correlate to any actually published versions.
+     */
+    versionValue: string;
+    /** If true, this dependency is part of the workspace's own packages. */
+    isWorkspace: boolean;
+};
+/**
+ * Finds all direct deps for the workspace at, or that contains, the given dir path.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws If no directory with a `package-lock.json` file is found.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export declare function listAllDirectNpmDeps(startDirPath: string): Promise<NpmDeps>;

package/dist/augments/npm/npm-deps.js

@@ -0,0 +1,47 @@
+import { check } from '@augment-vir/assert';
+import { filterMap, getEnumValues, getObjectTypedEntries, getOrSet } from '@augment-vir/common';
+import { readJsonFile } from '../fs/json.js';
+import { findAllPackageJsonFilePaths } from './package-json.js';
+/**
+ * All `package.json` keys that are parsed as direct dependencies.
+ *
+ * @category Internal
+ */
+export var PackageJsonDependencyKey;
+(function (PackageJsonDependencyKey) {
+    PackageJsonDependencyKey["DevDependencies"] = "devDependencies";
+    PackageJsonDependencyKey["Dependencies"] = "dependencies";
+    PackageJsonDependencyKey["PeerDependencies"] = "peerDependencies";
+})(PackageJsonDependencyKey || (PackageJsonDependencyKey = {}));
+/**
+ * Finds all direct deps for the workspace at, or that contains, the given dir path.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws If no directory with a `package-lock.json` file is found.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export async function listAllDirectNpmDeps(startDirPath) {
+    const packageJsonFilePaths = await findAllPackageJsonFilePaths(startDirPath);
+    const deps = {};
+    const packageJsonFiles = await Promise.all(packageJsonFilePaths.map(async (packageJsonFilePath) => {
+        return {
+            packageJsonFilePath,
+            packageJson: (await readJsonFile(packageJsonFilePath)),
+        };
+    }));
+    const allWorkspacePackageNames = filterMap(packageJsonFiles, (packageJsonFile) => packageJsonFile.packageJson.name, check.isTruthy);
+    packageJsonFiles.forEach(({ packageJson, packageJsonFilePath }) => {
+        getEnumValues(PackageJsonDependencyKey).forEach((dependencyKey) => {
+            getObjectTypedEntries(packageJson[dependencyKey] || {}).forEach(([dependencyName, versionValue,]) => {
+                getOrSet(deps, dependencyName, () => []).push({
+                    dependencyKey,
+                    requiredBy: packageJsonFilePath,
+                    versionValue,
+                    isWorkspace: allWorkspacePackageNames.includes(dependencyName),
+                });
+            });
+        });
+    });
+    return deps;
+}

package/dist/augments/npm/package-json.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Finds all `package.json` files contained within the workspaces present in the current
+ * `startDirPath`. A workspace root dir is found by recursively looking for a parent
+ * `package-lock.json` file.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws If no directory with a `package-lock.json` file is found.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export declare function findAllPackageJsonFilePaths(startDirPath: string): Promise<string[]>;
+/**
+ * Get all workspace package.json paths starting at the given directory path. The output is string
+ * sorted to keep it stable.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws Error if there is no `package.json` file at the given `rootDirPath`.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export declare function getWorkspacePackageJsonFilePaths(rootDirPath: string): Promise<string[]>;

package/dist/augments/npm/package-json.js

@@ -0,0 +1,48 @@
+import { check } from '@augment-vir/assert';
+import { filterMap, fromAsyncIterable } from '@augment-vir/common';
+import { existsSync } from 'node:fs';
+import { glob, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { findAncestor, joinFilesToDir } from '../path/ancestor.js';
+/**
+ * Finds all `package.json` files contained within the workspaces present in the current
+ * `startDirPath`. A workspace root dir is found by recursively looking for a parent
+ * `package-lock.json` file.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws If no directory with a `package-lock.json` file is found.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export async function findAllPackageJsonFilePaths(startDirPath) {
+    const packageRootDir = findAncestor(startDirPath, (dir) => existsSync(join(dir, 'package-lock.json')));
+    if (!packageRootDir) {
+        throw new Error(`Cannot find all package.json files: failed to find any directory with a package-lock.json file. Started at '${startDirPath}'.`);
+    }
+    const rootPackageJsonPath = join(packageRootDir, 'package.json');
+    return [
+        rootPackageJsonPath,
+        ...(await getWorkspacePackageJsonFilePaths(packageRootDir)),
+    ];
+}
+/**
+ * Get all workspace package.json paths starting at the given directory path. The output is string
+ * sorted to keep it stable.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws Error if there is no `package.json` file at the given `rootDirPath`.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export async function getWorkspacePackageJsonFilePaths(rootDirPath) {
+    const packageJson = JSON.parse(await readFile(join(rootDirPath, 'package.json'), 'utf8'));
+    /* node:coverage ignore next 3: this package only uses one type of workspace */
+    const patterns = check.isArray(packageJson.workspaces)
+        ? packageJson.workspaces
+        : packageJson.workspaces?.packages || [];
+    const matchedPaths = joinFilesToDir(rootDirPath, (await Promise.all(patterns.map(async (pattern) => {
+        return await fromAsyncIterable(glob(pattern, { cwd: rootDirPath }));
+    }))).flat());
+    const workspacePackageJsonPaths = filterMap(matchedPaths, (matchedPath) => join(matchedPath, 'package.json'), (packageJsonPath) => existsSync(packageJsonPath));
+    return workspacePackageJsonPaths.sort();
+}

package/dist/file-paths.mock.d.ts

@@ -10,9 +10,3 @@ export declare const workspaceQueryPackageJsonPath: string;
 export declare const tempWorkspaceQueryFile: string;
 export declare const recursiveFileReadDir: string;
 export declare const invalidPackageDirPath: string;
-export declare const testPrismaSchemaPath: string;
-export declare const testPrismaSchema2Path: string;
-export declare const testInvalidPrismaSchemaPath: string;
-export declare const testSqliteDbPath: string;
-export declare const generatedPrismaClientDirPath: string;
-export declare const testPrismaMigrationsDirPath: string;

package/dist/file-paths.mock.js

@@ -12,9 +12,3 @@ export const workspaceQueryPackageJsonPath = join(workspaceQueryDir, 'package.js
 export const tempWorkspaceQueryFile = join(workspaceQueryDir, 'temp-workspace-query-output.ts');
 export const recursiveFileReadDir = join(testFilesDir, 'recursive-reading');
 export const invalidPackageDirPath = join(testFilesDir, 'invalid-package');
-export const testPrismaSchemaPath = join(testFilesDir, 'schema.prisma');
-export const testPrismaSchema2Path = join(testFilesDir, 'schema2.prisma');
-export const testInvalidPrismaSchemaPath = join(testFilesDir, 'invalid-schema.prisma');
-export const testSqliteDbPath = join(notCommittedDirPath, 'dev.db');
-export const generatedPrismaClientDirPath = join(nodePackageDir, 'node_modules', '.prisma');
-export const testPrismaMigrationsDirPath = join(testFilesDir, 'migrations');

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export * from './augments/docker.js';
 export * from './augments/fs/dir-contents.js';
 export * from './augments/fs/download.js';
 export * from './augments/fs/json.js';
@@ -7,6 +6,8 @@ export * from './augments/fs/read-file.js';
 export * from './augments/fs/symlink.js';
 export * from './augments/fs/write.js';
 export * from './augments/npm/find-bin-path.js';
+export * from './augments/npm/npm-deps.js';
+export * from './augments/npm/package-json.js';
 export * from './augments/npm/query-workspace.js';
 export * from './augments/npm/read-package-json.js';
 export * from './augments/os/operating-system.js';

package/dist/index.js

@@ -1,4 +1,3 @@
-export * from './augments/docker.js';
 export * from './augments/fs/dir-contents.js';
 export * from './augments/fs/download.js';
 export * from './augments/fs/json.js';
@@ -7,6 +6,8 @@ export * from './augments/fs/read-file.js';
 export * from './augments/fs/symlink.js';
 export * from './augments/fs/write.js';
 export * from './augments/npm/find-bin-path.js';
+export * from './augments/npm/npm-deps.js';
+export * from './augments/npm/package-json.js';
 export * from './augments/npm/query-workspace.js';
 export * from './augments/npm/read-package-json.js';
 export * from './augments/os/operating-system.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/node",
-    "version": "31.43.3",
+    "version": "31.45.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.43.3",
-        "@augment-vir/common": "^31.43.3",
+        "@augment-vir/assert": "^31.45.0",
+        "@augment-vir/common": "^31.45.0",
         "@date-vir/duration": "^8.0.0",
         "ansi-styles": "^6.2.3",
         "sanitize-filename": "^1.6.3",
@@ -49,8 +49,7 @@
         "typed-event-target": "^4.1.0"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.43.3",
-        "@prisma/client": "^6.17.1",
+        "@augment-vir/test": "^31.45.0",
         "@types/node": "^24.9.1",
         "@web/dev-server-esbuild": "^1.0.4",
         "@web/test-runner": "^0.20.2",
@@ -59,7 +58,6 @@
         "@web/test-runner-visual-regression": "^0.10.0",
         "c8": "^10.1.3",
         "istanbul-smart-text-reporter": "^1.1.5",
-        "prisma": "^6.17.1",
         "typescript": "^5.9.3"
     },
     "peerDependencies": {

package/src/augments/npm/npm-deps.ts

@@ -0,0 +1,85 @@
+import {check} from '@augment-vir/assert';
+import {filterMap, getEnumValues, getObjectTypedEntries, getOrSet} from '@augment-vir/common';
+import {type PackageJson} from 'type-fest';
+import {readJsonFile} from '../fs/json.js';
+import {findAllPackageJsonFilePaths} from './package-json.js';
+
+/**
+ * All `package.json` keys that are parsed as direct dependencies.
+ *
+ * @category Internal
+ */
+export enum PackageJsonDependencyKey {
+    DevDependencies = 'devDependencies',
+    Dependencies = 'dependencies',
+    PeerDependencies = 'peerDependencies',
+}
+
+/**
+ * A record of package names to package versions included in the direct dependencies. This is the
+ * output from {@link listAllDirectNpmDeps}.
+ *
+ * @category Internal
+ */
+export type NpmDeps = Record<string, NpmDep[]>;
+export type NpmDep = {
+    /** Path to the `package.json` file that depends on this. */
+    requiredBy: string;
+    dependencyKey: PackageJsonDependencyKey;
+    /**
+     * The version as it is directly noted in the `package.json` file. This might not necessarily
+     * correlate to any actually published versions.
+     */
+    versionValue: string;
+    /** If true, this dependency is part of the workspace's own packages. */
+    isWorkspace: boolean;
+};
+
+/**
+ * Finds all direct deps for the workspace at, or that contains, the given dir path.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws If no directory with a `package-lock.json` file is found.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export async function listAllDirectNpmDeps(startDirPath: string): Promise<NpmDeps> {
+    const packageJsonFilePaths = await findAllPackageJsonFilePaths(startDirPath);
+
+    const deps: NpmDeps = {};
+
+    const packageJsonFiles = await Promise.all(
+        packageJsonFilePaths.map(async (packageJsonFilePath) => {
+            return {
+                packageJsonFilePath,
+                packageJson: (await readJsonFile(packageJsonFilePath)) as PackageJson,
+            };
+        }),
+    );
+
+    const allWorkspacePackageNames = filterMap(
+        packageJsonFiles,
+        (packageJsonFile) => packageJsonFile.packageJson.name,
+        check.isTruthy,
+    );
+
+    packageJsonFiles.forEach(({packageJson, packageJsonFilePath}) => {
+        getEnumValues(PackageJsonDependencyKey).forEach((dependencyKey) => {
+            getObjectTypedEntries(packageJson[dependencyKey] || {}).forEach(
+                ([
+                    dependencyName,
+                    versionValue,
+                ]) => {
+                    getOrSet(deps, dependencyName, () => []).push({
+                        dependencyKey,
+                        requiredBy: packageJsonFilePath,
+                        versionValue,
+                        isWorkspace: allWorkspacePackageNames.includes(dependencyName),
+                    });
+                },
+            );
+        });
+    });
+
+    return deps;
+}

package/src/augments/npm/package-json.ts

@@ -0,0 +1,75 @@
+import {check} from '@augment-vir/assert';
+import {filterMap, fromAsyncIterable} from '@augment-vir/common';
+import {existsSync} from 'node:fs';
+import {glob, readFile} from 'node:fs/promises';
+import {join} from 'node:path';
+import {type PackageJson} from 'type-fest';
+import {findAncestor, joinFilesToDir} from '../path/ancestor.js';
+
+/**
+ * Finds all `package.json` files contained within the workspaces present in the current
+ * `startDirPath`. A workspace root dir is found by recursively looking for a parent
+ * `package-lock.json` file.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws If no directory with a `package-lock.json` file is found.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export async function findAllPackageJsonFilePaths(startDirPath: string) {
+    const packageRootDir = findAncestor(startDirPath, (dir) =>
+        existsSync(join(dir, 'package-lock.json')),
+    );
+
+    if (!packageRootDir) {
+        throw new Error(
+            `Cannot find all package.json files: failed to find any directory with a package-lock.json file. Started at '${startDirPath}'.`,
+        );
+    }
+
+    const rootPackageJsonPath = join(packageRootDir, 'package.json');
+
+    return [
+        rootPackageJsonPath,
+        ...(await getWorkspacePackageJsonFilePaths(packageRootDir)),
+    ];
+}
+
+/**
+ * Get all workspace package.json paths starting at the given directory path. The output is string
+ * sorted to keep it stable.
+ *
+ * @category Node : Npm
+ * @category Package : @augment-vir/node
+ * @throws Error if there is no `package.json` file at the given `rootDirPath`.
+ * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
+ */
+export async function getWorkspacePackageJsonFilePaths(rootDirPath: string): Promise<string[]> {
+    const packageJson: PackageJson = JSON.parse(
+        await readFile(join(rootDirPath, 'package.json'), 'utf8'),
+    );
+
+    /* node:coverage ignore next 3: this package only uses one type of workspace */
+    const patterns = check.isArray(packageJson.workspaces)
+        ? packageJson.workspaces
+        : packageJson.workspaces?.packages || [];
+
+    const matchedPaths: string[] = joinFilesToDir(
+        rootDirPath,
+        (
+            await Promise.all(
+                patterns.map(async (pattern) => {
+                    return await fromAsyncIterable(glob(pattern, {cwd: rootDirPath}));
+                }),
+            )
+        ).flat(),
+    );
+
+    const workspacePackageJsonPaths = filterMap(
+        matchedPaths,
+        (matchedPath) => join(matchedPath, 'package.json'),
+        (packageJsonPath) => existsSync(packageJsonPath),
+    );
+
+    return workspacePackageJsonPaths.sort();
+}

package/src/file-paths.mock.ts

@@ -20,10 +20,3 @@ export const tempWorkspaceQueryFile = join(workspaceQueryDir, 'temp-workspace-qu
 export const recursiveFileReadDir = join(testFilesDir, 'recursive-reading');
 
 export const invalidPackageDirPath = join(testFilesDir, 'invalid-package');
-
-export const testPrismaSchemaPath = join(testFilesDir, 'schema.prisma');
-export const testPrismaSchema2Path = join(testFilesDir, 'schema2.prisma');
-export const testInvalidPrismaSchemaPath = join(testFilesDir, 'invalid-schema.prisma');
-export const testSqliteDbPath = join(notCommittedDirPath, 'dev.db');
-export const generatedPrismaClientDirPath = join(nodePackageDir, 'node_modules', '.prisma');
-export const testPrismaMigrationsDirPath = join(testFilesDir, 'migrations');

package/src/index.ts

@@ -1,4 +1,3 @@
-export * from './augments/docker.js';
 export * from './augments/fs/dir-contents.js';
 export * from './augments/fs/download.js';
 export * from './augments/fs/json.js';
@@ -7,6 +6,8 @@ export * from './augments/fs/read-file.js';
 export * from './augments/fs/symlink.js';
 export * from './augments/fs/write.js';
 export * from './augments/npm/find-bin-path.js';
+export * from './augments/npm/npm-deps.js';
+export * from './augments/npm/package-json.js';
 export * from './augments/npm/query-workspace.js';
 export * from './augments/npm/read-package-json.js';
 export * from './augments/os/operating-system.js';

package/dist/augments/docker.d.ts

@@ -1,92 +0,0 @@
-import { getContainerInfo } from '../docker/containers/container-info.js';
-import { getContainerLogs, getContainerStatus, waitUntilContainerExited, waitUntilContainerRemoved, waitUntilContainerRunning } from '../docker/containers/container-status.js';
-import { copyToContainer } from '../docker/containers/copy-to-container.js';
-import { makeEnvFlags, makePortMapFlags, makeVolumeFlags } from '../docker/containers/docker-command-inputs.js';
-import { killContainer } from '../docker/containers/kill-container.js';
-import { runContainerCommand } from '../docker/containers/run-command.js';
-import { runContainer } from '../docker/containers/run-container.js';
-import { tryOrKillContainer } from '../docker/containers/try-or-kill-container.js';
-import { isImageInLocalRegistry, removeImageFromLocalRegistry, updateImage } from '../docker/docker-image.js';
-import { isDockerRunning, startDocker } from '../docker/docker-startup.js';
-export { type DockerContainerInfo, type DockerContainerInfoState, } from '../docker/containers/container-info.js';
-export { DockerContainerStatus, exitedDockerContainerStatuses, } from '../docker/containers/container-status.js';
-export { type CopyToDockerContainerParams } from '../docker/containers/copy-to-container.js';
-export { type DockerEnvMap, type DockerPortMap, type DockerVolumeMap, type DockerVolumeMappingType, } from '../docker/containers/docker-command-inputs.js';
-export { type RunDockerContainerCommandParams } from '../docker/containers/run-command.js';
-export { type RunDockerContainerParams } from '../docker/containers/run-container.js';
-/**
- * Centralized Docker API.
- *
- * @deprecated Use the [docker-vir](https://www.npmjs.com/package/docker-vir) package instead.
- * @category Node : Docker
- * @category Package : @augment-vir/node
- * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
- */
-export declare const docker: {
-    /** Detects if the Docker service is running. */
-    isRunning: typeof isDockerRunning;
-    /**
-     * Tries to start Docker based ont he current operating system's supported commands. The success
-     * of this operation is heavily dependent on how you have Docker setup on your system.
-     */
-    start: typeof startDocker;
-    image: {
-        /** Downloads an image if it is missing from the local registry. */
-        update: typeof updateImage;
-        /** Removes an image from the local registry. */
-        remove: typeof removeImageFromLocalRegistry;
-        /** Detects if an image exists in the local registry. */
-        exists: typeof isImageInLocalRegistry;
-    };
-    container: {
-        /**
-         * Get the current status of a container. If the container does not exist at all, the status
-         * will be {@link DockerContainerStatus.Removed}.
-         */
-        getStatus: typeof getContainerStatus;
-        /** Wait until a container is running and responsive. */
-        waitUntilRunning: typeof waitUntilContainerRunning;
-        /**
-         * Wait until a container has a status that can be classified as "exited".
-         *
-         * @see {@link exitedDockerContainerStatuses}
-         */
-        waitUntilExited: typeof waitUntilContainerExited;
-        /** Wait until a container is completely removed. */
-        waitUntilRemoved: typeof waitUntilContainerRemoved;
-        /**
-         * Runs a callback (which presumably will run a command within the given `containerName`)
-         * and kills the container if the callback fails.
-         */
-        tryOrKill: typeof tryOrKillContainer;
-        /** Run a container that isn't already running. */
-        run: typeof runContainer;
-        /** Kill a container. */
-        kill: typeof killContainer;
-        /** Copy a file or directory to a container. */
-        copyTo: typeof copyToContainer;
-        /** Run a command on a container that is already running. */
-        runCommand: typeof runContainerCommand;
-        /** Run `docker inspect` on a container and return its output. */
-        getInfo: typeof getContainerInfo;
-        /** Get a container's logs. */
-        getLogs: typeof getContainerLogs;
-    };
-    util: {
-        /**
-         * Manually create a string of volume mapping flags. This is automatically done already
-         * inside the run container methods.
-         */
-        makeVolumeFlags: typeof makeVolumeFlags;
-        /**
-         * Manually create a string of port mapping flags. This is automatically done already inside
-         * the run container methods.
-         */
-        makePortMapFlags: typeof makePortMapFlags;
-        /**
-         * Manually create a string of env mapping flags. This is automatically done already inside
-         * the run container methods.
-         */
-        makeEnvFlags: typeof makeEnvFlags;
-    };
-};

package/dist/augments/docker.js

@@ -1,87 +0,0 @@
-import { getContainerInfo } from '../docker/containers/container-info.js';
-import { getContainerLogs, getContainerStatus, waitUntilContainerExited, waitUntilContainerRemoved, waitUntilContainerRunning, } from '../docker/containers/container-status.js';
-import { copyToContainer } from '../docker/containers/copy-to-container.js';
-import { makeEnvFlags, makePortMapFlags, makeVolumeFlags, } from '../docker/containers/docker-command-inputs.js';
-import { killContainer } from '../docker/containers/kill-container.js';
-import { runContainerCommand } from '../docker/containers/run-command.js';
-import { runContainer } from '../docker/containers/run-container.js';
-import { tryOrKillContainer } from '../docker/containers/try-or-kill-container.js';
-import { isImageInLocalRegistry, removeImageFromLocalRegistry, updateImage, } from '../docker/docker-image.js';
-import { isDockerRunning, startDocker } from '../docker/docker-startup.js';
-export { DockerContainerStatus, exitedDockerContainerStatuses, } from '../docker/containers/container-status.js';
-/**
- * Centralized Docker API.
- *
- * @deprecated Use the [docker-vir](https://www.npmjs.com/package/docker-vir) package instead.
- * @category Node : Docker
- * @category Package : @augment-vir/node
- * @package [`@augment-vir/node`](https://www.npmjs.com/package/@augment-vir/node)
- */
-export const docker = {
-    /** Detects if the Docker service is running. */
-    isRunning: isDockerRunning,
-    /**
-     * Tries to start Docker based ont he current operating system's supported commands. The success
-     * of this operation is heavily dependent on how you have Docker setup on your system.
-     */
-    start: startDocker,
-    image: {
-        /** Downloads an image if it is missing from the local registry. */
-        update: updateImage,
-        /** Removes an image from the local registry. */
-        remove: removeImageFromLocalRegistry,
-        /** Detects if an image exists in the local registry. */
-        exists: isImageInLocalRegistry,
-    },
-    container: {
-        /**
-         * Get the current status of a container. If the container does not exist at all, the status
-         * will be {@link DockerContainerStatus.Removed}.
-         */
-        getStatus: getContainerStatus,
-        /** Wait until a container is running and responsive. */
-        waitUntilRunning: waitUntilContainerRunning,
-        /**
-         * Wait until a container has a status that can be classified as "exited".
-         *
-         * @see {@link exitedDockerContainerStatuses}
-         */
-        waitUntilExited: waitUntilContainerExited,
-        /** Wait until a container is completely removed. */
-        waitUntilRemoved: waitUntilContainerRemoved,
-        /**
-         * Runs a callback (which presumably will run a command within the given `containerName`)
-         * and kills the container if the callback fails.
-         */
-        tryOrKill: tryOrKillContainer,
-        /** Run a container that isn't already running. */
-        run: runContainer,
-        /** Kill a container. */
-        kill: killContainer,
-        /** Copy a file or directory to a container. */
-        copyTo: copyToContainer,
-        /** Run a command on a container that is already running. */
-        runCommand: runContainerCommand,
-        /** Run `docker inspect` on a container and return its output. */
-        getInfo: getContainerInfo,
-        /** Get a container's logs. */
-        getLogs: getContainerLogs,
-    },
-    util: {
-        /**
-         * Manually create a string of volume mapping flags. This is automatically done already
-         * inside the run container methods.
-         */
-        makeVolumeFlags,
-        /**
-         * Manually create a string of port mapping flags. This is automatically done already inside
-         * the run container methods.
-         */
-        makePortMapFlags,
-        /**
-         * Manually create a string of env mapping flags. This is automatically done already inside
-         * the run container methods.
-         */
-        makeEnvFlags,
-    },
-};