@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_collections/mongo-reconnect-guard.util.js

@@ -1,111 +1,111 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldForceMongoReconnect = shouldForceMongoReconnect;
-exports.startMongoReconnectGuard = startMongoReconnectGuard;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-/**
- * PURE döntés: kell-e force-reconnect. Healthy (===1) / connecting (===2) / in-flight / grace-en
- * vagy cooldown-on belül → NEM. Csak tartós nem-connected (disconnected/disconnecting) + grace és
- * cooldown letelt + nincs in-flight → IGEN.
- */
-function shouldForceMongoReconnect(s) {
-    if (s.readyState === 1) {
-        return { reconnect: false, reason: 'connected (readyState=1)' };
-    }
-    if (s.readyState === 2) {
-        return { reconnect: false, reason: 'connecting (readyState=2) — letting the driver finish' };
-    }
-    if (s.reconnectInFlight) {
-        return { reconnect: false, reason: 'a force-reconnect is already in flight' };
-    }
-    if (s.msSinceUnhealthy < s.unhealthyGraceMs) {
-        return {
-            reconnect: false,
-            reason: `unhealthy for ${Math.round(s.msSinceUnhealthy / 1000)}s (< ${Math.round(s.unhealthyGraceMs / 1000)}s grace) — letting the driver self-heal first`,
-        };
-    }
-    if (s.msSinceLastReconnect < s.reconnectCooldownMs) {
-        return {
-            reconnect: false,
-            reason: `last force-reconnect ${Math.round(s.msSinceLastReconnect / 1000)}s ago (< ${Math.round(s.reconnectCooldownMs / 1000)}s cooldown)`,
-        };
-    }
-    return {
-        reconnect: true,
-        reason: `Mongo connection unhealthy (readyState=${s.readyState}) for ${Math.round(s.msSinceUnhealthy / 1000)}s past grace — forcing disconnect+connect to re-resolve the host IP`,
-    };
-}
-/**
- * Elindítja a periodikus reconnect-guard-ot. A visszaadott függvény leállítja (teszt/teardown).
- * `.unref()` — nem tartja életben az event-loop-ot.
- */
-function startMongoReconnectGuard(deps) {
-    const intervalMs = deps.intervalMs ?? 10 * fsm_dynamo_1.second;
-    const unhealthyGraceMs = deps.unhealthyGraceMs ?? 30 * fsm_dynamo_1.second;
-    const reconnectCooldownMs = deps.reconnectCooldownMs ?? 20 * fsm_dynamo_1.second;
-    let unhealthySinceMs = null;
-    let lastReconnectAtMs = null;
-    let inFlight = false;
-    let ticking = false;
-    const tick = async () => {
-        if (ticking) {
-            return;
-        }
-        ticking = true;
-        try {
-            const nowMs = Date.now();
-            const readyState = deps.getReadyState();
-            if (readyState === 1) {
-                if (unhealthySinceMs !== null) {
-                    deps.log(`[mongo-reconnect-guard] Mongo connection healthy again (was unhealthy ${Math.round((nowMs - unhealthySinceMs) / 1000)}s)`);
-                }
-                unhealthySinceMs = null;
-                return;
-            }
-            // Nem-connected: indítsuk/folytassuk az unhealthy-órát.
-            if (unhealthySinceMs === null) {
-                unhealthySinceMs = nowMs;
-            }
-            const decision = shouldForceMongoReconnect({
-                readyState: readyState,
-                msSinceUnhealthy: nowMs - unhealthySinceMs,
-                unhealthyGraceMs: unhealthyGraceMs,
-                reconnectInFlight: inFlight,
-                msSinceLastReconnect: lastReconnectAtMs === null ? Number.POSITIVE_INFINITY : nowMs - lastReconnectAtMs,
-                reconnectCooldownMs: reconnectCooldownMs,
-            });
-            if (!decision.reconnect) {
-                return;
-            }
-            deps.log(`[mongo-reconnect-guard] ${decision.reason}`);
-            inFlight = true;
-            lastReconnectAtMs = nowMs;
-            try {
-                await deps.reconnect();
-                deps.log('[mongo-reconnect-guard] force-reconnect dispatched ✓ (re-resolved host; awaiting connection open)');
-            }
-            catch (e) {
-                // A connect elbukhat, ha a Mongo épp tényleg elérhetetlen — nem baj, a következő tick
-                // (cooldown után) újrapróbál; amint a Mongo új IP-n elérhető, a re-resolve becsatlakozik.
-                deps.log(`[mongo-reconnect-guard] force-reconnect attempt failed (will retry after cooldown): ${e instanceof Error ? e.message : String(e)}`);
-            }
-            finally {
-                inFlight = false;
-            }
-        }
-        catch (e) {
-            deps.log(`[mongo-reconnect-guard] tick error (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
-        }
-        finally {
-            ticking = false;
-        }
-    };
-    const handle = setInterval(() => { void tick(); }, intervalMs);
-    if (typeof handle.unref === 'function') {
-        handle.unref();
-    }
-    fsm_dynamo_1.DyFM_Log.info(`[mongo-reconnect-guard] started — check every ${Math.round(intervalMs / 1000)}s, `
-        + `force disconnect+reconnect after ${Math.round(unhealthyGraceMs / 1000)}s sustained-unhealthy (re-resolves host IP), cooldown ${Math.round(reconnectCooldownMs / 1000)}s`);
-    return () => { clearInterval(handle); };
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldForceMongoReconnect = shouldForceMongoReconnect;
+exports.startMongoReconnectGuard = startMongoReconnectGuard;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * PURE döntés: kell-e force-reconnect. Healthy (===1) / connecting (===2) / in-flight / grace-en
+ * vagy cooldown-on belül → NEM. Csak tartós nem-connected (disconnected/disconnecting) + grace és
+ * cooldown letelt + nincs in-flight → IGEN.
+ */
+function shouldForceMongoReconnect(s) {
+    if (s.readyState === 1) {
+        return { reconnect: false, reason: 'connected (readyState=1)' };
+    }
+    if (s.readyState === 2) {
+        return { reconnect: false, reason: 'connecting (readyState=2) — letting the driver finish' };
+    }
+    if (s.reconnectInFlight) {
+        return { reconnect: false, reason: 'a force-reconnect is already in flight' };
+    }
+    if (s.msSinceUnhealthy < s.unhealthyGraceMs) {
+        return {
+            reconnect: false,
+            reason: `unhealthy for ${Math.round(s.msSinceUnhealthy / 1000)}s (< ${Math.round(s.unhealthyGraceMs / 1000)}s grace) — letting the driver self-heal first`,
+        };
+    }
+    if (s.msSinceLastReconnect < s.reconnectCooldownMs) {
+        return {
+            reconnect: false,
+            reason: `last force-reconnect ${Math.round(s.msSinceLastReconnect / 1000)}s ago (< ${Math.round(s.reconnectCooldownMs / 1000)}s cooldown)`,
+        };
+    }
+    return {
+        reconnect: true,
+        reason: `Mongo connection unhealthy (readyState=${s.readyState}) for ${Math.round(s.msSinceUnhealthy / 1000)}s past grace — forcing disconnect+connect to re-resolve the host IP`,
+    };
+}
+/**
+ * Elindítja a periodikus reconnect-guard-ot. A visszaadott függvény leállítja (teszt/teardown).
+ * `.unref()` — nem tartja életben az event-loop-ot.
+ */
+function startMongoReconnectGuard(deps) {
+    const intervalMs = deps.intervalMs ?? 10 * fsm_dynamo_1.second;
+    const unhealthyGraceMs = deps.unhealthyGraceMs ?? 30 * fsm_dynamo_1.second;
+    const reconnectCooldownMs = deps.reconnectCooldownMs ?? 20 * fsm_dynamo_1.second;
+    let unhealthySinceMs = null;
+    let lastReconnectAtMs = null;
+    let inFlight = false;
+    let ticking = false;
+    const tick = async () => {
+        if (ticking) {
+            return;
+        }
+        ticking = true;
+        try {
+            const nowMs = Date.now();
+            const readyState = deps.getReadyState();
+            if (readyState === 1) {
+                if (unhealthySinceMs !== null) {
+                    deps.log(`[mongo-reconnect-guard] Mongo connection healthy again (was unhealthy ${Math.round((nowMs - unhealthySinceMs) / 1000)}s)`);
+                }
+                unhealthySinceMs = null;
+                return;
+            }
+            // Nem-connected: indítsuk/folytassuk az unhealthy-órát.
+            if (unhealthySinceMs === null) {
+                unhealthySinceMs = nowMs;
+            }
+            const decision = shouldForceMongoReconnect({
+                readyState: readyState,
+                msSinceUnhealthy: nowMs - unhealthySinceMs,
+                unhealthyGraceMs: unhealthyGraceMs,
+                reconnectInFlight: inFlight,
+                msSinceLastReconnect: lastReconnectAtMs === null ? Number.POSITIVE_INFINITY : nowMs - lastReconnectAtMs,
+                reconnectCooldownMs: reconnectCooldownMs,
+            });
+            if (!decision.reconnect) {
+                return;
+            }
+            deps.log(`[mongo-reconnect-guard] ${decision.reason}`);
+            inFlight = true;
+            lastReconnectAtMs = nowMs;
+            try {
+                await deps.reconnect();
+                deps.log('[mongo-reconnect-guard] force-reconnect dispatched ✓ (re-resolved host; awaiting connection open)');
+            }
+            catch (e) {
+                // A connect elbukhat, ha a Mongo épp tényleg elérhetetlen — nem baj, a következő tick
+                // (cooldown után) újrapróbál; amint a Mongo új IP-n elérhető, a re-resolve becsatlakozik.
+                deps.log(`[mongo-reconnect-guard] force-reconnect attempt failed (will retry after cooldown): ${e instanceof Error ? e.message : String(e)}`);
+            }
+            finally {
+                inFlight = false;
+            }
+        }
+        catch (e) {
+            deps.log(`[mongo-reconnect-guard] tick error (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
+        }
+        finally {
+            ticking = false;
+        }
+    };
+    const handle = setInterval(() => { void tick(); }, intervalMs);
+    if (typeof handle.unref === 'function') {
+        handle.unref();
+    }
+    fsm_dynamo_1.DyFM_Log.info(`[mongo-reconnect-guard] started — check every ${Math.round(intervalMs / 1000)}s, `
+        + `force disconnect+reconnect after ${Math.round(unhealthyGraceMs / 1000)}s sustained-unhealthy (re-resolves host IP), cooldown ${Math.round(reconnectCooldownMs / 1000)}s`);
+    return () => { clearInterval(handle); };
+}
 //# sourceMappingURL=mongo-reconnect-guard.util.js.map

package/build/_collections/npm-token-check.util.d.ts

@@ -1,139 +1,139 @@
-/**
- * FR-320 — NPM-TOKEN ALLAPOT-OSZTALYOZO (bedrock).
- *
- * MIERT KELLETT (2026-08-20..22, valos incidens): a flotta npm-tokenje lejart, majd egy olyan
- * pot-token kerult be, aminek NEM volt 2FA-bypass joga. A kovetkezmeny NAPOKIG tartott es
- * MINDENHOL `E404`-kent jelentkezett — privat csomagnal ugyanis az npm a jogosulatlan kerest
- * 404-gyel utasitja el, NEM 401-gyel. Emiatt a "nincs ilyen csomag", a "lejart kulcs" es a
- * "rossz jogu kulcs" MEGKULONBOZTETHETETLEN volt, es a diagnozis tobb kort vitt el.
- *
- * A KULCS-DISZKRIMINATOR: a `/-/whoami` vegpont NEM csomag-fuggo, ezert nem esik bele a privat-404
- * elrejtesbe:
- *   - token NELKUL / ROSSZ tokennel -> **401**
- *   - ERVENYES tokennel             -> **200** + a felhasznalonev
- * Innen a csomag-szintu proba mar ertelmezheto: ha a whoami OK, de a scope-olt csomag 404, akkor a
- * token EL, csak nincs joga hozza.
- *
- * ⚠️ AMIT EZ NEM TUD MEGALLAPITANI (szandekosan kimondva, hogy ne igerjunk tobbet a valosagnal):
- *   - a **2FA-bypass** hianya CSAK publikalaskor derul ki (`EOTP` hibakod) — read-only probaval nem;
- *   - a **lejart** es a **visszavont** token kivulrol egyforman 401;
- *   - a token **elettartama** nem kerdezheto le.
- * Ezert a `publishErrorCode` opcionalis bemenet: ha egy publish mar elbukott, az `EOTP` alapjan
- * ERRE is tudunk hatarozott allapotot mondani.
- *
- * A TOKEN ERTEKE SOSEM KERUL A KIMENETBE — sem logba, sem eredmenybe.
- */
-/** Az npm-token megallapithato allapotai. */
-export declare enum DyNTS_NpmTokenState {
-    /** Nincs beallitva token (se env, se .npmrc). */
-    missing = "missing",
-    /** Van ertek, de nem npm-token alaku — jellemzoen elgepeles / rossz valtozo. */
-    malformed = "malformed",
-    /** A registry elutasitja (401): lejart, visszavont vagy egyszeruen rossz. */
-    invalid = "invalid",
-    /** A token EL (whoami OK), de a vizsgalt scope-hoz/csomaghoz NINCS joga. */
-    noScopeAccess = "no-scope-access",
-    /** A token el es olvas, de publikalasra nincs joga (2FA-bypass hianya — `EOTP`). */
-    missingPublishRight = "missing-publish-right",
-    /** Minden vizsgalt kepesseg rendben. */
-    ok = "ok",
-    /** A proba maga nem futott le (halozat/timeout) — NEM azonos azzal, hogy a token rossz. */
-    unknown = "unknown"
-}
-/** A helyi (halozat NELKULI) alak-ellenorzes eredmenye. */
-export declare enum DyNTS_NpmTokenShape {
-    missing = "missing",
-    malformed = "malformed",
-    plausible = "plausible"
-}
-/**
- * PURE — a token ALAKJANAK ellenorzese, halozat nelkul.
- *
- * MIERT KULON LEPES: a "nincs beallitva" es a "rosszul beallitva" eseteket halozat nelkul, azonnal
- * es egyertelmuen el lehet donteni — ezek a leggyakoribb operatori hibak (ures env-var, idezojelek
- * bennragadtak, a `//registry…/:_authToken=` PREFIX is bemasolodott).
- *
- * Az npm mai token-alakjai `npm_`-mel kezdodnek (classic automation + granular). A regi, prefix
- * nelkuli UUID-alaku tokenek MEG ervenyesek lehetnek, ezert azokat is `plausible`-nek vesszuk —
- * inkabb engedunk at egy kesobb 401-et kapo tokent, mint hogy egy jot elutasitsunk.
- */
-export declare function classifyNpmTokenShape(rawToken: string | undefined | null): DyNTS_NpmTokenShape;
-/**
- * Publish-oldali npm-hibakodok, amik ELO token mellett JOGOSULTSAG-hianyt jelentenek.
- *
- * A lista SZANDEKOSAN tartalmazza az `E404`-et: az npm a `PUT` (publish) kerest is 404-gyel
- * utasitja el, ha a tokennek nincs irasi joga a csomagra. Elo token mellett ez SOSEM jelentheti,
- * hogy a csomag hianyzik — hiszen olvasni tudtuk.
- */
-export declare const PUBLISH_RIGHT_ERROR_CODES: string[];
-/** A halozati proba nyers bemenete (a `classifyNpmTokenProbe` szamara). */
-export interface DyNTS_NpmTokenProbe_Input {
-    /** A `/-/whoami` HTTP-statusza. `null`, ha a hivas el sem jutott a szerverig. */
-    whoamiStatus: number | null;
-    /** Egy SCOPE-olt (jellemzoen privat) csomag metaadat-lekeresenek statusza; `undefined` = nem mertuk. */
-    scopedPackageStatus?: number;
-    /** Ha egy publish MAR elbukott, annak npm-hibakodja (pl. `EOTP`, `E403`); `undefined` = nem mertuk. */
-    publishErrorCode?: string;
-}
-/**
- * PURE — a halozati valaszokbol allapot.
- *
- * A sorrend SZANDEKOS: a `whoami` az egyetlen csomag-fuggetlen jel, ezert az dont eloszor. Csak
- * utana ertelmezheto a csomag-szintu 404 — kulonben ugyanaz a 404 jelentene "nincs ilyen csomag"-ot
- * es "rossz kulcs"-ot is, ami epp a 2026-08-i incidens diagnozisat huzta el.
- */
-export declare function classifyNpmTokenProbe(input: DyNTS_NpmTokenProbe_Input): DyNTS_NpmTokenState;
-/**
- * PURE — ember-olvashato magyarazat + a KOVETKEZO LEPES. A puszta allapot-cimke keves: az operator
- * azt akarja tudni, mit tegyen.
- */
-export declare function describeNpmTokenState(state: DyNTS_NpmTokenState): string;
-/** A teljes ellenorzes eredmenye. A token ERTEKE sosem szerepel benne. */
-export interface DyNTS_NpmTokenCheck_Result {
-    state: DyNTS_NpmTokenState;
-    /** A `/-/whoami` altal visszaadott felhasznalonev, ha a token ervenyes. */
-    username: string | null;
-    /** Ember-olvashato magyarazat + kovetkezo lepes. */
-    detail: string;
-    /** Amit tenylegesen mertunk (diagnosztikahoz). */
-    probe: DyNTS_NpmTokenProbe_Input;
-}
-/** A `checkNpmToken` bemenete. */
-export interface DyNTS_NpmTokenCheck_Options {
-    /** A vizsgalando token. Ha nincs megadva, a `process.env.NPM_TOKEN`-t hasznaljuk. */
-    token?: string;
-    /** Registry-alap. Default: a publikus npm. */
-    registry?: string;
-    /**
-     * Egy SCOPE-olt csomag, amin a jogosultsagot merjuk (pl. `@futdevpro/cli-dynamo`).
-     * Ha nincs megadva, csak a whoami fut le.
-     */
-    scopedPackage?: string;
-    /** Ha egy publish mar elbukott, annak npm-hibakodja — igy a 2FA-bypass hianya is besorolhato. */
-    publishErrorCode?: string;
-    /** Halozati timeout (ms). Default: 10000. */
-    timeoutMs?: number;
-}
-/**
- * PURE — token kinyerese egy `.npmrc` TARTALMABOL.
- *
- * MIERT KELL: az elso valtozat CSAK a `process.env.NPM_TOKEN`-t nezte, es ezert a sajat
- * workstationomon `missing`-et adott — HOLOTT az npm ott tokeletesen mukodott, mert a token a
- * `~/.npmrc`-ben all. Ez HAMIS NEGATIV, es epp a legfontosabb helyeken (runner-kontener, hosztok)
- * sulna el, ahol a token szinten FAJLBAN van.
- *
- * A `.npmrc`-t csak OLVASSUK — letrehozni tilos (flotta-szintu hard rule).
- */
-export declare function extractTokenFromNpmrc(content: string, registry?: string): string | null;
-/**
- * A token feloldasa a szokasos helyekrol, PRIORITAS szerint:
- *   1. explicit parameter, 2. `NPM_TOKEN` env, 3. a felhasznaloi `~/.npmrc`.
- * Sose dob; ha egyik sincs, ures stringet ad.
- */
-export declare function resolveNpmToken(explicit: string | undefined, registry: string): string;
-/**
- * A tenyleges ellenorzes. SOSE dob — a hibat allapotkent adja vissza (a token-ellenorzes nem
- * buktathat meg semmit, amibe beepitjuk).
- */
-export declare function checkNpmToken(options?: DyNTS_NpmTokenCheck_Options): Promise<DyNTS_NpmTokenCheck_Result>;
+/**
+ * FR-320 — NPM-TOKEN ALLAPOT-OSZTALYOZO (bedrock).
+ *
+ * MIERT KELLETT (2026-08-20..22, valos incidens): a flotta npm-tokenje lejart, majd egy olyan
+ * pot-token kerult be, aminek NEM volt 2FA-bypass joga. A kovetkezmeny NAPOKIG tartott es
+ * MINDENHOL `E404`-kent jelentkezett — privat csomagnal ugyanis az npm a jogosulatlan kerest
+ * 404-gyel utasitja el, NEM 401-gyel. Emiatt a "nincs ilyen csomag", a "lejart kulcs" es a
+ * "rossz jogu kulcs" MEGKULONBOZTETHETETLEN volt, es a diagnozis tobb kort vitt el.
+ *
+ * A KULCS-DISZKRIMINATOR: a `/-/whoami` vegpont NEM csomag-fuggo, ezert nem esik bele a privat-404
+ * elrejtesbe:
+ *   - token NELKUL / ROSSZ tokennel -> **401**
+ *   - ERVENYES tokennel             -> **200** + a felhasznalonev
+ * Innen a csomag-szintu proba mar ertelmezheto: ha a whoami OK, de a scope-olt csomag 404, akkor a
+ * token EL, csak nincs joga hozza.
+ *
+ * ⚠️ AMIT EZ NEM TUD MEGALLAPITANI (szandekosan kimondva, hogy ne igerjunk tobbet a valosagnal):
+ *   - a **2FA-bypass** hianya CSAK publikalaskor derul ki (`EOTP` hibakod) — read-only probaval nem;
+ *   - a **lejart** es a **visszavont** token kivulrol egyforman 401;
+ *   - a token **elettartama** nem kerdezheto le.
+ * Ezert a `publishErrorCode` opcionalis bemenet: ha egy publish mar elbukott, az `EOTP` alapjan
+ * ERRE is tudunk hatarozott allapotot mondani.
+ *
+ * A TOKEN ERTEKE SOSEM KERUL A KIMENETBE — sem logba, sem eredmenybe.
+ */
+/** Az npm-token megallapithato allapotai. */
+export declare enum DyNTS_NpmTokenState {
+    /** Nincs beallitva token (se env, se .npmrc). */
+    missing = "missing",
+    /** Van ertek, de nem npm-token alaku — jellemzoen elgepeles / rossz valtozo. */
+    malformed = "malformed",
+    /** A registry elutasitja (401): lejart, visszavont vagy egyszeruen rossz. */
+    invalid = "invalid",
+    /** A token EL (whoami OK), de a vizsgalt scope-hoz/csomaghoz NINCS joga. */
+    noScopeAccess = "no-scope-access",
+    /** A token el es olvas, de publikalasra nincs joga (2FA-bypass hianya — `EOTP`). */
+    missingPublishRight = "missing-publish-right",
+    /** Minden vizsgalt kepesseg rendben. */
+    ok = "ok",
+    /** A proba maga nem futott le (halozat/timeout) — NEM azonos azzal, hogy a token rossz. */
+    unknown = "unknown"
+}
+/** A helyi (halozat NELKULI) alak-ellenorzes eredmenye. */
+export declare enum DyNTS_NpmTokenShape {
+    missing = "missing",
+    malformed = "malformed",
+    plausible = "plausible"
+}
+/**
+ * PURE — a token ALAKJANAK ellenorzese, halozat nelkul.
+ *
+ * MIERT KULON LEPES: a "nincs beallitva" es a "rosszul beallitva" eseteket halozat nelkul, azonnal
+ * es egyertelmuen el lehet donteni — ezek a leggyakoribb operatori hibak (ures env-var, idezojelek
+ * bennragadtak, a `//registry…/:_authToken=` PREFIX is bemasolodott).
+ *
+ * Az npm mai token-alakjai `npm_`-mel kezdodnek (classic automation + granular). A regi, prefix
+ * nelkuli UUID-alaku tokenek MEG ervenyesek lehetnek, ezert azokat is `plausible`-nek vesszuk —
+ * inkabb engedunk at egy kesobb 401-et kapo tokent, mint hogy egy jot elutasitsunk.
+ */
+export declare function classifyNpmTokenShape(rawToken: string | undefined | null): DyNTS_NpmTokenShape;
+/**
+ * Publish-oldali npm-hibakodok, amik ELO token mellett JOGOSULTSAG-hianyt jelentenek.
+ *
+ * A lista SZANDEKOSAN tartalmazza az `E404`-et: az npm a `PUT` (publish) kerest is 404-gyel
+ * utasitja el, ha a tokennek nincs irasi joga a csomagra. Elo token mellett ez SOSEM jelentheti,
+ * hogy a csomag hianyzik — hiszen olvasni tudtuk.
+ */
+export declare const PUBLISH_RIGHT_ERROR_CODES: string[];
+/** A halozati proba nyers bemenete (a `classifyNpmTokenProbe` szamara). */
+export interface DyNTS_NpmTokenProbe_Input {
+    /** A `/-/whoami` HTTP-statusza. `null`, ha a hivas el sem jutott a szerverig. */
+    whoamiStatus: number | null;
+    /** Egy SCOPE-olt (jellemzoen privat) csomag metaadat-lekeresenek statusza; `undefined` = nem mertuk. */
+    scopedPackageStatus?: number;
+    /** Ha egy publish MAR elbukott, annak npm-hibakodja (pl. `EOTP`, `E403`); `undefined` = nem mertuk. */
+    publishErrorCode?: string;
+}
+/**
+ * PURE — a halozati valaszokbol allapot.
+ *
+ * A sorrend SZANDEKOS: a `whoami` az egyetlen csomag-fuggetlen jel, ezert az dont eloszor. Csak
+ * utana ertelmezheto a csomag-szintu 404 — kulonben ugyanaz a 404 jelentene "nincs ilyen csomag"-ot
+ * es "rossz kulcs"-ot is, ami epp a 2026-08-i incidens diagnozisat huzta el.
+ */
+export declare function classifyNpmTokenProbe(input: DyNTS_NpmTokenProbe_Input): DyNTS_NpmTokenState;
+/**
+ * PURE — ember-olvashato magyarazat + a KOVETKEZO LEPES. A puszta allapot-cimke keves: az operator
+ * azt akarja tudni, mit tegyen.
+ */
+export declare function describeNpmTokenState(state: DyNTS_NpmTokenState): string;
+/** A teljes ellenorzes eredmenye. A token ERTEKE sosem szerepel benne. */
+export interface DyNTS_NpmTokenCheck_Result {
+    state: DyNTS_NpmTokenState;
+    /** A `/-/whoami` altal visszaadott felhasznalonev, ha a token ervenyes. */
+    username: string | null;
+    /** Ember-olvashato magyarazat + kovetkezo lepes. */
+    detail: string;
+    /** Amit tenylegesen mertunk (diagnosztikahoz). */
+    probe: DyNTS_NpmTokenProbe_Input;
+}
+/** A `checkNpmToken` bemenete. */
+export interface DyNTS_NpmTokenCheck_Options {
+    /** A vizsgalando token. Ha nincs megadva, a `process.env.NPM_TOKEN`-t hasznaljuk. */
+    token?: string;
+    /** Registry-alap. Default: a publikus npm. */
+    registry?: string;
+    /**
+     * Egy SCOPE-olt csomag, amin a jogosultsagot merjuk (pl. `@futdevpro/cli-dynamo`).
+     * Ha nincs megadva, csak a whoami fut le.
+     */
+    scopedPackage?: string;
+    /** Ha egy publish mar elbukott, annak npm-hibakodja — igy a 2FA-bypass hianya is besorolhato. */
+    publishErrorCode?: string;
+    /** Halozati timeout (ms). Default: 10000. */
+    timeoutMs?: number;
+}
+/**
+ * PURE — token kinyerese egy `.npmrc` TARTALMABOL.
+ *
+ * MIERT KELL: az elso valtozat CSAK a `process.env.NPM_TOKEN`-t nezte, es ezert a sajat
+ * workstationomon `missing`-et adott — HOLOTT az npm ott tokeletesen mukodott, mert a token a
+ * `~/.npmrc`-ben all. Ez HAMIS NEGATIV, es epp a legfontosabb helyeken (runner-kontener, hosztok)
+ * sulna el, ahol a token szinten FAJLBAN van.
+ *
+ * A `.npmrc`-t csak OLVASSUK — letrehozni tilos (flotta-szintu hard rule).
+ */
+export declare function extractTokenFromNpmrc(content: string, registry?: string): string | null;
+/**
+ * A token feloldasa a szokasos helyekrol, PRIORITAS szerint:
+ *   1. explicit parameter, 2. `NPM_TOKEN` env, 3. a felhasznaloi `~/.npmrc`.
+ * Sose dob; ha egyik sincs, ures stringet ad.
+ */
+export declare function resolveNpmToken(explicit: string | undefined, registry: string): string;
+/**
+ * A tenyleges ellenorzes. SOSE dob — a hibat allapotkent adja vissza (a token-ellenorzes nem
+ * buktathat meg semmit, amibe beepitjuk).
+ */
+export declare function checkNpmToken(options?: DyNTS_NpmTokenCheck_Options): Promise<DyNTS_NpmTokenCheck_Result>;
 //# sourceMappingURL=npm-token-check.util.d.ts.map