initial commit

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+
+[*.js]
+indent_style = space
+indent_size = 2
+
+[{package.json,*.yml,*.cjson}]
+indent_style = space
+indent_size = 2

.eslintignore

@@ -0,0 +1,3 @@
+dist
+node_modules
+coverage

.eslintrc

@@ -0,0 +1,5 @@
+{
+  "extends": [
+    "eslint-config-unjs"
+  ]
+}

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - run: corepack enable
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 16
+          cache: "pnpm"
+      - run: pnpm install
+      - run: pnpm lint
+      - run: pnpm build
+      - run: pnpm vitest --coverage
+      - uses: codecov/codecov-action@v3

.gitignore

@@ -0,0 +1,8 @@
+.vscode
+node_modules
+*.log*
+.DS_Store
+coverage
+dist
+types
+.conf*

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Pooya Parsa <[email protected]>
+
+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.

README.md

@@ -0,0 +1,105 @@
+# 🌈 [nypm](https://www.youtube.com/watch?v=QH2-TGUlwu4)
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Github Actions][github-actions-src]][github-actions-href]
+[![Codecov][codecov-src]][codecov-href]
+
+> Unified Package Manager for Node.js
+
+🚧 This project is under development. Please follow [issues](https://github.com/unjs/nypm/issues) for the roadmap. 🚧
+
+## What does **nypm** do?
+
+✅ Supports **npm, yarn and pnpm** out of the box with a unified API
+
+✅ Provides an **API interface** to interact with package managers
+
+✅ **Autodetects** project's package manager using package.json and known lockfiles
+
+✅ **Auto-installs and use exactly expected version** of package manager using [nodejs/corepack](https://github.com/nodejs/corepack)
+
+✅ **Zero dependency** and low overhead implementation
+
+nypm, detects package manager type and version and converts command into package manager CLI arguments. It then uses corepack to execute package manager's command (and download it if necessary).
+
+```
+  +------------------------------------+
+  |                nypm                |
+  +------------------------------------+
+  +------------------------------------+
+  |              Corepack              |
+  +------------------------------------+
+  +---------+  +---------+   +---------+
+  |   npm   |  |  yarn   |   |  pnpm   |
+  +---------+  +---------+   +---------+
+  +------------------------------------+
+  |         Node.js project            |
+  +------------------------------------+
+```
+
+## CLI Usage
+
+[TBA]
+
+## API Usage
+
+Install package:
+
+```sh
+# npm
+npm install nypm
+
+# yarn
+yarn add nypm
+
+# pnpm
+pnpm install nypm
+```
+
+Import:
+
+```js
+// ESM
+import { detectPackageManager, installDependency } from 'nypm'
+
+// CommonJS
+const { detectPackageManager, installDependency } = require('nypm')
+```
+
+## 💻 Development
+
+- Clone this repository
+- Play [Nyan Cat](https://www.youtube.com/watch?v=QH2-TGUlwu4) in the background (really important!)
+- Enable [Corepack](https://github.com/nodejs/corepack) using `corepack enable` (use `npm i -g corepack` for Node.js < 16.10)
+- Install dependencies using `pnpm install`
+- Run interactive tests using `pnpm dev`
+
+## Related Projects
+
+NYPM is inspired from previous attempts and projects for unifying package manager exeperience.
+
+- [pi0/yarnpm](https://github.com/pi0/yarnpm)
+- [unjs/lmify](https://github.com/unjs/lmify)
+- [antfu/ni](https://github.com/antfu/ni)
+- [antfu/install-pkg](https://github.com/antfu/install-pkg)
+- [nodejs/corepack](https://github.com/nodejs/corepack)
+
+## License
+
+Made with 💛
+
+Published under [MIT License](./LICENSE).
+
+<!-- Badges -->
+[npm-version-src]: https://img.shields.io/npm/v/nypm?style=flat-square
+[npm-version-href]: https://npmjs.com/package/nypm
+
+[npm-downloads-src]: https://img.shields.io/npm/dm/nypm?style=flat-square
+[npm-downloads-href]: https://npmjs.com/package/nypm
+
+[github-actions-src]: https://img.shields.io/github/workflow/status/unjs/nypm/ci/main?style=flat-square
+[github-actions-href]: https://github.com/unjs/nypm/actions?query=workflow%3Aci
+
+[codecov-src]: https://img.shields.io/codecov/c/gh/unjs/nypm/main?style=flat-square
+[codecov-href]: https://codecov.io/gh/unjs/nypm

package.json

@@ -0,0 +1,48 @@
+{
+  "name": "nypm",
+  "version": "0.1.0",
+  "description": "Unified Package Manager for Node.js",
+  "repository": "unjs/nypm",
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "unbuild",
+    "dev": "vitest dev",
+    "lint": "eslint --ext .ts,.js,.mjs,.cjs .",
+    "prepack": "unbuild",
+    "release": "pnpm test && standard-version && git push --follow-tags && pnpm publish",
+    "test": "pnpm lint && vitest run --coverage"
+  },
+  "devDependencies": {
+    "@nuxtjs/eslint-config-typescript": "^11.0.0",
+    "@types/node": "^18.11.11",
+    "@vitest/coverage-c8": "^0.25.4",
+    "changelogen": "^0.4.0",
+    "corepack": "^0.15.2",
+    "eslint": "^8.29.0",
+    "eslint-config-unjs": "^0.0.2",
+    "jiti": "^1.16.0",
+    "pathe": "^1.0.0",
+    "typescript": "^4.9.3",
+    "unbuild": "^1.0.1",
+    "vitest": "^0.25.4"
+  },
+  "packageManager": "[email protected]",
+  "engines": {
+    "node": "^14.16.0 || ^16.10.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+  }
+}