@sebastienrousseau/jspassgen-cli 0.0.22 → 0.0.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -35
- package/package.json +6 -5
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
<a href="https://github.com/sebastienrousseau/jspassgen-cli/blob/main/DEVELOPMENT.md"><img src="https://img.shields.io/badge/docs-development-blue?style=for-the-badge&labelColor=555555&logo=readthedocs" alt="Docs" height="28" /></a>
|
|
17
17
|
<a href="https://scorecard.dev/viewer/?uri=github.com/sebastienrousseau/jspassgen-cli"><img src="https://img.shields.io/ossf-scorecard/github.com/sebastienrousseau/jspassgen-cli?style=for-the-badge&label=OpenSSF%20Scorecard&logo=openssf" alt="OpenSSF Scorecard" height="28" /></a>
|
|
18
18
|
<a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-Apache--2.0%20OR%20MIT-blue.svg?style=for-the-badge" alt="License: Apache-2.0 OR MIT" height="28" /></a>
|
|
19
|
-
<a href="#requirements"><img src="https://img.shields.io/badge/Node.js-22%2B-93450a.svg?style=for-the-badge&logo=node.js" alt="Node.js 22 or newer" height="28" /></a>
|
|
19
|
+
<a href="#requirements"><img src="https://img.shields.io/badge/Node.js-22.12%2B-93450a.svg?style=for-the-badge&logo=node.js" alt="Node.js 22.12 or newer" height="28" /></a>
|
|
20
20
|
</p>
|
|
21
21
|
|
|
22
22
|
<p align="center">
|
|
@@ -92,11 +92,12 @@ node bin/jspassgen.js --version
|
|
|
92
92
|
|
|
93
93
|
## Requirements
|
|
94
94
|
|
|
95
|
-
- Node.js 22 or newer (`engines` in `package.json`)
|
|
95
|
+
- Node.js 22.12 or newer (`engines` in `package.json`), the floor that
|
|
96
|
+
`commander` 15 declares.
|
|
96
97
|
- CI runs the tests on Node.js 22 and 24 on Ubuntu 24.04. The code is
|
|
97
98
|
plain ESM JavaScript with no native modules.
|
|
98
99
|
- Run-time dependencies: `@sebastienrousseau/jspassgen`, pinned to
|
|
99
|
-
exactly 0.0.
|
|
100
|
+
exactly 0.0.23, the suite version, and `commander`.
|
|
100
101
|
|
|
101
102
|
---
|
|
102
103
|
|
|
@@ -129,20 +130,20 @@ The JavaScript tools depend on the core and add no generation logic of
|
|
|
129
130
|
their own; each SDK is a native port that is checked against the core's
|
|
130
131
|
conformance kit as its generators land.
|
|
131
132
|
|
|
132
|
-
| Component
|
|
133
|
-
|
|
|
134
|
-
| [`jspassgen`](https://github.com/sebastienrousseau/jspassgen)
|
|
135
|
-
| **`jspassgen-cli`**
|
|
136
|
-
| [`jspassgen-mcp`](https://github.com/sebastienrousseau/jspassgen-mcp)
|
|
137
|
-
| [`jspassgen-lsp`](https://github.com/sebastienrousseau/jspassgen-lsp)
|
|
138
|
-
| [`jspassgen-sdk-python`](https://github.com/sebastienrousseau/jspassgen-sdk-python) | Native port on the `secrets` module
|
|
139
|
-
| [`jspassgen-sdk-rust`](https://github.com/sebastienrousseau/jspassgen-sdk-rust)
|
|
140
|
-
| [`jspassgen-sdk-java`](https://github.com/sebastienrousseau/jspassgen-sdk-java)
|
|
141
|
-
| [`jspassgen-sdk-dotnet`](https://github.com/sebastienrousseau/jspassgen-sdk-dotnet) | Native port on `RandomNumberGenerator`
|
|
142
|
-
| [`jspassgen-sdk-cpp`](https://github.com/sebastienrousseau/jspassgen-sdk-cpp)
|
|
143
|
-
| [`jspassgen.github.io`](https://github.com/sebastienrousseau/jspassgen.github.io)
|
|
144
|
-
|
|
145
|
-
Every member ships at 0.0.
|
|
133
|
+
| Component | Purpose | Use case |
|
|
134
|
+
| :---------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------- | :---------------------------------------------- |
|
|
135
|
+
| [`jspassgen`](https://github.com/sebastienrousseau/jspassgen) | Password and passphrase core, Node.js library, CLI, web UI and workers; source of the conformance kit | Programs that generate secrets |
|
|
136
|
+
| **`jspassgen-cli`** | Command-line generator built on the core | Passwords in a terminal or a script |
|
|
137
|
+
| [`jspassgen-mcp`](https://github.com/sebastienrousseau/jspassgen-mcp) | Local stdio MCP server | AI agents that need a generated secret |
|
|
138
|
+
| [`jspassgen-lsp`](https://github.com/sebastienrousseau/jspassgen-lsp) | Language server for weak literal secrets | Editors checking configuration and `.env` files |
|
|
139
|
+
| [`jspassgen-sdk-python`](https://github.com/sebastienrousseau/jspassgen-sdk-python) | Native port on the `secrets` module | Python programs |
|
|
140
|
+
| [`jspassgen-sdk-rust`](https://github.com/sebastienrousseau/jspassgen-sdk-rust) | Native port on the OS CSPRNG | Rust programs |
|
|
141
|
+
| [`jspassgen-sdk-java`](https://github.com/sebastienrousseau/jspassgen-sdk-java) | Native port on `SecureRandom` | JVM programs |
|
|
142
|
+
| [`jspassgen-sdk-dotnet`](https://github.com/sebastienrousseau/jspassgen-sdk-dotnet) | Native port on `RandomNumberGenerator` | .NET programs |
|
|
143
|
+
| [`jspassgen-sdk-cpp`](https://github.com/sebastienrousseau/jspassgen-sdk-cpp) | Native C++17 port on the OS CSPRNG | C++ programs |
|
|
144
|
+
| [`jspassgen.github.io`](https://github.com/sebastienrousseau/jspassgen.github.io) | Source of [jspassgen.com](https://jspassgen.com) | Evaluating the suite |
|
|
145
|
+
|
|
146
|
+
Every member ships at 0.0.23, the suite's second lockstep release: the
|
|
146
147
|
core, CLI, MCP and LSP servers on npm, the Python, Rust, Java and .NET
|
|
147
148
|
SDKs on PyPI, crates.io, Maven Central and NuGet, and the C++ SDK and
|
|
148
149
|
the site as GitHub releases. The table gives each member's purpose, and
|
|
@@ -152,14 +153,14 @@ each README's Capabilities at a glance says what works today.
|
|
|
152
153
|
|
|
153
154
|
## Capabilities at a glance
|
|
154
155
|
|
|
155
|
-
| Area
|
|
156
|
-
|
|
|
157
|
-
| Version
|
|
158
|
-
| Generation
|
|
159
|
-
| Other password types
|
|
160
|
-
| Entropy and strength
|
|
161
|
-
| Presets, clipboard, interactive onboarding | The rest of jspassgen's `src/cli`
|
|
162
|
-
| Distribution
|
|
156
|
+
| Area | Capability | Status |
|
|
157
|
+
| :----------------------------------------- | :------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
|
|
158
|
+
| Version | `--version` | Available |
|
|
159
|
+
| Generation | `generate`: strong password (base64 characters, chunks, separator) | Available |
|
|
160
|
+
| Other password types | base64, memorable, diceware, quantum-resistant, honeyword, pronounceable, custom | Not available yet; in the jspassgen bin today |
|
|
161
|
+
| Entropy and strength | Entropy report, strength analysis | Not available yet |
|
|
162
|
+
| Presets, clipboard, interactive onboarding | The rest of jspassgen's `src/cli` | Not available yet; moves here in a later version |
|
|
163
|
+
| Distribution | npm package, release archives, `SHA256SUMS` | Available from 0.0.22: the npm package, and the GitHub release with the tarball and `SHA256SUMS` |
|
|
163
164
|
|
|
164
165
|
---
|
|
165
166
|
|
|
@@ -170,10 +171,10 @@ where it moves: when it ships, the `jspassgen` bin in the core package
|
|
|
170
171
|
becomes a shim that names this package, and is removed one release later
|
|
171
172
|
(ADR 0001).
|
|
172
173
|
|
|
173
|
-
| Project
|
|
174
|
-
|
|
|
175
|
-
| **jspassgen-cli**
|
|
176
|
-
| `jspassgen` bin in `@sebastienrousseau/jspassgen` |
|
|
174
|
+
| Project | Password types | Published on npm | Generation code |
|
|
175
|
+
| :------------------------------------------------ | :----------------------: | :--------------: | :----------------------: |
|
|
176
|
+
| **jspassgen-cli** | **Strong only, for now** | **Yes (0.0.22)** | **None; calls the core** |
|
|
177
|
+
| `jspassgen` bin in `@sebastienrousseau/jspassgen` | All eight | Yes (0.0.22) | In the same package |
|
|
177
178
|
|
|
178
179
|
---
|
|
179
180
|
|
|
@@ -202,11 +203,11 @@ core's benchmarks live in
|
|
|
202
203
|
|
|
203
204
|
`jspassgen generate` options:
|
|
204
205
|
|
|
205
|
-
| Option
|
|
206
|
-
|
|
|
207
|
-
| `-l, --length <n>`
|
|
208
|
-
| `-i, --iteration <n>`
|
|
209
|
-
| `-s, --separator <text>` | `-`
|
|
206
|
+
| Option | Default | Meaning |
|
|
207
|
+
| :----------------------- | :------ | :------------------------------ |
|
|
208
|
+
| `-l, --length <n>` | 16 | Characters per chunk, 1 to 1024 |
|
|
209
|
+
| `-i, --iteration <n>` | 4 | Number of chunks, at least 1 |
|
|
210
|
+
| `-s, --separator <text>` | `-` | Text between chunks |
|
|
210
211
|
|
|
211
212
|
The CLI reads no configuration file and no environment variable.
|
|
212
213
|
|
|
@@ -296,7 +297,7 @@ command and no API.
|
|
|
296
297
|
their shape (alphabet, chunk count and length, separator) is.
|
|
297
298
|
- The core version is pinned exactly, so a release of this package
|
|
298
299
|
always runs the generator it was tested with.
|
|
299
|
-
- The Node.js floor is 22 (`engines`). It is raised only in a new
|
|
300
|
+
- The Node.js floor is 22.12 (`engines`). It is raised only in a new
|
|
300
301
|
version, recorded in the changelog.
|
|
301
302
|
|
|
302
303
|
---
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sebastienrousseau/jspassgen-cli",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.23",
|
|
4
4
|
"description": "Command-line password generator built on @sebastienrousseau/jspassgen: strong passwords from the platform CSPRNG, made on your machine.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cli",
|
|
@@ -41,16 +41,16 @@
|
|
|
41
41
|
"LICENSE-MIT"
|
|
42
42
|
],
|
|
43
43
|
"engines": {
|
|
44
|
-
"node": ">=22.
|
|
44
|
+
"node": ">=22.12.0"
|
|
45
45
|
},
|
|
46
46
|
"scripts": {
|
|
47
47
|
"lint": "eslint .",
|
|
48
|
-
"format": "prettier --write
|
|
49
|
-
"format:check": "prettier --check
|
|
48
|
+
"format": "prettier --write .",
|
|
49
|
+
"format:check": "prettier --check .",
|
|
50
50
|
"test": "c8 mocha"
|
|
51
51
|
},
|
|
52
52
|
"dependencies": {
|
|
53
|
-
"@sebastienrousseau/jspassgen": "0.0.
|
|
53
|
+
"@sebastienrousseau/jspassgen": "0.0.23",
|
|
54
54
|
"commander": "^15.1.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|
|
@@ -58,6 +58,7 @@
|
|
|
58
58
|
"c8": "^12.0.0",
|
|
59
59
|
"eslint": "^10.15.0",
|
|
60
60
|
"eslint-plugin-sonarjs": "^4.2.2",
|
|
61
|
+
"fast-check": "^4.10.2",
|
|
61
62
|
"globals": "^17.14.0",
|
|
62
63
|
"mocha": "^12.0.3",
|
|
63
64
|
"prettier": "^3.10.1"
|