guford-ui 0.1.0 → 0.2.0

package/bin.mjs

@@ -30,8 +30,9 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const ROOT = resolve(__dirname, '..'); // racine du dépôt guford-ui (mode local)
 const CONFIG_FILE = 'guford-ui.json';
 
-// Base distante par défaut (à adapter après publication : GitHub raw, host statique…).
-const DEFAULT_REMOTE = 'https://raw.githubusercontent.com/bekmarc/guford-ui/main';
+// Dépôt GitHub par défaut (privé → lu via l'API Contents avec token).
+const DEFAULT_REPO = 'bekmarc/guford-ui';
+const DEFAULT_REF = 'main';
 
 // --- couleurs ANSI ---------------------------------------------------------
 const c = {
@@ -48,42 +49,72 @@ function fail(msg) {
   process.exit(1);
 }
 
-// --- source du registry (local FS ou URL distante) -------------------------
+// --- source du registry (local FS | URL statique | API GitHub privée) ------
 /**
- * @param {{registry?: string}} flags
- * @returns {{remote: boolean, base: string}}
+ * Résout la source du registry. 3 modes :
+ *  - 'local'  : fichiers du dépôt (exécution depuis quitus-ui/guford-ui)
+ *  - 'url'    : base HTTP statique (--registry / $GUFORD_UI_REGISTRY), token facultatif
+ *  - 'github' : dépôt GitHub privé via l'API Contents (--repo/--ref + token requis)
  */
 function resolveSource(flags) {
+  const token = flags.token || process.env.GUFORD_UI_TOKEN || process.env.GITHUB_TOKEN;
   const explicit = flags.registry || process.env.GUFORD_UI_REGISTRY;
-  if (explicit) return { remote: true, base: explicit.replace(/\/+$/, '') };
-  if (existsSync(join(ROOT, 'registry.json'))) return { remote: false, base: ROOT };
-  return { remote: true, base: DEFAULT_REMOTE };
+  if (explicit) return { kind: 'url', base: explicit.replace(/\/+$/, ''), token };
+  if (!flags.repo && existsSync(join(ROOT, 'registry.json'))) return { kind: 'local', base: ROOT };
+  return { kind: 'github', repo: flags.repo || DEFAULT_REPO, ref: flags.ref || DEFAULT_REF, token };
+}
+
+function sourceUrl(source, rel) {
+  if (source.kind === 'url') return `${source.base}/${rel}`;
+  // GitHub Contents API : renvoie le contenu brut (texte + binaire) avec Accept: raw
+  return `https://api.github.com/repos/${source.repo}/contents/${rel}?ref=${source.ref}`;
+}
+
+function sourceHeaders(source) {
+  const h = { 'User-Agent': 'guford-ui-cli' };
+  if (source.kind === 'github') {
+    if (!source.token)
+      fail(
+        'Dépôt privé : un token est requis.\n' +
+          '  → crée un PAT GitHub (Contents: read) puis:  set GUFORD_UI_TOKEN=<token>\n' +
+          '  (ou passe --token <token>, ou utilise --registry <url-publique>)',
+      );
+    h.Authorization = `Bearer ${source.token}`;
+    h.Accept = 'application/vnd.github.raw';
+  } else if (source.token) {
+    h.Authorization = `Bearer ${source.token}`;
+  }
+  return h;
+}
+
+async function fetchEntry(source, rel) {
+  const url = sourceUrl(source, rel);
+  const res = await fetch(url, { headers: sourceHeaders(source) });
+  if (!res.ok) {
+    const hint = res.status === 404 ? ' (introuvable, ou token sans accès au dépôt privé)' : '';
+    fail(`Téléchargement échoué (${res.status})${hint} : ${url}`);
+  }
+  return Buffer.from(await res.arrayBuffer());
 }
 
 /** Lit un fichier texte du registry (chemin relatif à la racine, ex: 'registry.json'). */
 async function readText(source, rel) {
-  if (source.remote) {
-    const url = `${source.base}/${rel}`;
-    const res = await fetch(url);
-    if (!res.ok) fail(`Téléchargement échoué (${res.status}) : ${url}`);
-    return await res.text();
+  if (source.kind === 'local') {
+    const path = join(source.base, rel);
+    if (!existsSync(path)) fail(`Fichier introuvable: ${path}`);
+    return readFileSync(path, 'utf8');
   }
-  const path = join(source.base, rel);
-  if (!existsSync(path)) fail(`Fichier introuvable: ${path}`);
-  return readFileSync(path, 'utf8');
+  return (await fetchEntry(source, rel)).toString('utf8');
 }
 
 /** Lit un fichier (texte ou binaire) du registry → Buffer. */
 async function readBuffer(source, rel) {
-  if (source.remote) {
-    const url = `${source.base}/${rel}`;
-    const res = await fetch(url);
-    if (!res.ok) fail(`Téléchargement échoué (${res.status}) : ${url}`);
-    return Buffer.from(await res.arrayBuffer());
+  if (source.kind === 'local') {
+    const path = join(source.base, rel);
+    if (!existsSync(path)) fail(`Fichier introuvable: ${path}`);
+    return readFileSync(path);
   }
-  const path = join(source.base, rel);
-  if (!existsSync(path)) fail(`Fichier introuvable: ${path}`);
-  return readFileSync(path);
+  return await fetchEntry(source, rel);
 }
 
 async function loadRegistry(source) {
@@ -122,7 +153,10 @@ function loadProjectConfig(cwd) {
 // --- parseur d'arguments ---------------------------------------------------
 function parseArgs(argv) {
   const positionals = [];
-  const flags = { cwd: '.', dir: undefined, overwrite: false, dryRun: false, registry: undefined };
+  const flags = {
+    cwd: '.', dir: undefined, overwrite: false, dryRun: false,
+    registry: undefined, token: undefined, repo: undefined, ref: undefined,
+  };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === '--overwrite') flags.overwrite = true;
@@ -130,6 +164,9 @@ function parseArgs(argv) {
     else if (a === '--cwd') flags.cwd = argv[++i];
     else if (a === '--dir') flags.dir = argv[++i];
     else if (a === '--registry') flags.registry = argv[++i];
+    else if (a === '--token') flags.token = argv[++i];
+    else if (a === '--repo') flags.repo = argv[++i];
+    else if (a === '--ref') flags.ref = argv[++i];
     else if (a.startsWith('--')) fail(`Option inconnue: ${a}`);
     else positionals.push(a);
   }
@@ -137,7 +174,9 @@ function parseArgs(argv) {
 }
 
 function sourceLabel(source) {
-  return source.remote ? c.dim(`(registry distant: ${source.base})`) : c.dim('(registry local)');
+  if (source.kind === 'local') return c.dim('(registry local)');
+  if (source.kind === 'url') return c.dim(`(registry: ${source.base})`);
+  return c.dim(`(registry GitHub: ${source.repo}@${source.ref})`);
 }
 
 // --- commandes -------------------------------------------------------------
@@ -321,9 +360,15 @@ function help() {
   ${c.cyan('Options:')}
     --cwd <path>         Projet cible (défaut: .)
     --dir <path>         Racine d'installation (défaut: guford-ui.json puis src)
-    --registry <url>     Base distante du registry (sinon $GUFORD_UI_REGISTRY, sinon local)
+    --registry <url>     Base HTTP statique du registry (sinon $GUFORD_UI_REGISTRY)
+    --repo <owner/repo>  Dépôt GitHub (défaut: ${DEFAULT_REPO})
+    --ref <branch|tag>   Réf GitHub (défaut: ${DEFAULT_REF}) — pin sur un tag pour reproductibilité
+    --token <token>      Token GitHub pour dépôt privé (sinon $GUFORD_UI_TOKEN / $GITHUB_TOKEN)
     --overwrite          Écrase les fichiers existants
     --dry-run            Simule sans écrire
+
+  ${c.cyan('Dépôt privé:')} crée un PAT GitHub (Contents: read), puis
+    ${c.dim('set GUFORD_UI_TOKEN=<token>   # Windows (cmd)   |   $env:GUFORD_UI_TOKEN="<token>" (PowerShell)')}
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guford-ui",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI pour installer les composants du registry guford-ui (façon shadcn).",
   "type": "module",
   "bin": {