@futdevpro/nts-dynamo 1.15.145 → 1.15.150
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/.dynamo/logs/cicd-pipeline/output.log +1665 -1803
- package/.dynamo/logs/cicd-pipeline/status.json +33 -33
- package/README.md +16 -0
- package/__documentations/2026-08-21-distributed-rate-limit-bfr-ctm-010.md +59 -0
- package/build/_collections/npm-token-check.util.d.ts +139 -0
- package/build/_collections/npm-token-check.util.d.ts.map +1 -0
- package/build/_collections/npm-token-check.util.js +302 -0
- package/build/_collections/npm-token-check.util.js.map +1 -0
- package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.d.ts +6 -0
- package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.d.ts.map +1 -0
- package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.js +10 -0
- package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.js.map +1 -0
- package/build/_modules/rate-limit/_models/rate-limit-config.interface.d.ts +15 -6
- package/build/_modules/rate-limit/_models/rate-limit-config.interface.d.ts.map +1 -1
- package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.d.ts +9 -0
- package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.d.ts.map +1 -0
- package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.js +3 -0
- package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.js.map +1 -0
- package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.d.ts +7 -0
- package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.d.ts.map +1 -0
- package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.js +3 -0
- package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.js.map +1 -0
- package/build/_modules/rate-limit/_models/rate-limit-store.interface.d.ts +9 -0
- package/build/_modules/rate-limit/_models/rate-limit-store.interface.d.ts.map +1 -0
- package/build/_modules/rate-limit/_models/rate-limit-store.interface.js +3 -0
- package/build/_modules/rate-limit/_models/rate-limit-store.interface.js.map +1 -0
- package/build/_modules/rate-limit/index.d.ts +5 -0
- package/build/_modules/rate-limit/index.d.ts.map +1 -1
- package/build/_modules/rate-limit/index.js +5 -1
- package/build/_modules/rate-limit/index.js.map +1 -1
- package/build/_modules/rate-limit/rate-limit-in-memory.store.d.ts +19 -0
- package/build/_modules/rate-limit/rate-limit-in-memory.store.d.ts.map +1 -0
- package/build/_modules/rate-limit/rate-limit-in-memory.store.js +71 -0
- package/build/_modules/rate-limit/rate-limit-in-memory.store.js.map +1 -0
- package/build/_modules/rate-limit/rate-limit.middleware.d.ts +39 -103
- package/build/_modules/rate-limit/rate-limit.middleware.d.ts.map +1 -1
- package/build/_modules/rate-limit/rate-limit.middleware.js +325 -236
- package/build/_modules/rate-limit/rate-limit.middleware.js.map +1 -1
- package/build/index.d.ts +1 -0
- package/build/index.d.ts.map +1 -1
- package/build/index.js +1 -0
- package/build/index.js.map +1 -1
- package/package.json +1 -1
- package/src/_collections/npm-token-check.util.spec.ts +218 -0
- package/src/_collections/npm-token-check.util.ts +327 -0
- package/src/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.ts +5 -0
- package/src/_modules/rate-limit/_models/rate-limit-config.interface.ts +19 -6
- package/src/_modules/rate-limit/_models/rate-limit-consume-request.interface.ts +9 -0
- package/src/_modules/rate-limit/_models/rate-limit-consume-result.interface.ts +6 -0
- package/src/_modules/rate-limit/_models/rate-limit-store.interface.ts +9 -0
- package/src/_modules/rate-limit/index.ts +5 -0
- package/src/_modules/rate-limit/rate-limit-in-memory.store.ts +91 -0
- package/src/_modules/rate-limit/rate-limit.middleware.spec.ts +424 -200
- package/src/_modules/rate-limit/rate-limit.middleware.ts +436 -275
- package/src/index.ts +1 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
|
-
"pid":
|
|
3
|
-
"startedAt": "2026-08-
|
|
4
|
-
"startedAtMs":
|
|
2
|
+
"pid": 500,
|
|
3
|
+
"startedAt": "2026-08-22T06:13:21.680Z",
|
|
4
|
+
"startedAtMs": 1787379201680,
|
|
5
5
|
"phase": "npm-publish",
|
|
6
6
|
"pipelineComplete": false,
|
|
7
7
|
"serverRunning": false,
|
|
@@ -10,63 +10,63 @@
|
|
|
10
10
|
"steps": {
|
|
11
11
|
"validate-secrets": {
|
|
12
12
|
"status": "ok",
|
|
13
|
-
"startedAt": "2026-08-
|
|
13
|
+
"startedAt": "2026-08-22T06:13:21.694Z",
|
|
14
14
|
"logLineStart": 2,
|
|
15
15
|
"logLineEnd": 8,
|
|
16
|
-
"durationSec":
|
|
16
|
+
"durationSec": 2.2
|
|
17
17
|
},
|
|
18
18
|
"discord-start": {
|
|
19
19
|
"status": "ok",
|
|
20
|
-
"startedAt": "2026-08-
|
|
20
|
+
"startedAt": "2026-08-22T06:13:24.944Z",
|
|
21
21
|
"logLineStart": 9,
|
|
22
|
-
"logLineEnd":
|
|
23
|
-
"durationSec": 5
|
|
22
|
+
"logLineEnd": 16,
|
|
23
|
+
"durationSec": 5
|
|
24
24
|
},
|
|
25
25
|
"pre-flight": {
|
|
26
26
|
"status": "ok",
|
|
27
|
-
"startedAt": "2026-08-
|
|
28
|
-
"logLineStart":
|
|
29
|
-
"logLineEnd":
|
|
30
|
-
"durationSec": 2.
|
|
27
|
+
"startedAt": "2026-08-22T06:13:30.925Z",
|
|
28
|
+
"logLineStart": 17,
|
|
29
|
+
"logLineEnd": 19,
|
|
30
|
+
"durationSec": 2.2
|
|
31
31
|
},
|
|
32
32
|
"install": {
|
|
33
33
|
"status": "ok",
|
|
34
|
-
"startedAt": "2026-08-
|
|
35
|
-
"logLineStart":
|
|
36
|
-
"logLineEnd":
|
|
37
|
-
"durationSec":
|
|
34
|
+
"startedAt": "2026-08-22T06:13:34.138Z",
|
|
35
|
+
"logLineStart": 20,
|
|
36
|
+
"logLineEnd": 109,
|
|
37
|
+
"durationSec": 32.2
|
|
38
38
|
},
|
|
39
39
|
"check-dev-leftovers": {
|
|
40
40
|
"status": "ok",
|
|
41
|
-
"startedAt": "2026-08-
|
|
42
|
-
"logLineStart":
|
|
43
|
-
"logLineEnd":
|
|
44
|
-
"durationSec":
|
|
41
|
+
"startedAt": "2026-08-22T06:14:07.438Z",
|
|
42
|
+
"logLineStart": 110,
|
|
43
|
+
"logLineEnd": 119,
|
|
44
|
+
"durationSec": 6
|
|
45
45
|
},
|
|
46
46
|
"build": {
|
|
47
47
|
"status": "ok",
|
|
48
|
-
"startedAt": "2026-08-
|
|
49
|
-
"logLineStart":
|
|
50
|
-
"logLineEnd":
|
|
51
|
-
"durationSec":
|
|
48
|
+
"startedAt": "2026-08-22T06:14:14.477Z",
|
|
49
|
+
"logLineStart": 120,
|
|
50
|
+
"logLineEnd": 121,
|
|
51
|
+
"durationSec": 32.4
|
|
52
52
|
},
|
|
53
53
|
"test": {
|
|
54
54
|
"status": "ok",
|
|
55
|
-
"startedAt": "2026-08-
|
|
56
|
-
"logLineStart":
|
|
57
|
-
"logLineEnd":
|
|
58
|
-
"durationSec":
|
|
55
|
+
"startedAt": "2026-08-22T06:14:47.932Z",
|
|
56
|
+
"logLineStart": 122,
|
|
57
|
+
"logLineEnd": 2890,
|
|
58
|
+
"durationSec": 30.4,
|
|
59
59
|
"testSummary": {
|
|
60
|
-
"totalSpecs":
|
|
60
|
+
"totalSpecs": 1728,
|
|
61
61
|
"failures": 0,
|
|
62
|
-
"passed":
|
|
63
|
-
"testDurationSec":
|
|
62
|
+
"passed": 1728,
|
|
63
|
+
"testDurationSec": 6.823
|
|
64
64
|
}
|
|
65
65
|
},
|
|
66
66
|
"npm-publish": {
|
|
67
67
|
"status": "running",
|
|
68
|
-
"startedAt": "2026-08-
|
|
69
|
-
"logLineStart":
|
|
68
|
+
"startedAt": "2026-08-22T06:15:19.700Z",
|
|
69
|
+
"logLineStart": 2891,
|
|
70
70
|
"logLineEnd": null,
|
|
71
71
|
"durationSec": null
|
|
72
72
|
}
|
package/README.md
CHANGED
|
@@ -313,6 +313,22 @@ Persistence remains application-owned through explicit atomic adapters. Transpor
|
|
|
313
313
|
credentials in URLs, logs, analytics or durable client storage. A consuming application must also apply its
|
|
314
314
|
rate-limit, authorization, cookie/storage and audit-redaction policy at the API boundary.
|
|
315
315
|
|
|
316
|
+
### Distributed rate limiting
|
|
317
|
+
|
|
318
|
+
The `@futdevpro/nts-dynamo/rate-limit` entry point provides an atomic rate-limit boundary for HTTP services:
|
|
319
|
+
|
|
320
|
+
- an exact sliding-window in-memory store for deterministic tests and explicitly single-instance development;
|
|
321
|
+
- an application-owned shared-store contract for production deployments;
|
|
322
|
+
- a production configuration gate that requires both shared persistence and explicit opaque subject/endpoint
|
|
323
|
+
extractors;
|
|
324
|
+
- validated positive limits, windows and weighted request costs with stable, content-free failures;
|
|
325
|
+
- trusted `req.ip` as the safe local default instead of reading caller-controlled forwarding headers directly;
|
|
326
|
+
- explicit opportunistic local cleanup with no timer, polling loop or hidden background task.
|
|
327
|
+
|
|
328
|
+
Production consumers must implement the shared store with one atomic permit decision across every application
|
|
329
|
+
instance. They must derive non-sensitive, purpose-scoped bucket identifiers and must not persist or log raw IP
|
|
330
|
+
addresses, credentials, email addresses or other request content as rate-limit keys.
|
|
331
|
+
|
|
316
332
|
### Privacy lifecycle
|
|
317
333
|
|
|
318
334
|
The optional `@futdevpro/nts-dynamo/privacy-lifecycle` entry point provides the shared machinery for standalone
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Dynamo NTS distributed rate-limit boundary
|
|
2
|
+
|
|
3
|
+
**Contract:** `dynts-rate-limit/2`
|
|
4
|
+
|
|
5
|
+
**Release candidate:** `@futdevpro/nts-dynamo@1.15.147`
|
|
6
|
+
|
|
7
|
+
**Consumer trace:** `BFR-CTM-010`
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
|
|
11
|
+
This Bedrock boundary makes one rate-limit decision atomic across application processes while keeping persistence
|
|
12
|
+
application-owned. It replaces the former process-local-only middleware behavior without adding a replaceable
|
|
13
|
+
framework abstraction: consumers use the published `@futdevpro/nts-dynamo/rate-limit` types and middleware
|
|
14
|
+
directly and provide the storage adapter required by their deployment.
|
|
15
|
+
|
|
16
|
+
## Contract
|
|
17
|
+
|
|
18
|
+
`DyNTS_RateLimit_Store_Interface.consume(...)` receives one opaque bucket key, the active limit and window, the
|
|
19
|
+
positive request cost and a caller-supplied millisecond timestamp. It resolves one committed decision containing
|
|
20
|
+
`allowed`, `remaining` and `resetAt`. A production host enables `requireSharedStore` and supplies:
|
|
21
|
+
|
|
22
|
+
- a store advertising `storeKind: shared`;
|
|
23
|
+
- an explicit opaque subject extractor;
|
|
24
|
+
- an explicit stable endpoint-group extractor.
|
|
25
|
+
|
|
26
|
+
Configuration fails closed when any of these requirements is absent. Runtime store exceptions and malformed
|
|
27
|
+
store results become stable 503 errors without reflecting the bucket, the adapter exception or request content.
|
|
28
|
+
Policy rejection remains a stable 429 and includes the committed reset interval in response headers.
|
|
29
|
+
|
|
30
|
+
## Security and privacy properties
|
|
31
|
+
|
|
32
|
+
- The middleware never reads `x-forwarded-for` directly. Its local default uses Express `req.ip`, whose proxy
|
|
33
|
+
trust policy belongs to the host; production still requires an explicit extractor.
|
|
34
|
+
- Extractor exceptions, invalid callbacks, invalid clocks and malformed bucket components are converted to
|
|
35
|
+
content-free errors.
|
|
36
|
+
- Limits, windows, costs, timestamps, bucket component lengths and store results have hard numeric/structural
|
|
37
|
+
bounds.
|
|
38
|
+
- No raw storage key or adapter exception is placed in the generated error.
|
|
39
|
+
- The shared-store interface carries opaque identifiers only. The consuming application is responsible for
|
|
40
|
+
purpose-scoped pseudonymization and retention.
|
|
41
|
+
- The module starts no timer, cleanup loop, polling process or background task. Local cleanup is caller-triggered.
|
|
42
|
+
|
|
43
|
+
## Semantics
|
|
44
|
+
|
|
45
|
+
The provided in-memory implementation uses exact sliding-window timestamps. It exists for deterministic tests and
|
|
46
|
+
explicitly single-instance development, not production. A shared implementation may use exact sliding-window
|
|
47
|
+
semantics or a conservatively safe equivalent, but its read/prune/admit/write decision must be atomic. Concurrent
|
|
48
|
+
requests for the final permit may produce exactly one successful decision.
|
|
49
|
+
|
|
50
|
+
Weighted requests consume multiple permit units. An unsuccessful weighted request does not mutate the committed
|
|
51
|
+
usage, so `remaining` can be positive but lower than the attempted cost.
|
|
52
|
+
|
|
53
|
+
## Verification
|
|
54
|
+
|
|
55
|
+
The focused Bedrock suite covers singleton behavior, forwarding-header spoof resistance, deterministic window
|
|
56
|
+
reset, weighted cost, subject/endpoint isolation, headers, policy precedence, invalid configuration atomicity,
|
|
57
|
+
the production shared-store gate, cross-instance state, concurrent final-permit behavior, non-reflective store
|
|
58
|
+
failure, malformed store results and explicit timer-free cleanup. Full-package compilation, tests, lint, import and
|
|
59
|
+
naming validation are release gates for the candidate.
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* FR-320 — NPM-TOKEN ALLAPOT-OSZTALYOZO (bedrock).
|
|
3
|
+
*
|
|
4
|
+
* MIERT KELLETT (2026-08-20..22, valos incidens): a flotta npm-tokenje lejart, majd egy olyan
|
|
5
|
+
* pot-token kerult be, aminek NEM volt 2FA-bypass joga. A kovetkezmeny NAPOKIG tartott es
|
|
6
|
+
* MINDENHOL `E404`-kent jelentkezett — privat csomagnal ugyanis az npm a jogosulatlan kerest
|
|
7
|
+
* 404-gyel utasitja el, NEM 401-gyel. Emiatt a "nincs ilyen csomag", a "lejart kulcs" es a
|
|
8
|
+
* "rossz jogu kulcs" MEGKULONBOZTETHETETLEN volt, es a diagnozis tobb kort vitt el.
|
|
9
|
+
*
|
|
10
|
+
* A KULCS-DISZKRIMINATOR: a `/-/whoami` vegpont NEM csomag-fuggo, ezert nem esik bele a privat-404
|
|
11
|
+
* elrejtesbe:
|
|
12
|
+
* - token NELKUL / ROSSZ tokennel -> **401**
|
|
13
|
+
* - ERVENYES tokennel -> **200** + a felhasznalonev
|
|
14
|
+
* Innen a csomag-szintu proba mar ertelmezheto: ha a whoami OK, de a scope-olt csomag 404, akkor a
|
|
15
|
+
* token EL, csak nincs joga hozza.
|
|
16
|
+
*
|
|
17
|
+
* ⚠️ AMIT EZ NEM TUD MEGALLAPITANI (szandekosan kimondva, hogy ne igerjunk tobbet a valosagnal):
|
|
18
|
+
* - a **2FA-bypass** hianya CSAK publikalaskor derul ki (`EOTP` hibakod) — read-only probaval nem;
|
|
19
|
+
* - a **lejart** es a **visszavont** token kivulrol egyforman 401;
|
|
20
|
+
* - a token **elettartama** nem kerdezheto le.
|
|
21
|
+
* Ezert a `publishErrorCode` opcionalis bemenet: ha egy publish mar elbukott, az `EOTP` alapjan
|
|
22
|
+
* ERRE is tudunk hatarozott allapotot mondani.
|
|
23
|
+
*
|
|
24
|
+
* A TOKEN ERTEKE SOSEM KERUL A KIMENETBE — sem logba, sem eredmenybe.
|
|
25
|
+
*/
|
|
26
|
+
/** Az npm-token megallapithato allapotai. */
|
|
27
|
+
export declare enum DyNTS_NpmTokenState {
|
|
28
|
+
/** Nincs beallitva token (se env, se .npmrc). */
|
|
29
|
+
missing = "missing",
|
|
30
|
+
/** Van ertek, de nem npm-token alaku — jellemzoen elgepeles / rossz valtozo. */
|
|
31
|
+
malformed = "malformed",
|
|
32
|
+
/** A registry elutasitja (401): lejart, visszavont vagy egyszeruen rossz. */
|
|
33
|
+
invalid = "invalid",
|
|
34
|
+
/** A token EL (whoami OK), de a vizsgalt scope-hoz/csomaghoz NINCS joga. */
|
|
35
|
+
noScopeAccess = "no-scope-access",
|
|
36
|
+
/** A token el es olvas, de publikalasra nincs joga (2FA-bypass hianya — `EOTP`). */
|
|
37
|
+
missingPublishRight = "missing-publish-right",
|
|
38
|
+
/** Minden vizsgalt kepesseg rendben. */
|
|
39
|
+
ok = "ok",
|
|
40
|
+
/** A proba maga nem futott le (halozat/timeout) — NEM azonos azzal, hogy a token rossz. */
|
|
41
|
+
unknown = "unknown"
|
|
42
|
+
}
|
|
43
|
+
/** A helyi (halozat NELKULI) alak-ellenorzes eredmenye. */
|
|
44
|
+
export declare enum DyNTS_NpmTokenShape {
|
|
45
|
+
missing = "missing",
|
|
46
|
+
malformed = "malformed",
|
|
47
|
+
plausible = "plausible"
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* PURE — a token ALAKJANAK ellenorzese, halozat nelkul.
|
|
51
|
+
*
|
|
52
|
+
* MIERT KULON LEPES: a "nincs beallitva" es a "rosszul beallitva" eseteket halozat nelkul, azonnal
|
|
53
|
+
* es egyertelmuen el lehet donteni — ezek a leggyakoribb operatori hibak (ures env-var, idezojelek
|
|
54
|
+
* bennragadtak, a `//registry…/:_authToken=` PREFIX is bemasolodott).
|
|
55
|
+
*
|
|
56
|
+
* Az npm mai token-alakjai `npm_`-mel kezdodnek (classic automation + granular). A regi, prefix
|
|
57
|
+
* nelkuli UUID-alaku tokenek MEG ervenyesek lehetnek, ezert azokat is `plausible`-nek vesszuk —
|
|
58
|
+
* inkabb engedunk at egy kesobb 401-et kapo tokent, mint hogy egy jot elutasitsunk.
|
|
59
|
+
*/
|
|
60
|
+
export declare function classifyNpmTokenShape(rawToken: string | undefined | null): DyNTS_NpmTokenShape;
|
|
61
|
+
/**
|
|
62
|
+
* Publish-oldali npm-hibakodok, amik ELO token mellett JOGOSULTSAG-hianyt jelentenek.
|
|
63
|
+
*
|
|
64
|
+
* A lista SZANDEKOSAN tartalmazza az `E404`-et: az npm a `PUT` (publish) kerest is 404-gyel
|
|
65
|
+
* utasitja el, ha a tokennek nincs irasi joga a csomagra. Elo token mellett ez SOSEM jelentheti,
|
|
66
|
+
* hogy a csomag hianyzik — hiszen olvasni tudtuk.
|
|
67
|
+
*/
|
|
68
|
+
export declare const PUBLISH_RIGHT_ERROR_CODES: string[];
|
|
69
|
+
/** A halozati proba nyers bemenete (a `classifyNpmTokenProbe` szamara). */
|
|
70
|
+
export interface DyNTS_NpmTokenProbe_Input {
|
|
71
|
+
/** A `/-/whoami` HTTP-statusza. `null`, ha a hivas el sem jutott a szerverig. */
|
|
72
|
+
whoamiStatus: number | null;
|
|
73
|
+
/** Egy SCOPE-olt (jellemzoen privat) csomag metaadat-lekeresenek statusza; `undefined` = nem mertuk. */
|
|
74
|
+
scopedPackageStatus?: number;
|
|
75
|
+
/** Ha egy publish MAR elbukott, annak npm-hibakodja (pl. `EOTP`, `E403`); `undefined` = nem mertuk. */
|
|
76
|
+
publishErrorCode?: string;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* PURE — a halozati valaszokbol allapot.
|
|
80
|
+
*
|
|
81
|
+
* A sorrend SZANDEKOS: a `whoami` az egyetlen csomag-fuggetlen jel, ezert az dont eloszor. Csak
|
|
82
|
+
* utana ertelmezheto a csomag-szintu 404 — kulonben ugyanaz a 404 jelentene "nincs ilyen csomag"-ot
|
|
83
|
+
* es "rossz kulcs"-ot is, ami epp a 2026-08-i incidens diagnozisat huzta el.
|
|
84
|
+
*/
|
|
85
|
+
export declare function classifyNpmTokenProbe(input: DyNTS_NpmTokenProbe_Input): DyNTS_NpmTokenState;
|
|
86
|
+
/**
|
|
87
|
+
* PURE — ember-olvashato magyarazat + a KOVETKEZO LEPES. A puszta allapot-cimke keves: az operator
|
|
88
|
+
* azt akarja tudni, mit tegyen.
|
|
89
|
+
*/
|
|
90
|
+
export declare function describeNpmTokenState(state: DyNTS_NpmTokenState): string;
|
|
91
|
+
/** A teljes ellenorzes eredmenye. A token ERTEKE sosem szerepel benne. */
|
|
92
|
+
export interface DyNTS_NpmTokenCheck_Result {
|
|
93
|
+
state: DyNTS_NpmTokenState;
|
|
94
|
+
/** A `/-/whoami` altal visszaadott felhasznalonev, ha a token ervenyes. */
|
|
95
|
+
username: string | null;
|
|
96
|
+
/** Ember-olvashato magyarazat + kovetkezo lepes. */
|
|
97
|
+
detail: string;
|
|
98
|
+
/** Amit tenylegesen mertunk (diagnosztikahoz). */
|
|
99
|
+
probe: DyNTS_NpmTokenProbe_Input;
|
|
100
|
+
}
|
|
101
|
+
/** A `checkNpmToken` bemenete. */
|
|
102
|
+
export interface DyNTS_NpmTokenCheck_Options {
|
|
103
|
+
/** A vizsgalando token. Ha nincs megadva, a `process.env.NPM_TOKEN`-t hasznaljuk. */
|
|
104
|
+
token?: string;
|
|
105
|
+
/** Registry-alap. Default: a publikus npm. */
|
|
106
|
+
registry?: string;
|
|
107
|
+
/**
|
|
108
|
+
* Egy SCOPE-olt csomag, amin a jogosultsagot merjuk (pl. `@futdevpro/cli-dynamo`).
|
|
109
|
+
* Ha nincs megadva, csak a whoami fut le.
|
|
110
|
+
*/
|
|
111
|
+
scopedPackage?: string;
|
|
112
|
+
/** Ha egy publish mar elbukott, annak npm-hibakodja — igy a 2FA-bypass hianya is besorolhato. */
|
|
113
|
+
publishErrorCode?: string;
|
|
114
|
+
/** Halozati timeout (ms). Default: 10000. */
|
|
115
|
+
timeoutMs?: number;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* PURE — token kinyerese egy `.npmrc` TARTALMABOL.
|
|
119
|
+
*
|
|
120
|
+
* MIERT KELL: az elso valtozat CSAK a `process.env.NPM_TOKEN`-t nezte, es ezert a sajat
|
|
121
|
+
* workstationomon `missing`-et adott — HOLOTT az npm ott tokeletesen mukodott, mert a token a
|
|
122
|
+
* `~/.npmrc`-ben all. Ez HAMIS NEGATIV, es epp a legfontosabb helyeken (runner-kontener, hosztok)
|
|
123
|
+
* sulna el, ahol a token szinten FAJLBAN van.
|
|
124
|
+
*
|
|
125
|
+
* A `.npmrc`-t csak OLVASSUK — letrehozni tilos (flotta-szintu hard rule).
|
|
126
|
+
*/
|
|
127
|
+
export declare function extractTokenFromNpmrc(content: string, registry?: string): string | null;
|
|
128
|
+
/**
|
|
129
|
+
* A token feloldasa a szokasos helyekrol, PRIORITAS szerint:
|
|
130
|
+
* 1. explicit parameter, 2. `NPM_TOKEN` env, 3. a felhasznaloi `~/.npmrc`.
|
|
131
|
+
* Sose dob; ha egyik sincs, ures stringet ad.
|
|
132
|
+
*/
|
|
133
|
+
export declare function resolveNpmToken(explicit: string | undefined, registry: string): string;
|
|
134
|
+
/**
|
|
135
|
+
* A tenyleges ellenorzes. SOSE dob — a hibat allapotkent adja vissza (a token-ellenorzes nem
|
|
136
|
+
* buktathat meg semmit, amibe beepitjuk).
|
|
137
|
+
*/
|
|
138
|
+
export declare function checkNpmToken(options?: DyNTS_NpmTokenCheck_Options): Promise<DyNTS_NpmTokenCheck_Result>;
|
|
139
|
+
//# sourceMappingURL=npm-token-check.util.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"npm-token-check.util.d.ts","sourceRoot":"","sources":["../../src/_collections/npm-token-check.util.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,6CAA6C;AAC7C,oBAAY,mBAAmB;IAC7B,iDAAiD;IACjD,OAAO,YAAY;IACnB,gFAAgF;IAChF,SAAS,cAAc;IACvB,6EAA6E;IAC7E,OAAO,YAAY;IACnB,4EAA4E;IAC5E,aAAa,oBAAoB;IACjC,oFAAoF;IACpF,mBAAmB,0BAA0B;IAC7C,wCAAwC;IACxC,EAAE,OAAO;IACT,2FAA2F;IAC3F,OAAO,YAAY;CACpB;AAED,2DAA2D;AAC3D,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,mBAAmB,CAc9F;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,EAA6B,CAAC;AAE5E,2EAA2E;AAC3E,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wGAAwG;IACxG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,yBAAyB,GAAG,mBAAmB,CAgC3F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAsBxE;AAED,0EAA0E;AAC1E,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,EAAE,yBAAyB,CAAC;CAClC;AAED,kCAAkC;AAClC,MAAM,WAAW,2BAA2B;IAC1C,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAyB,GAAG,MAAM,GAAG,IAAI,CAiBzG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CActF;AAsBD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CAkDrC"}
|
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.PUBLISH_RIGHT_ERROR_CODES = exports.DyNTS_NpmTokenShape = exports.DyNTS_NpmTokenState = void 0;
|
|
4
|
+
exports.classifyNpmTokenShape = classifyNpmTokenShape;
|
|
5
|
+
exports.classifyNpmTokenProbe = classifyNpmTokenProbe;
|
|
6
|
+
exports.describeNpmTokenState = describeNpmTokenState;
|
|
7
|
+
exports.extractTokenFromNpmrc = extractTokenFromNpmrc;
|
|
8
|
+
exports.resolveNpmToken = resolveNpmToken;
|
|
9
|
+
exports.checkNpmToken = checkNpmToken;
|
|
10
|
+
const tslib_1 = require("tslib");
|
|
11
|
+
const fs = tslib_1.__importStar(require("fs"));
|
|
12
|
+
const os = tslib_1.__importStar(require("os"));
|
|
13
|
+
const path = tslib_1.__importStar(require("path"));
|
|
14
|
+
const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
|
|
15
|
+
/**
|
|
16
|
+
* FR-320 — NPM-TOKEN ALLAPOT-OSZTALYOZO (bedrock).
|
|
17
|
+
*
|
|
18
|
+
* MIERT KELLETT (2026-08-20..22, valos incidens): a flotta npm-tokenje lejart, majd egy olyan
|
|
19
|
+
* pot-token kerult be, aminek NEM volt 2FA-bypass joga. A kovetkezmeny NAPOKIG tartott es
|
|
20
|
+
* MINDENHOL `E404`-kent jelentkezett — privat csomagnal ugyanis az npm a jogosulatlan kerest
|
|
21
|
+
* 404-gyel utasitja el, NEM 401-gyel. Emiatt a "nincs ilyen csomag", a "lejart kulcs" es a
|
|
22
|
+
* "rossz jogu kulcs" MEGKULONBOZTETHETETLEN volt, es a diagnozis tobb kort vitt el.
|
|
23
|
+
*
|
|
24
|
+
* A KULCS-DISZKRIMINATOR: a `/-/whoami` vegpont NEM csomag-fuggo, ezert nem esik bele a privat-404
|
|
25
|
+
* elrejtesbe:
|
|
26
|
+
* - token NELKUL / ROSSZ tokennel -> **401**
|
|
27
|
+
* - ERVENYES tokennel -> **200** + a felhasznalonev
|
|
28
|
+
* Innen a csomag-szintu proba mar ertelmezheto: ha a whoami OK, de a scope-olt csomag 404, akkor a
|
|
29
|
+
* token EL, csak nincs joga hozza.
|
|
30
|
+
*
|
|
31
|
+
* ⚠️ AMIT EZ NEM TUD MEGALLAPITANI (szandekosan kimondva, hogy ne igerjunk tobbet a valosagnal):
|
|
32
|
+
* - a **2FA-bypass** hianya CSAK publikalaskor derul ki (`EOTP` hibakod) — read-only probaval nem;
|
|
33
|
+
* - a **lejart** es a **visszavont** token kivulrol egyforman 401;
|
|
34
|
+
* - a token **elettartama** nem kerdezheto le.
|
|
35
|
+
* Ezert a `publishErrorCode` opcionalis bemenet: ha egy publish mar elbukott, az `EOTP` alapjan
|
|
36
|
+
* ERRE is tudunk hatarozott allapotot mondani.
|
|
37
|
+
*
|
|
38
|
+
* A TOKEN ERTEKE SOSEM KERUL A KIMENETBE — sem logba, sem eredmenybe.
|
|
39
|
+
*/
|
|
40
|
+
/** Az npm-token megallapithato allapotai. */
|
|
41
|
+
var DyNTS_NpmTokenState;
|
|
42
|
+
(function (DyNTS_NpmTokenState) {
|
|
43
|
+
/** Nincs beallitva token (se env, se .npmrc). */
|
|
44
|
+
DyNTS_NpmTokenState["missing"] = "missing";
|
|
45
|
+
/** Van ertek, de nem npm-token alaku — jellemzoen elgepeles / rossz valtozo. */
|
|
46
|
+
DyNTS_NpmTokenState["malformed"] = "malformed";
|
|
47
|
+
/** A registry elutasitja (401): lejart, visszavont vagy egyszeruen rossz. */
|
|
48
|
+
DyNTS_NpmTokenState["invalid"] = "invalid";
|
|
49
|
+
/** A token EL (whoami OK), de a vizsgalt scope-hoz/csomaghoz NINCS joga. */
|
|
50
|
+
DyNTS_NpmTokenState["noScopeAccess"] = "no-scope-access";
|
|
51
|
+
/** A token el es olvas, de publikalasra nincs joga (2FA-bypass hianya — `EOTP`). */
|
|
52
|
+
DyNTS_NpmTokenState["missingPublishRight"] = "missing-publish-right";
|
|
53
|
+
/** Minden vizsgalt kepesseg rendben. */
|
|
54
|
+
DyNTS_NpmTokenState["ok"] = "ok";
|
|
55
|
+
/** A proba maga nem futott le (halozat/timeout) — NEM azonos azzal, hogy a token rossz. */
|
|
56
|
+
DyNTS_NpmTokenState["unknown"] = "unknown";
|
|
57
|
+
})(DyNTS_NpmTokenState || (exports.DyNTS_NpmTokenState = DyNTS_NpmTokenState = {}));
|
|
58
|
+
/** A helyi (halozat NELKULI) alak-ellenorzes eredmenye. */
|
|
59
|
+
var DyNTS_NpmTokenShape;
|
|
60
|
+
(function (DyNTS_NpmTokenShape) {
|
|
61
|
+
DyNTS_NpmTokenShape["missing"] = "missing";
|
|
62
|
+
DyNTS_NpmTokenShape["malformed"] = "malformed";
|
|
63
|
+
DyNTS_NpmTokenShape["plausible"] = "plausible";
|
|
64
|
+
})(DyNTS_NpmTokenShape || (exports.DyNTS_NpmTokenShape = DyNTS_NpmTokenShape = {}));
|
|
65
|
+
/**
|
|
66
|
+
* PURE — a token ALAKJANAK ellenorzese, halozat nelkul.
|
|
67
|
+
*
|
|
68
|
+
* MIERT KULON LEPES: a "nincs beallitva" es a "rosszul beallitva" eseteket halozat nelkul, azonnal
|
|
69
|
+
* es egyertelmuen el lehet donteni — ezek a leggyakoribb operatori hibak (ures env-var, idezojelek
|
|
70
|
+
* bennragadtak, a `//registry…/:_authToken=` PREFIX is bemasolodott).
|
|
71
|
+
*
|
|
72
|
+
* Az npm mai token-alakjai `npm_`-mel kezdodnek (classic automation + granular). A regi, prefix
|
|
73
|
+
* nelkuli UUID-alaku tokenek MEG ervenyesek lehetnek, ezert azokat is `plausible`-nek vesszuk —
|
|
74
|
+
* inkabb engedunk at egy kesobb 401-et kapo tokent, mint hogy egy jot elutasitsunk.
|
|
75
|
+
*/
|
|
76
|
+
function classifyNpmTokenShape(rawToken) {
|
|
77
|
+
const token = (rawToken ?? '').trim();
|
|
78
|
+
if (!token) {
|
|
79
|
+
return DyNTS_NpmTokenShape.missing;
|
|
80
|
+
}
|
|
81
|
+
// Gyakori elgepeles: a teljes .npmrc-sor kerult be a token helyere.
|
|
82
|
+
if (token.includes('_authToken') || token.includes('registry.npmjs.org')) {
|
|
83
|
+
return DyNTS_NpmTokenShape.malformed;
|
|
84
|
+
}
|
|
85
|
+
// Bennragadt idezojelek / whitespace a valtozo erteken belul.
|
|
86
|
+
if (/["'\s]/.test(token)) {
|
|
87
|
+
return DyNTS_NpmTokenShape.malformed;
|
|
88
|
+
}
|
|
89
|
+
// Nyilvanvaloan tul rovid ertek (pl. "x", "changeme").
|
|
90
|
+
if (token.length < 24) {
|
|
91
|
+
return DyNTS_NpmTokenShape.malformed;
|
|
92
|
+
}
|
|
93
|
+
return DyNTS_NpmTokenShape.plausible;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Publish-oldali npm-hibakodok, amik ELO token mellett JOGOSULTSAG-hianyt jelentenek.
|
|
97
|
+
*
|
|
98
|
+
* A lista SZANDEKOSAN tartalmazza az `E404`-et: az npm a `PUT` (publish) kerest is 404-gyel
|
|
99
|
+
* utasitja el, ha a tokennek nincs irasi joga a csomagra. Elo token mellett ez SOSEM jelentheti,
|
|
100
|
+
* hogy a csomag hianyzik — hiszen olvasni tudtuk.
|
|
101
|
+
*/
|
|
102
|
+
exports.PUBLISH_RIGHT_ERROR_CODES = ['EOTP', 'E403', 'E404'];
|
|
103
|
+
/**
|
|
104
|
+
* PURE — a halozati valaszokbol allapot.
|
|
105
|
+
*
|
|
106
|
+
* A sorrend SZANDEKOS: a `whoami` az egyetlen csomag-fuggetlen jel, ezert az dont eloszor. Csak
|
|
107
|
+
* utana ertelmezheto a csomag-szintu 404 — kulonben ugyanaz a 404 jelentene "nincs ilyen csomag"-ot
|
|
108
|
+
* es "rossz kulcs"-ot is, ami epp a 2026-08-i incidens diagnozisat huzta el.
|
|
109
|
+
*/
|
|
110
|
+
function classifyNpmTokenProbe(input) {
|
|
111
|
+
// A proba el sem jutott a registryig -> NEM allitunk semmit a tokenrol.
|
|
112
|
+
if (input.whoamiStatus === null) {
|
|
113
|
+
return DyNTS_NpmTokenState.unknown;
|
|
114
|
+
}
|
|
115
|
+
// 401 = a registry elutasitja a hitelesitest (hianyzo/lejart/visszavont/rossz token).
|
|
116
|
+
if (input.whoamiStatus === 401) {
|
|
117
|
+
return DyNTS_NpmTokenState.invalid;
|
|
118
|
+
}
|
|
119
|
+
// Barmi mas, ami nem 200: nem tudunk hatarozott allapotot mondani (5xx, rate-limit, proxy).
|
|
120
|
+
if (input.whoamiStatus !== 200) {
|
|
121
|
+
return DyNTS_NpmTokenState.unknown;
|
|
122
|
+
}
|
|
123
|
+
// Innentol a token IGAZOLTAN el (whoami 200). Ezert BARMILYEN publish-oldali elutasitas
|
|
124
|
+
// JOGOSULTSAG-hiany, NEM hianyzo csomag:
|
|
125
|
+
// EOTP -> 2FA-bypass hianya,
|
|
126
|
+
// E403 -> explicit tiltas,
|
|
127
|
+
// E404 -> az npm a PUT-ra is 404-gyel valaszol, ha a tokennek NINCS IRASI joga a csomagra
|
|
128
|
+
// (ugyanaz a letezes-elrejtes, mint olvasasnal).
|
|
129
|
+
// MERVE (2026-08-22): `npm error 404 Not Found - PUT .../@futdevpro%2fnts-dynamo` — mikozben
|
|
130
|
+
// UGYANAZ a token olvasni tudta a csomagot. Enelkul a megkulonboztetes nelkul ez "nincs ilyen
|
|
131
|
+
// csomag"-nak latszik, es epp ez vitte felre a diagnozist napokig.
|
|
132
|
+
if (exports.PUBLISH_RIGHT_ERROR_CODES.includes((input.publishErrorCode ?? '').toUpperCase())) {
|
|
133
|
+
return DyNTS_NpmTokenState.missingPublishRight;
|
|
134
|
+
}
|
|
135
|
+
// Elo token + a scope-olt csomag 404/403 -> a token nem lat ra a csomagra (jogosultsag).
|
|
136
|
+
if (input.scopedPackageStatus === 404 || input.scopedPackageStatus === 403) {
|
|
137
|
+
return DyNTS_NpmTokenState.noScopeAccess;
|
|
138
|
+
}
|
|
139
|
+
// A csomag-probat nem mertuk, vagy sikeres volt.
|
|
140
|
+
if (input.scopedPackageStatus === undefined || input.scopedPackageStatus === 200) {
|
|
141
|
+
return DyNTS_NpmTokenState.ok;
|
|
142
|
+
}
|
|
143
|
+
return DyNTS_NpmTokenState.unknown;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* PURE — ember-olvashato magyarazat + a KOVETKEZO LEPES. A puszta allapot-cimke keves: az operator
|
|
147
|
+
* azt akarja tudni, mit tegyen.
|
|
148
|
+
*/
|
|
149
|
+
function describeNpmTokenState(state) {
|
|
150
|
+
switch (state) {
|
|
151
|
+
case DyNTS_NpmTokenState.missing:
|
|
152
|
+
return 'Nincs beallitva npm-token. Teendo: allitsd be a Keystore/CI kornyezetben (NEM .npmrc-fajlban).';
|
|
153
|
+
case DyNTS_NpmTokenState.malformed:
|
|
154
|
+
return 'A token erteke nem npm-token alaku (idezojel, whitespace, vagy a teljes .npmrc-sor kerult be). '
|
|
155
|
+
+ 'Teendo: csak a NYERS token-erteket add meg.';
|
|
156
|
+
case DyNTS_NpmTokenState.invalid:
|
|
157
|
+
return 'A registry ELUTASITJA a tokent (401): lejart, visszavont vagy rossz. Teendo: uj token. '
|
|
158
|
+
+ 'FIGYELEM: privat csomagnal ez a hiba a HIVOKNAL 404-kent jelenik meg, nem 401-kent.';
|
|
159
|
+
case DyNTS_NpmTokenState.noScopeAccess:
|
|
160
|
+
return 'A token EL, de a vizsgalt scope-hoz/csomaghoz nincs joga (a whoami rendben, a csomag 404/403). '
|
|
161
|
+
+ 'Teendo: a token jogosultsagi koret bovitsd a scope-ra.';
|
|
162
|
+
case DyNTS_NpmTokenState.missingPublishRight:
|
|
163
|
+
return 'A token EL es OLVAS, de PUBLIKALNI nem tud (`EOTP` / `E403` / publish-oldali `E404`): '
|
|
164
|
+
+ 'hianyzik az iras/2FA-bypass jog. FIGYELEM: a PUT-ra kapott 404 NEM hianyzo csomagot jelent, '
|
|
165
|
+
+ 'hanem jogosultsag-hianyt. Teendo: automation/granular token IRASI joggal a scope-ra.';
|
|
166
|
+
case DyNTS_NpmTokenState.ok:
|
|
167
|
+
return 'A token ervenyes, es a vizsgalt csomagot is eleri.';
|
|
168
|
+
default:
|
|
169
|
+
return 'A proba nem jutott el a registryig (halozat/timeout/proxy) — ez NEM bizonyitja, hogy a token rossz.';
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* PURE — token kinyerese egy `.npmrc` TARTALMABOL.
|
|
174
|
+
*
|
|
175
|
+
* MIERT KELL: az elso valtozat CSAK a `process.env.NPM_TOKEN`-t nezte, es ezert a sajat
|
|
176
|
+
* workstationomon `missing`-et adott — HOLOTT az npm ott tokeletesen mukodott, mert a token a
|
|
177
|
+
* `~/.npmrc`-ben all. Ez HAMIS NEGATIV, es epp a legfontosabb helyeken (runner-kontener, hosztok)
|
|
178
|
+
* sulna el, ahol a token szinten FAJLBAN van.
|
|
179
|
+
*
|
|
180
|
+
* A `.npmrc`-t csak OLVASSUK — letrehozni tilos (flotta-szintu hard rule).
|
|
181
|
+
*/
|
|
182
|
+
function extractTokenFromNpmrc(content, registry = DEFAULT_REGISTRY) {
|
|
183
|
+
const host = registry.replace(/^https?:/, '').replace(/\/+$/, '');
|
|
184
|
+
for (const rawLine of content.split(/\r?\n/)) {
|
|
185
|
+
const line = rawLine.trim();
|
|
186
|
+
if (!line || line.startsWith('#') || line.startsWith(';')) {
|
|
187
|
+
continue;
|
|
188
|
+
}
|
|
189
|
+
// Alak: `//registry.npmjs.org/:_authToken=<ertek>` (a host elotti `//` a kulcs resze).
|
|
190
|
+
const match = line.match(/^(\/\/[^:]+):_authToken=(.+)$/);
|
|
191
|
+
if (!match) {
|
|
192
|
+
continue;
|
|
193
|
+
}
|
|
194
|
+
// A `.npmrc` a hostot ZARO PERJELLEL irja (`//registry.npmjs.org/`), a normalizalt
|
|
195
|
+
// `host` viszont nelkule all — ezert MINDKET oldalt normalizalni kell. Az elso
|
|
196
|
+
// valtozatom csak az egyiket tette, es ezert SOSEM illeszkedett (a specek fogtak meg).
|
|
197
|
+
const lineHost = match[1].replace(/\/+$/, '');
|
|
198
|
+
if (lineHost !== host) {
|
|
199
|
+
continue;
|
|
200
|
+
}
|
|
201
|
+
const value = match[2].trim().replace(/^["']|["']$/g, '');
|
|
202
|
+
if (value) {
|
|
203
|
+
return value;
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
return null;
|
|
207
|
+
}
|
|
208
|
+
/**
|
|
209
|
+
* A token feloldasa a szokasos helyekrol, PRIORITAS szerint:
|
|
210
|
+
* 1. explicit parameter, 2. `NPM_TOKEN` env, 3. a felhasznaloi `~/.npmrc`.
|
|
211
|
+
* Sose dob; ha egyik sincs, ures stringet ad.
|
|
212
|
+
*/
|
|
213
|
+
function resolveNpmToken(explicit, registry) {
|
|
214
|
+
const fromExplicit = (explicit ?? '').trim();
|
|
215
|
+
if (fromExplicit) {
|
|
216
|
+
return fromExplicit;
|
|
217
|
+
}
|
|
218
|
+
const fromEnv = (process.env.NPM_TOKEN ?? '').trim();
|
|
219
|
+
if (fromEnv) {
|
|
220
|
+
return fromEnv;
|
|
221
|
+
}
|
|
222
|
+
try {
|
|
223
|
+
const npmrcPath = path.join(os.homedir(), '.npmrc');
|
|
224
|
+
if (fs.existsSync(npmrcPath)) {
|
|
225
|
+
return extractTokenFromNpmrc(fs.readFileSync(npmrcPath, 'utf-8'), registry) ?? '';
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
catch {
|
|
229
|
+
// A fajl-olvasas hibaja NEM buktathatja az ellenorzest.
|
|
230
|
+
}
|
|
231
|
+
return '';
|
|
232
|
+
}
|
|
233
|
+
const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
|
|
234
|
+
const DEFAULT_TIMEOUT_MS = 10000;
|
|
235
|
+
/** Egy statusz-lekeres, timeout-tal. `null`, ha el sem jutottunk a szerverig. */
|
|
236
|
+
async function fetchStatus(url, token, timeoutMs) {
|
|
237
|
+
const controller = new AbortController();
|
|
238
|
+
const timer = setTimeout(() => { controller.abort(); }, timeoutMs);
|
|
239
|
+
try {
|
|
240
|
+
const response = await fetch(url, {
|
|
241
|
+
headers: token ? { authorization: `Bearer ${token}` } : {},
|
|
242
|
+
signal: controller.signal,
|
|
243
|
+
});
|
|
244
|
+
return response.status;
|
|
245
|
+
}
|
|
246
|
+
catch {
|
|
247
|
+
return null;
|
|
248
|
+
}
|
|
249
|
+
finally {
|
|
250
|
+
clearTimeout(timer);
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
/**
|
|
254
|
+
* A tenyleges ellenorzes. SOSE dob — a hibat allapotkent adja vissza (a token-ellenorzes nem
|
|
255
|
+
* buktathat meg semmit, amibe beepitjuk).
|
|
256
|
+
*/
|
|
257
|
+
async function checkNpmToken(options = {}) {
|
|
258
|
+
const registry = (options.registry ?? DEFAULT_REGISTRY).replace(/\/+$/, '');
|
|
259
|
+
const token = resolveNpmToken(options.token, registry);
|
|
260
|
+
const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
|
|
261
|
+
const shape = classifyNpmTokenShape(token);
|
|
262
|
+
if (shape !== DyNTS_NpmTokenShape.plausible) {
|
|
263
|
+
const localState = shape === DyNTS_NpmTokenShape.missing
|
|
264
|
+
? DyNTS_NpmTokenState.missing
|
|
265
|
+
: DyNTS_NpmTokenState.malformed;
|
|
266
|
+
return {
|
|
267
|
+
state: localState,
|
|
268
|
+
username: null,
|
|
269
|
+
detail: describeNpmTokenState(localState),
|
|
270
|
+
probe: { whoamiStatus: null },
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
const whoamiStatus = await fetchStatus(`${registry}/-/whoami`, token, timeoutMs);
|
|
274
|
+
let username = null;
|
|
275
|
+
if (whoamiStatus === 200) {
|
|
276
|
+
try {
|
|
277
|
+
const response = await fetch(`${registry}/-/whoami`, {
|
|
278
|
+
headers: { authorization: `Bearer ${token}` },
|
|
279
|
+
});
|
|
280
|
+
const body = await response.json();
|
|
281
|
+
username = typeof body.username === 'string' ? body.username : null;
|
|
282
|
+
}
|
|
283
|
+
catch {
|
|
284
|
+
username = null;
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
let scopedPackageStatus;
|
|
288
|
+
if (options.scopedPackage && whoamiStatus === 200) {
|
|
289
|
+
const encoded = options.scopedPackage.replace('/', '%2f');
|
|
290
|
+
const status = await fetchStatus(`${registry}/${encoded}`, token, timeoutMs);
|
|
291
|
+
scopedPackageStatus = status === null ? undefined : status;
|
|
292
|
+
}
|
|
293
|
+
const probe = {
|
|
294
|
+
whoamiStatus: whoamiStatus,
|
|
295
|
+
scopedPackageStatus: scopedPackageStatus,
|
|
296
|
+
publishErrorCode: options.publishErrorCode,
|
|
297
|
+
};
|
|
298
|
+
const state = classifyNpmTokenProbe(probe);
|
|
299
|
+
fsm_dynamo_1.DyFM_Log.info(`[npm-token-check] allapot=${state}${username ? ` user=${username}` : ''} (a token erteke NEM naplozodik)`);
|
|
300
|
+
return { state: state, username: username, detail: describeNpmTokenState(state), probe: probe };
|
|
301
|
+
}
|
|
302
|
+
//# sourceMappingURL=npm-token-check.util.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"npm-token-check.util.js","sourceRoot":"","sources":["../../src/_collections/npm-token-check.util.ts"],"names":[],"mappings":"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"}
|