komplian 0.4.0 → 0.4.1

package/README.md

@@ -10,17 +10,25 @@
 
 1. En [Postman](https://postman.com) usa una cuenta con email **`@komplian.com`** (o añade ese email a tu perfil).
 2. Crea una **API key**: Settings → **API keys** → Generate.
-3. En la terminal:
+3. **Una vez por máquina** (guarda la clave en `~/.komplian/postman-api-key`; no hace falta `export` después):
+
+```bash
+npx komplian postman login
+```
+
+4. Cuando quieras sincronizar la colección:
 
 ```bash
-export POSTMAN_API_KEY=pmak-…
 npx komplian postman --yes
 ```
 
-El comando llama a `GET https://api.getpostman.com/me` y **solo continúa** si el email de la cuenta es `@komplian.com`. Crea la colección **Komplian API** (carpetas como en el workspace interno), los entornos **Komplian — Local Dev** y **Komplian — Production** (variables `baseUrl`, `apiKey`, `adminApiKey`, IDs, etc.), y deja copia en `./komplian-postman/*.json` por si hace falta importar a mano.
+Opcional: `export POSTMAN_API_KEY=…` solo para la sesión actual (tiene prioridad sobre el archivo).
+
+El comando llama a `GET https://api.getpostman.com/me` y **solo continúa** si el email de la cuenta es `@komplian.com`. Crea la colección **Komplian API**, los entornos **Komplian — Local Dev** y **Komplian — Production**, y deja copia en `./komplian-postman/*.json`.
 
 - Solo exportar archivos (sin subir por API): `npx komplian postman --yes --export-only`
-- Otro workspace: `POSTMAN_WORKSPACE_ID=<id>` (si no, se usa un workspace por defecto con permiso de escritura)
+- Otro workspace: `POSTMAN_WORKSPACE_ID=<id>`
+- Ruta alternativa del archivo de clave: `KOMPLIAN_POSTMAN_KEY_FILE`
 
 No OAuth App registration — `gh` uses GitHub’s built-in flow. **Default workspace:** current working directory (`process.cwd()`), not `~/komplian`. Pass a path as last argument to clone elsewhere.  
 **Dependencies:** repos with `package-lock.json` use **`npm ci`** (does not modify the lockfile, so no spurious git changes). Repos without a lockfile use **`npm install --no-package-lock`** so onboarding does not create a new `package-lock.json`. Yarn / pnpm repos use frozen lock installs when `yarn` / `pnpm` is on PATH. Unless `KOMPLIAN_NPM_AUDIT=1`, npm runs with `--no-audit --no-fund`.

package/komplian-onboard.mjs

@@ -396,7 +396,8 @@ function npmInstallEach(workspace) {
 function usage() {
   log(`Uso: komplian onboard [opciones] [carpeta]  |  komplian postman [opciones]`);
   log(`  npx komplian onboard --yes`);
-  log(`  npx komplian postman --yes   ${c.dim}(POSTMAN_API_KEY + email @komplian.com)${c.reset}`);
+  log(`  npx komplian postman login   ${c.dim}(una vez · guarda API key)${c.reset}`);
+  log(`  npx komplian postman --yes    ${c.dim}(email @komplian.com)${c.reset}`);
   log(``);
   log(`  Antes (una vez): gh auth login -h github.com -s repo -s read:org -w`);
   log(`  Requisitos: Node 18+, git, GitHub CLI (gh)`);

package/komplian-postman.mjs

@@ -2,17 +2,23 @@
 /**
  * Komplian Postman — API key + email @komplian.com (Postman /me), luego colección + entornos.
  *
- * Requisitos: Node 18+, variable POSTMAN_API_KEY (Postman → Settings → API keys)
+ * Requisitos: Node 18+. Primera vez: npx komplian postman login
  *
- *   export POSTMAN_API_KEY=pmak-...
- *   npx komplian postman --yes
- *
- * Opcional: POSTMAN_WORKSPACE_ID (si no, usa el primer workspace con permiso de escritura)
- * Opcional: KOMPLIAN_EMAIL_DOMAIN=komplian.com (solo para pruebas internas del script)
+ * Clave: POSTMAN_API_KEY o ~/.komplian/postman-api-key (npx komplian postman login)
+ * Opcional: POSTMAN_WORKSPACE_ID, KOMPLIAN_EMAIL_DOMAIN, KOMPLIAN_POSTMAN_KEY_FILE
  */
 
-import { writeFileSync, mkdirSync } from "node:fs";
+import {
+  writeFileSync,
+  mkdirSync,
+  readFileSync,
+  existsSync,
+  chmodSync,
+} from "node:fs";
 import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { stdin as input, stdout as output } from "node:process";
+import { createInterface } from "node:readline/promises";
 
 const POSTMAN_API = "https://api.getpostman.com";
 
@@ -30,6 +36,40 @@ function log(s = "") {
   console.log(s);
 }
 
+function defaultKeyPath() {
+  const override = process.env.KOMPLIAN_POSTMAN_KEY_FILE?.trim();
+  if (override) return resolve(override);
+  return join(homedir(), ".komplian", "postman-api-key");
+}
+
+/**
+ * Orden: POSTMAN_API_KEY → ~/.komplian/postman-api-key (o KOMPLIAN_POSTMAN_KEY_FILE).
+ */
+function resolveApiKey() {
+  const env = process.env.POSTMAN_API_KEY?.trim();
+  if (env) return { key: env, source: "POSTMAN_API_KEY" };
+  const path = defaultKeyPath();
+  if (existsSync(path)) {
+    const k = readFileSync(path, "utf8").trim();
+    if (k) return { key: k, source: path };
+  }
+  return { key: "", source: null };
+}
+
+function printMissingKeyHelp() {
+  log(`${c.red}✗${c.reset} No hay API key de Postman.`);
+  log(``);
+  log(`  ${c.bold}Una vez por máquina:${c.reset}`);
+  log(`    ${c.cyan}npx komplian postman login${c.reset}`);
+  log(`    (pega la clave de Postman → Settings → API keys → Generate)`);
+  log(``);
+  log(`  ${c.dim}O en la sesión actual: export POSTMAN_API_KEY=…${c.reset}`);
+  log(
+    `${c.dim}  Archivo manual: ${defaultKeyPath()}${c.reset}`
+  );
+  process.exit(1);
+}
+
 function headers(apiKey) {
   return {
     "X-API-Key": apiKey,
@@ -305,7 +345,7 @@ async function verifyKomplianEmail(apiKey, domain) {
   const { ok, status, body } = await pmFetch(apiKey, "/me");
   if (!ok) {
     log(
-      `${c.red}✗${c.reset} POSTMAN_API_KEY inválida o sin acceso (${status}).`
+      `${c.red}✗${c.reset} API key de Postman inválida o sin acceso (${status}).`
     );
     process.exit(1);
   }
@@ -363,33 +403,126 @@ function parseArgs(argv) {
   return out;
 }
 
+function parseLoginArgs(argv) {
+  const out = { help: false };
+  for (const a of argv) {
+    if (a === "-h" || a === "--help") out.help = true;
+    else if (a.startsWith("-")) {
+      log(`${c.red}✗${c.reset} Opción desconocida: ${a}`);
+      process.exit(1);
+    }
+  }
+  return out;
+}
+
 function usage() {
-  log(`Uso: komplian postman [opciones]`);
-  log(`  ${c.dim}POSTMAN_API_KEY${c.reset}   Obligatoria (Postman → Settings → API keys)`);
-  log(`  ${c.dim}Dominio email${c.reset}      Solo cuentas @komplian.com (verificado vía GET /me)`);
+  log(`Uso: komplian postman [opciones]  |  komplian postman login`);
+  log(`  Clave: ${c.dim}POSTMAN_API_KEY${c.reset} o archivo ${c.dim}~/.komplian/postman-api-key${c.reset} (véase ${c.cyan}postman login${c.reset})`);
+  log(`  Dominio email: solo @komplian.com (GET /me)`);
   log(``);
-  log(`  -y, --yes           Sin confirmaciones interactivas`);
+  log(`  -y, --yes           Sin prompts extra`);
   log(`  --export-only       Solo escribe JSON en disco (no llama a la API de Postman)`);
   log(`  --out <dir>         Carpeta para export (por defecto: ./komplian-postman)`);
   log(`  -h, --help`);
   log(``);
-  log(`  Opcional: POSTMAN_WORKSPACE_ID, KOMPLIAN_EMAIL_DOMAIN (defecto: komplian.com)`);
+  log(`  Opcional: POSTMAN_WORKSPACE_ID, KOMPLIAN_EMAIL_DOMAIN, KOMPLIAN_POSTMAN_KEY_FILE`);
+}
+
+function usageLogin() {
+  log(`Uso: komplian postman login`);
+  log(`  Guarda la API key de Postman en ${c.dim}~/.komplian/postman-api-key${c.reset} (permiso 600).`);
+  log(`  Tras esto: ${c.cyan}npx komplian postman --yes${c.reset} sin exportar variables.`);
+  log(``);
+  log(`  Postman → Settings (avatar) → API keys → Generate`);
+}
+
+async function promptApiKey() {
+  if (input.isTTY) {
+    const rl = createInterface({ input, output });
+    const line = await rl.question(
+      `${c.cyan}Pega tu Postman API key${c.reset} (Settings → API keys): `
+    );
+    rl.close();
+    return line.trim();
+  }
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    input.on("data", (d) => chunks.push(d));
+    input.on("end", () => {
+      resolve(Buffer.concat(chunks).toString("utf8").trim());
+    });
+    input.on("error", reject);
+  });
+}
+
+async function runPostmanLogin(argv) {
+  const la = parseLoginArgs(argv);
+  if (la.help) {
+    usageLogin();
+    return;
+  }
+
+  log(`${c.cyan}━━ Postman login (Komplian) ━━${c.reset}`);
+  log(
+    `${c.dim}Cuenta con email @komplian.com. Genera la clave en Postman → Settings → API keys.${c.reset}`
+  );
+  log("");
+
+  const domain = (process.env.KOMPLIAN_EMAIL_DOMAIN || "komplian.com").trim();
+  const keyPath = defaultKeyPath();
+
+  let apiKey = await promptApiKey();
+  if (!apiKey) {
+    log(`${c.red}✗${c.reset} Clave vacía.`);
+    process.exit(1);
+  }
+
+  await verifyKomplianEmail(apiKey, domain);
+
+  mkdirSync(join(homedir(), ".komplian"), { recursive: true });
+  writeFileSync(keyPath, `${apiKey}\n`, { encoding: "utf8", mode: 0o600 });
+  try {
+    chmodSync(keyPath, 0o600);
+  } catch {
+    /* Windows puede ignorar chmod */
+  }
+
+  log("");
+  log(
+    `${c.green}✓${c.reset} Guardada en ${c.bold}${keyPath}${c.reset} (solo tu usuario).`
+  );
+  log(
+    `${c.dim}  Siguiente: ${c.reset}${c.cyan}npx komplian postman --yes${c.reset}`
+  );
+}
+
+function normalizePostmanArgv(argv) {
+  const a = [...argv];
+  if (a[0] === "login") {
+    return { mode: "login", rest: a.slice(1) };
+  }
+  return { mode: "sync", rest: a };
 }
 
 export async function runPostman(argv) {
-  const args = parseArgs(argv);
+  const { mode, rest } = normalizePostmanArgv(argv);
+  if (mode === "login") {
+    await runPostmanLogin(rest);
+    return;
+  }
+
+  const args = parseArgs(rest);
   if (args.help) {
     usage();
     return;
   }
 
-  const apiKey = process.env.POSTMAN_API_KEY?.trim();
+  const { key: apiKey, source } = resolveApiKey();
   if (!apiKey) {
-    log(`${c.red}✗${c.reset} Falta ${c.bold}POSTMAN_API_KEY${c.reset} en el entorno.`);
-    log(
-      `${c.dim}  Postman → Settings (avatar) → API keys → Generate.${c.reset}`
-    );
-    process.exit(1);
+    printMissingKeyHelp();
+  }
+  if (source && source !== "POSTMAN_API_KEY") {
+    log(`${c.dim}→ API key: ${source}${c.reset}`);
   }
 
   const domain = (process.env.KOMPLIAN_EMAIL_DOMAIN || "komplian.com").trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "komplian",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Komplian developer workspace: GitHub clone (onboard) + Postman collection/environments (postman). Node 18+.",
   "type": "module",
   "engines": {