depvitals 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matias Ricardi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,30 @@
-# Temporary Holding Version
+# DepVitals
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> A simple, lightweight dependency health checker for Node.js projects.
+
+DepVitals is currently under development.
+
+It is inspired by [depcheck](https://github.com/depcheck/depcheck) and aims to provide a modern,
+focused alternative for checking project dependencies, without becoming a large all-in-one analysis
+tool.
+
+## Usage
+
+The `v0.0.1` CLI supports:
+
+```bash
+npx depvitals
+npx depvitals --help
+npx depvitals --version
+```
+
+## Current status
+
+DepVitals is in early development.
+
+- `v0.0.1` establishes the package and CLI foundation only.
+- Dependency scanning is not implemented yet and begins in `v0.1.0`.
+
+## License
+
+MIT

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { runCli } from './runCli.js';
+/**
+ * Thin executable adapter for the `v0.0.1` CLI bootstrap.
+ *
+ * Its only responsibilities are:
+ * 1. resolve the package version from the single source of truth (`package.json`);
+ * 2. delegate argument handling to the pure `runCli` function;
+ * 3. render the result to stdout/stderr;
+ * 4. assign `process.exitCode` (never call `process.exit()`).
+ *
+ * The relative path works both from the TypeScript source (`src/cli/index.ts`) and from the built
+ * output (`dist/cli/index.js`), because both resolve to the repository root `package.json`.
+ */
+const version = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+const result = runCli(process.argv.slice(2), version.version);
+if (result.stdout.length > 0) {
+    process.stdout.write(result.stdout);
+}
+if (result.stderr.length > 0) {
+    process.stderr.write(result.stderr);
+}
+process.exitCode = result.exitCode;
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC9C,CAAC;AAEzB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9D,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC"}

package/dist/cli/runCli.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Deterministic, side-effect-free CLI behavior for the `v0.0.1` bootstrap.
+ *
+ * The function never touches `process`: it receives the raw arguments and the package version and
+ * returns a plain result object that the thin adapter renders. This keeps the argument handling
+ * fully testable without mutating global process state.
+ *
+ * Behavior is intentionally strict for `v0.0.1`:
+ * - no arguments            -> early-development message (exit 0)
+ * - exactly `--help`/`-h`   -> help output (exit 0)
+ * - exactly `--version`/`-v`-> version output (exit 0)
+ * - anything else           -> error (exit 1)
+ */
+export type CliResult = {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+};
+/**
+ * Entry point for CLI argument handling.
+ *
+ * @param args - The raw arguments (already stripped of `node` and the script path).
+ * @param version - The package version read from `package.json`.
+ */
+export declare function runCli(args: readonly string[], version: string): CliResult;
+//# sourceMappingURL=runCli.d.ts.map

package/dist/cli/runCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.d.ts","sourceRoot":"","sources":["../../src/cli/runCli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA2EF;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAoB1E"}

package/dist/cli/runCli.js

@@ -0,0 +1,111 @@
+/**
+ * Deterministic, side-effect-free CLI behavior for the `v0.0.1` bootstrap.
+ *
+ * The function never touches `process`: it receives the raw arguments and the package version and
+ * returns a plain result object that the thin adapter renders. This keeps the argument handling
+ * fully testable without mutating global process state.
+ *
+ * Behavior is intentionally strict for `v0.0.1`:
+ * - no arguments            -> early-development message (exit 0)
+ * - exactly `--help`/`-h`   -> help output (exit 0)
+ * - exactly `--version`/`-v`-> version output (exit 0)
+ * - anything else           -> error (exit 1)
+ */
+const EARLY_DEVELOPMENT_MESSAGE = [
+    'DepVitals',
+    '',
+    'A simple, lightweight dependency health checker for Node.js projects.',
+    '',
+    'Early development release.',
+    'Run `depvitals --help` for available commands.',
+].join('\n');
+const HELP_MESSAGE = [
+    'DepVitals',
+    '',
+    'A simple, lightweight dependency health checker for Node.js projects.',
+    '',
+    'Usage:',
+    '  depvitals [options]',
+    '',
+    'Options:',
+    '  -h, --help     Show help',
+    '  -v, --version  Show version',
+].join('\n');
+const PRODUCT_NAME = 'depvitals';
+/**
+ * Render the early-development message shown when no argument is provided.
+ */
+function renderEarlyDevelopment() {
+    return {
+        exitCode: 0,
+        stdout: `${EARLY_DEVELOPMENT_MESSAGE}\n`,
+        stderr: '',
+    };
+}
+/**
+ * Render the help output.
+ */
+function renderHelp() {
+    return {
+        exitCode: 0,
+        stdout: `${HELP_MESSAGE}\n`,
+        stderr: '',
+    };
+}
+/**
+ * Render the package version. The version is passed in so the source of truth stays in
+ * `package.json` and is never duplicated as a hard-coded constant.
+ */
+function renderVersion(version) {
+    return {
+        exitCode: 0,
+        stdout: `${version}\n`,
+        stderr: '',
+    };
+}
+/**
+ * Build the error result for an unsupported argument or combination.
+ */
+function renderUnknownOption(option) {
+    const stderr = [
+        `Unknown option: ${option}`,
+        `Run '${PRODUCT_NAME} --help' for available commands.`,
+    ].join('\n');
+    return {
+        exitCode: 1,
+        stdout: '',
+        stderr: `${stderr}\n`,
+    };
+}
+/**
+ * Entry point for CLI argument handling.
+ *
+ * @param args - The raw arguments (already stripped of `node` and the script path).
+ * @param version - The package version read from `package.json`.
+ */
+export function runCli(args, version) {
+    if (args.length === 0) {
+        return renderEarlyDevelopment();
+    }
+    if (args.length === 1) {
+        switch (args[0]) {
+            case '--help':
+            case '-h':
+                return renderHelp();
+            case '--version':
+            case '-v':
+                return renderVersion(version);
+        }
+    }
+    // Exactly one argument was expected for a flag; anything else (extra tokens, combinations,
+    // positional paths, unknown flags) is unsupported for `v0.0.1`.
+    const firstUnknown = args.find((argument) => !isKnownFlag(argument));
+    return renderUnknownOption(firstUnknown ?? args.join(' '));
+}
+/**
+ * Whether a single argument is one of the flags supported by `v0.0.1`.
+ */
+function isKnownFlag(argument) {
+    return (argument === '--help' || argument === '-h' || argument === '--version' || argument === '-v');
+}
+//# sourceMappingURL=runCli.js.map

package/dist/cli/runCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.js","sourceRoot":"","sources":["../../src/cli/runCli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,MAAM,yBAAyB,GAAG;IAChC,WAAW;IACX,EAAE;IACF,uEAAuE;IACvE,EAAE;IACF,4BAA4B;IAC5B,gDAAgD;CACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,YAAY,GAAG;IACnB,WAAW;IACX,EAAE;IACF,uEAAuE;IACvE,EAAE;IACF,QAAQ;IACR,uBAAuB;IACvB,EAAE;IACF,UAAU;IACV,4BAA4B;IAC5B,+BAA+B;CAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC;;GAEG;AACH,SAAS,sBAAsB;IAC7B,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,GAAG,yBAAyB,IAAI;QACxC,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,GAAG,YAAY,IAAI;QAC3B,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,GAAG,OAAO,IAAI;QACtB,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,MAAM,GAAG;QACb,mBAAmB,MAAM,EAAE;QAC3B,QAAQ,YAAY,kCAAkC;KACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,GAAG,MAAM,IAAI;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAuB,EAAE,OAAe;IAC7D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,sBAAsB,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,OAAO,UAAU,EAAE,CAAC;YACtB,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,2FAA2F;IAC3F,gEAAgE;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,OAAO,mBAAmB,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,CACL,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,IAAI,CAC5F,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Internal bootstrap module.
+ *
+ * DepVitals is CLI-first and deliberately exposes no programmatic entry point yet: `main`,
+ * `types` and `exports` are absent from `package.json`. The public API is defined by the roadmap
+ * release that introduces it, together with the packaging fields that expose it.
+ */
+export declare const packageName = "depvitals";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Internal bootstrap module.
+ *
+ * DepVitals is CLI-first and deliberately exposes no programmatic entry point yet: `main`,
+ * `types` and `exports` are absent from `package.json`. The public API is defined by the roadmap
+ * release that introduces it, together with the packaging fields that expose it.
+ */
+export const packageName = 'depvitals';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "depvitals",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "A simple, lightweight dependency health checker for Node.js projects.",
+  "keywords": [
+    "nodejs",
+    "typescript",
+    "dependencies",
+    "dependency-analysis",
+    "dependency-checker",
+    "dependency-health",
+    "depcheck",
+    "cli"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "packageManager": "pnpm@11.28.3",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MatiasRicardi/depvitals.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MatiasRicardi/depvitals/issues"
+  },
+  "homepage": "https://github.com/MatiasRicardi/depvitals#readme",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "depvitals": "./dist/cli/index.js"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "node -e \"fs.rmSync('dist',{ recursive: true, force: true })\"",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "verify:package": "node scripts/verify-package.mjs",
+    "check": "pnpm run format:check && pnpm run lint && pnpm run typecheck && pnpm run test",
+    "prepack": "pnpm run clean && pnpm run build",
+    "prepublishOnly": "pnpm run check"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@types/node": "22.20.5",
+    "@vitest/coverage-v8": "5.0.3",
+    "eslint": "10.12.0",
+    "eslint-config-prettier": "10.1.8",
+    "globals": "17.13.0",
+    "prettier": "3.9.9",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.71.0",
+    "vitest": "5.0.3"
+  }
+}