@dungarees/bin-audit-dependencies-cli-yargs 0.11.4

package/feature.d.ts

@@ -0,0 +1,6 @@
+import type { AuditDependenciesBehavior } from '@dungarees/bin-audit-dependencies-domain/behavior.ts';
+import type { AuditDependenciesEvent } from '@dungarees/bin-audit-dependencies-domain/events.ts';
+import type { CliFeature } from '@dungarees/cli/feature.ts';
+export declare const auditDependenciesFeature: ({ auditDependencies, }: {
+    auditDependencies: AuditDependenciesBehavior;
+}) => CliFeature<AuditDependenciesEvent>;

package/feature.js

@@ -0,0 +1,6 @@
+import { auditDependenciesPresenter } from './presenter.js';
+import { auditDependenciesYargsModule } from './yargs-module.js';
+export const auditDependenciesFeature = ({ auditDependencies, }) => ({
+    commands: [auditDependenciesYargsModule({ auditDependencies })],
+    presenter: auditDependenciesPresenter,
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@dungarees/bin-audit-dependencies-cli-yargs",
+  "engines": {
+    "node": ">=25.0.0"
+  },
+  "scripts": {
+    "type-check": "tsc --noEmit"
+  },
+  "type": "module",
+  "dependencies": {
+    "@dungarees/bin-audit-dependencies-domain": "*",
+    "@dungarees/cli": "*"
+  },
+  "devDependencies": {
+    "@dungarees/bin-fake-app-cli-yargs": "*",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.2"
+  },
+  "author": "info@productkind.com",
+  "license": "MIT",
+  "version": "0.11.4",
+  "exports": {
+    "./feature.ts": {
+      "import": "./feature.js",
+      "types": "./feature.d.ts"
+    },
+    "./presenter.test.ts": {
+      "import": "./presenter.test.js",
+      "types": "./presenter.test.d.ts"
+    },
+    "./presenter.ts": {
+      "import": "./presenter.js",
+      "types": "./presenter.d.ts"
+    },
+    "./yargs-module.test.ts": {
+      "import": "./yargs-module.test.js",
+      "types": "./yargs-module.test.d.ts"
+    },
+    "./yargs-module.ts": {
+      "import": "./yargs-module.js",
+      "types": "./yargs-module.d.ts"
+    }
+  }
+}

package/presenter.d.ts

@@ -0,0 +1,3 @@
+import type { AuditDependenciesEvent } from '@dungarees/bin-audit-dependencies-domain/events.ts';
+import type { Presenter } from '@dungarees/cli/yargs-prompt-app.ts';
+export declare const auditDependenciesPresenter: Presenter<AuditDependenciesEvent>;

package/presenter.js

@@ -0,0 +1,13 @@
+import { exit, stderr, stdout } from '@dungarees/cli/utils.ts';
+const describeFindings = ({ name, missing, unused, }) => [
+    name,
+    ...(missing.length === 0 ? [] : [`  missing: ${missing.join(', ')}`]),
+    ...(unused.length === 0 ? [] : [`  unused: ${unused.join(', ')}`]),
+].join('\n');
+export const auditDependenciesPresenter = {
+    'audit-start': ({ dir }) => stdout(`Auditing dependencies in ${dir}`),
+    'package-findings': (findings) => stderr(describeFindings(findings)),
+    'audit-passed': ({ packageCount }) => stdout(`${packageCount} packages audited, no findings`),
+    // Non-zero so the command can gate a build the way the old script did.
+    'audit-failed': () => exit(1),
+};

package/presenter.test.d.ts

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

package/presenter.test.js

@@ -0,0 +1,44 @@
+import { auditDependenciesPresenter } from './presenter.js';
+import { expect, test } from 'vitest';
+test('audit-start maps to an info stdout message', () => {
+    expect(auditDependenciesPresenter['audit-start']({ dir: '/repo' })).toEqual({
+        type: 'stdout',
+        level: 'info',
+        message: 'Auditing dependencies in /repo',
+    });
+});
+test('package-findings lists both kinds on stderr', () => {
+    expect(auditDependenciesPresenter['package-findings']({
+        name: '@org/a',
+        missing: ['rxjs', 'zod'],
+        unused: ['react'],
+    })).toEqual({
+        type: 'stderr',
+        level: 'error',
+        message: '@org/a\n  missing: rxjs, zod\n  unused: react',
+    });
+});
+test('package-findings omits a kind that is empty', () => {
+    expect(auditDependenciesPresenter['package-findings']({
+        name: '@org/a',
+        missing: ['rxjs'],
+        unused: [],
+    })).toEqual({
+        type: 'stderr',
+        level: 'error',
+        message: '@org/a\n  missing: rxjs',
+    });
+});
+test('audit-passed reports how many packages were checked', () => {
+    expect(auditDependenciesPresenter['audit-passed']({ packageCount: 17 })).toEqual({
+        type: 'stdout',
+        level: 'info',
+        message: '17 packages audited, no findings',
+    });
+});
+test('audit-failed exits non-zero so the audit can gate a build', () => {
+    expect(auditDependenciesPresenter['audit-failed']({ packageCount: 17 })).toEqual({
+        type: 'exit',
+        code: 1,
+    });
+});

package/yargs-module.d.ts

@@ -0,0 +1,6 @@
+import type { AuditDependenciesBehavior } from '@dungarees/bin-audit-dependencies-domain/behavior.ts';
+import type { AuditDependenciesEvent } from '@dungarees/bin-audit-dependencies-domain/events.ts';
+import { type CommandFactory } from '@dungarees/cli/yargs-prompt-app.ts';
+export declare const auditDependenciesYargsModule: ({ auditDependencies, }: {
+    auditDependencies: AuditDependenciesBehavior;
+}) => CommandFactory<AuditDependenciesEvent>;

package/yargs-module.js

@@ -0,0 +1,12 @@
+import { createCommand } from '@dungarees/cli/yargs-prompt-app.ts';
+export const auditDependenciesYargsModule = ({ auditDependencies, }) => (io) => createCommand({
+    command: 'audit-dependencies [lib-path]',
+    describe: "Compare each package's imports against its declared dependencies",
+    builder: (yargs) => yargs.positional('lib-path', {
+        type: 'string',
+        default: '.',
+    }),
+    handler: ({ libPath }) => {
+        io.registerEvents(auditDependencies.auditDependencies({ dir: libPath }).events$);
+    },
+});

package/yargs-module.test.d.ts

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

package/yargs-module.test.js

@@ -0,0 +1,34 @@
+import { createTestApp } from '@dungarees/bin-fake-app-cli-yargs/test-app.ts';
+import { renderCli } from '@dungarees/cli/test-renderer.ts';
+import { expect, test } from 'vitest';
+test('audit-dependencies reports a clean tree and exits 0', async () => {
+    const { app } = createTestApp({
+        files: {
+            '/repo/src/a/package.json': JSON.stringify({
+                name: '@org/a',
+                dependencies: { rxjs: '^7.8.1' },
+            }),
+            '/repo/src/a/index.ts': "import { of } from 'rxjs'\n",
+        },
+    });
+    const { terminal } = renderCli(app, 'dungarees audit-dependencies /repo');
+    expect(await terminal.step()).toEqual([
+        { type: 'stdout', message: 'Auditing dependencies in /repo', level: 'info' },
+        { type: 'stdout', message: '1 packages audited, no findings', level: 'info' },
+        { type: 'exit', code: 0 },
+    ]);
+});
+test('audit-dependencies reports an undeclared import and exits 1', async () => {
+    const { app } = createTestApp({
+        files: {
+            '/repo/src/a/package.json': JSON.stringify({ name: '@org/a' }),
+            '/repo/src/a/index.ts': "import { of } from 'rxjs'\n",
+        },
+    });
+    const { terminal } = renderCli(app, 'dungarees audit-dependencies /repo');
+    expect(await terminal.step()).toEqual([
+        { type: 'stdout', message: 'Auditing dependencies in /repo', level: 'info' },
+        { type: 'stderr', message: '@org/a\n  missing: rxjs', level: 'error' },
+        { type: 'exit', code: 1 },
+    ]);
+});