@pnpm/pnpr 0.0.0-0 → 0.0.0-26052901

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2016 Rico Sta. Cruz and other contributors
+Copyright (c) 2016-2026 Zoltan Kochan and other contributors
+
+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

@@ -0,0 +1,78 @@
+# @pnpm/pnpr
+
+A pnpm-compatible npm registry server, written in Rust. Speaks the npm
+registry protocol, so any npm-compatible client (pnpm, npm, yarn) can
+talk to it. Proxies packages from a configured upstream like
+npmjs.org and serves them with its own auth and access controls.
+
+Lives in the [pnpm monorepo](https://github.com/pnpm/pnpm) under
+[`pnpr/`](https://github.com/pnpm/pnpm/tree/main/pnpr).
+
+## Install
+
+```sh
+pnpm add -g @pnpm/pnpr
+```
+
+The wrapper resolves to the native binary published under
+`@pnpm/pnpr.<platform>-<arch>` (e.g. `@pnpm/pnpr.linux-x64`). Prebuilt
+binaries are available for `linux-x64`, `linux-arm64`, `darwin-x64`,
+`darwin-arm64`, `win32-x64`, and `win32-arm64`.
+
+## Usage
+
+Start the server with the bundled default config:
+
+```sh
+pnpr
+```
+
+It listens on `127.0.0.1:4873` and proxies `https://registry.npmjs.org/`
+by default. Point a client at it with:
+
+```sh
+pnpm config set registry http://127.0.0.1:4873/
+```
+
+## CLI flags
+
+| Flag | Description |
+| --- | --- |
+| `-c, --config <path>` | Path to a verdaccio-shaped YAML config. When omitted, the bundled default is used. |
+| `--listen <addr>` | Address to bind to. Defaults to `127.0.0.1:4873`. |
+| `--storage <path>` | Override the storage directory from the loaded config. |
+| `--public-url <url>` | URL clients should use to reach the server, used when rewriting `dist.tarball` in served packuments. Defaults to `http://<listen>`. |
+| `--packument-ttl-secs <n>` | Seconds before a cached packument is considered stale and refetched. |
+
+Log level is controlled via the standard `RUST_LOG` environment
+variable (e.g. `RUST_LOG=debug pnpr`).
+
+## Configuration
+
+`pnpr` uses a [verdaccio](https://verdaccio.org/docs/configuration)-shaped
+YAML config. A minimal example:
+
+```yaml
+storage: ./storage
+
+uplinks:
+  npmjs:
+    url: https://registry.npmjs.org/
+
+packages:
+  '@*/*':
+    access: $all
+    publish: $authenticated
+    proxy: npmjs
+
+  '**':
+    access: $all
+    publish: $authenticated
+    proxy: npmjs
+```
+
+Pass it with `-c`:
+
+```sh
+pnpr -c ./pnpr.yaml
+```

package/bin/pnpr

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+const { platform, arch, env } = process;
+
+const PLATFORMS = {
+  win32: {
+    x64: "@pnpm/pnpr.win32-x64/pnpr.exe",
+    arm64: "@pnpm/pnpr.win32-arm64/pnpr.exe",
+  },
+  darwin: {
+    x64: "@pnpm/pnpr.darwin-x64/pnpr",
+    arm64: "@pnpm/pnpr.darwin-arm64/pnpr",
+  },
+  linux: {
+    x64: "@pnpm/pnpr.linux-x64/pnpr",
+    arm64: "@pnpm/pnpr.linux-arm64/pnpr",
+  },
+};
+
+const binPath = PLATFORMS?.[platform]?.[arch];
+if (binPath) {
+  const result = require("child_process").spawnSync(
+    require.resolve(binPath),
+    process.argv.slice(2),
+    {
+      shell: false,
+      stdio: "inherit",
+      env,
+    }
+  );
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  // result.status is null when the child was killed by a signal; falling
+  // through to `exitCode = null` would make the wrapper appear to exit 0
+  // and mask the signal. Re-raise the signal so the parent terminates
+  // the same way; fall back to a non-zero exit if that's not possible.
+  if (typeof result.status === "number") {
+    process.exitCode = result.status;
+  } else if (result.signal) {
+    process.kill(process.pid, result.signal);
+  } else {
+    process.exitCode = 1;
+  }
+} else {
+  console.error(
+    "The @pnpm/pnpr package doesn't ship with prebuilt binaries for your platform yet. " +
+    "You can create an issue at https://github.com/pnpm/pnpm/issues for support."
+  );
+  process.exitCode = 1;
+}

package/package.json

@@ -1,14 +1,35 @@
 {
   "name": "@pnpm/pnpr",
-  "version": "0.0.0-0",
-  "description": "",
-  "main": "index.js",
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "devEngines": {},
-  "type": "module",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "description": "pnpm-compatible npm registry server, written in Rust",
+  "keywords": [
+    "pnpm",
+    "npm",
+    "registry"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/pnpm/pnpm/tree/main/pnpr",
+  "bugs": "https://github.com/pnpm/pnpm/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pnpm/pnpm",
+    "directory": "pnpr/npm/pnpr"
+  },
+  "engines": {
+    "node": ">=18.*"
+  },
+  "files": [
+    "bin/pnpr"
+  ],
+  "version": "0.0.0-26052901",
+  "optionalDependencies": {
+    "@pnpm/pnpr.win32-x64": "0.0.0-26052901",
+    "@pnpm/pnpr.win32-arm64": "0.0.0-26052901",
+    "@pnpm/pnpr.darwin-x64": "0.0.0-26052901",
+    "@pnpm/pnpr.darwin-arm64": "0.0.0-26052901",
+    "@pnpm/pnpr.linux-x64": "0.0.0-26052901",
+    "@pnpm/pnpr.linux-arm64": "0.0.0-26052901"
+  },
+  "bin": {
+    "pnpr": "bin/pnpr"
   }
 }