Návod k použití

1. Vygenerovat token

V dashboardu tokenů vytvoř nový token s odpovídajícím scope:

• package:read — jen instalace
• package:write — jen publish
• package:read+write — instalace i publish

Plaintext token uvidíš jen jednou — hned si ho zkopíruj.

2. Nastavit .npmrc — scope-first

Doporučený režim: per-scope registry. Veřejné balíčky chodí dál přímo na npmjs.org, jen tvůj scope (např. @mujscope/*) jde přes Repoflare.

@mujscope:registry=https://npm.vyvoj.dev/
//npm.vyvoj.dev/:_authToken=<tvuj-token>

Token nedávej do gitu — používej env var nebo per-user ~/.npmrc.

Pokud potřebuješ aby všechny npm requesty šly přes Repoflare (lockdown síť, single firewall pravidlo), viz sekce 5: plný proxy režim.

3. Publish

V kořeni balíčku:

npm publish

Nebo jednorázově proti registry bez úpravy .npmrc:

npm publish --registry=https://npm.vyvoj.dev

Po úspěšném publish se balíček objeví v dashboardu.

4. Install

Pokud máš nastavený registry v .npmrc:

npm install <package-name>

Repoflare neumí pakety, které nemá — pro tyto se request automaticky předá na registry.npmjs.org (fallback proxy).

5. Plný proxy režim

Pokud chceš aby všechny npm requesty (privátní i veřejné) šly přes Repoflare — typicky lockdown síť, jediné povolené pravidlo na firewallu, nebo centrální audit log:

registry=https://npm.vyvoj.dev/
//npm.vyvoj.dev/:_authToken=<tvuj-token>

Repoflare automaticky proxy-uje veřejné balíčky z registry.npmjs.org včetně tarballů — dependency tree resolve i download chodí přes jediný host. První download tarballu cachuje výsledek do R2, další requesty jdou rovnou z cache.

6. Troubleshoot

401 Unauthorized při publish

Chybí nebo špatný _authToken v .npmrc. Ověř že je pro správný host (musí matchovat npm.vyvoj.dev).

403 Forbidden

Token má jen package:read scope, ale snažíš se publish. Vygeneruj token s write scope.

409 Conflict

Verze už existuje. Bump verzi v package.json a publish znova.

npm tě posílá na npmjs.org místo Repoflare

Zkontroluj npm config get registry — má vracet https://npm.vyvoj.dev/.