primocode 8.27.0 → 8.30.0

package/lib/instalar-app.js

@@ -0,0 +1,231 @@
+/**
+ * instalar-app.js — o PrimoCode como aplicativo do sistema.
+ *
+ *   "Ele está abrindo no navegador, pode ser — só que eu gostaria que fosse um
+ *    aplicativo mesmo desktop, tenha um ícone, e o ícone tem que ser o mascote
+ *    do PrimoCode."
+ *
+ * ── O QUE ESTE ARQUIVO ENTREGA, E O QUE ELE NÃO ENTREGA ──────────────────
+ * Ele entrega o que faz uma coisa SER um aplicativo para quem usa: entrada no
+ * Launchpad e no Dock do Mac, no menu Iniciar e na barra de tarefas do Windows,
+ * no menu de aplicativos do Linux. Ícone próprio, nome próprio, abre com dois
+ * cliques, aparece no Spotlight e no Alt-Tab com a cara dele.
+ *
+ * O que ele NÃO faz é trocar o motor da janela. Dentro, continua sendo o
+ * Chromium da máquina em modo `--app`, sem barra de endereço e sem abas — é o
+ * mesmo desenho de sempre. Trocar isso por uma janela nativa exigiria Electron
+ * ou Tauri: um download de centenas de MB, uma cadeia de compilação por
+ * sistema e assinatura de código para o macOS e o Windows não recusarem o
+ * binário. Isso derruba a promessa de "já instala junto com o npm", que foi
+ * pedida na mesma frase.
+ *
+ * Está escrito aqui porque é a diferença que importa se um dia alguém quiser
+ * mudar: o obstáculo não é técnico, é o tamanho da instalação.
+ *
+ * ── POR QUE NÃO NO `postinstall` ─────────────────────────────────────────
+ * Um `npm i -g` que cria pasta em ~/Applications e escreve no menu Iniciar sem
+ * ninguém pedir é um instalador se comportando mal. Quem quiser o aplicativo
+ * digita `/app --instalar` uma vez, e o `/app` sozinho continua abrindo a
+ * janela sem instalar nada.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execFile, execFileSync } = require('child_process');
+
+const icone = require('./icone.js');
+
+const NOME = 'PrimoCode';
+const CASA = path.join(os.homedir(), '.primocode');
+
+function escrever(destino, dados) {
+    fs.mkdirSync(path.dirname(destino), { recursive: true });
+    fs.writeFileSync(destino, dados);
+}
+
+/* O caminho do Node e o do CLI, absolutos.
+ *
+ * Aplicativo aberto pelo Finder ou pelo menu Iniciar NÃO herda o PATH do
+ * terminal: o `.zshrc` não roda, e num Mac com Node do Homebrew ou do nvm o
+ * comando `primo` simplesmente não existe para quem clicou no ícone. O
+ * aplicativo abria e fechava na hora, sem dizer nada. Com os dois caminhos
+ * escritos no lançador, ele funciona vindo de qualquer lugar. */
+function caminhos() {
+    return {
+        node: process.execPath,
+        cli: path.resolve(__dirname, '..', 'bin', 'primocode.js'),
+    };
+}
+
+// ── macOS ────────────────────────────────────────────────────────────────
+
+const PLIST = (versao) => `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key><string>${NOME}</string>
+  <key>CFBundleDisplayName</key><string>${NOME}</string>
+  <key>CFBundleIdentifier</key><string>ai.conectaprimo.primocode</string>
+  <key>CFBundleVersion</key><string>${versao}</string>
+  <key>CFBundleShortVersionString</key><string>${versao}</string>
+  <key>CFBundlePackageType</key><string>APPL</string>
+  <key>CFBundleExecutable</key><string>${NOME}</string>
+  <key>CFBundleIconFile</key><string>${NOME}</string>
+  <key>NSHighResolutionCapable</key><true/>
+  <!-- Sem isto o ícone do Dock vira um foguete genérico e o app aparece com
+       o nome do processo. "LSUIElement" NÃO entra: com ele o aplicativo some
+       do Dock, e o Dock é metade do que foi pedido aqui.
+
+       (Aspas e não acento grave neste comentário de propósito: ele mora dentro
+       de um template literal, e um acento grave ali FECHA a string — o erro
+       sai vinte linhas abaixo, apontando para o lugar errado.) -->
+  <key>LSMinimumSystemVersion</key><string>10.15</string>
+</dict>
+</plist>
+`;
+
+function instalarMac(versao) {
+    const { node, cli } = caminhos();
+    const raiz = path.join(os.homedir(), 'Applications', `${NOME}.app`);
+    const conteudo = path.join(raiz, 'Contents');
+
+    escrever(path.join(conteudo, 'Info.plist'), PLIST(versao));
+    escrever(path.join(conteudo, 'Resources', `${NOME}.icns`), icone.icns());
+
+    /* O lançador. `exec` no fim para o processo do Node HERDAR o lugar do
+       script: sem ele o shell fica de pé só esperando, e o macOS mostra dois
+       processos no monitor de atividade para um aplicativo só. */
+    const bin = path.join(conteudo, 'MacOS', NOME);
+    escrever(bin, `#!/bin/sh
+# Gerado pelo PrimoCode (/app --instalar). Não edite: rode o comando de novo.
+exec ${JSON.stringify(node)} ${JSON.stringify(cli)} --app "$@"
+`);
+    fs.chmodSync(bin, 0o755);
+
+    /* O macOS guarda em cache o ícone e o nome pelo caminho do bundle. Sem
+       tocar na pasta, um app reinstalado continua mostrando o ícone velho até
+       o sistema reiniciar — o que parece, de fora, o comando não ter
+       funcionado. `touch` na pasta invalida esse cache. */
+    try { fs.utimesSync(raiz, new Date(), new Date()); } catch {}
+
+    return { ok: true, caminho: raiz, onde: 'Launchpad e pasta Aplicativos' };
+}
+
+// ── Windows ──────────────────────────────────────────────────────────────
+
+/* O atalho do Windows (.lnk) é um formato binário com estrutura própria. Em
+ * vez de montá-lo byte a byte, quem o escreve é o próprio Windows, pelo
+ * WScript.Shell — que existe em toda instalação desde sempre e é a API que os
+ * instaladores usam. */
+function instalarWindows(versao) {
+    const { node, cli } = caminhos();
+    const recursos = path.join(CASA, 'app');
+    const ico = path.join(recursos, 'primocode.ico');
+    escrever(ico, icone.ico());
+
+    /* Um .cmd abriria uma janela preta de console junto do aplicativo. O .vbs
+       com `Run ..., 0` lança o Node com a janela escondida — é o que faz o
+       aplicativo abrir só a janela dele, como qualquer programa. */
+    const vbs = path.join(recursos, 'primocode.vbs');
+    escrever(vbs, `' Gerado pelo PrimoCode (/app --instalar). Não edite: rode o comando de novo.\r
+Set sh = CreateObject("WScript.Shell")\r
+sh.Run """${node}"" ""${cli}"" --app", 0, False\r
+`);
+
+    const menu = path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'),
+        'Microsoft', 'Windows', 'Start Menu', 'Programs', `${NOME}.lnk`);
+    const area = path.join(os.homedir(), 'Desktop', `${NOME}.lnk`);
+
+    const ps = [
+        '$w = New-Object -ComObject WScript.Shell',
+        ...[menu, area].map((alvo) => [
+            `$s = $w.CreateShortcut(${JSON.stringify(alvo)})`,
+            '$s.TargetPath = "wscript.exe"',
+            `$s.Arguments = '"${vbs}"'`,
+            `$s.IconLocation = ${JSON.stringify(ico)}`,
+            `$s.Description = "PrimoCode ${versao}"`,
+            `$s.WorkingDirectory = ${JSON.stringify(path.dirname(cli))}`,
+            '$s.Save()',
+        ].join('; ')),
+    ].join('; ');
+
+    try {
+        fs.mkdirSync(path.dirname(menu), { recursive: true });
+        execFileSync('powershell', ['-NoProfile', '-NonInteractive', '-Command', ps],
+            { stdio: 'ignore', timeout: 30000 });
+    } catch (e) {
+        return { ok: false, error: `não consegui criar o atalho: ${e.message}` };
+    }
+    return { ok: true, caminho: menu, onde: 'menu Iniciar e Área de Trabalho' };
+}
+
+// ── Linux ────────────────────────────────────────────────────────────────
+
+function instalarLinux(versao) {
+    const { node, cli } = caminhos();
+    const icones = path.join(os.homedir(), '.local', 'share', 'icons', 'hicolor');
+    for (const t of [16, 32, 48, 64, 128, 256, 512]) {
+        escrever(path.join(icones, `${t}x${t}`, 'apps', 'primocode.png'), icone.png(t));
+    }
+    const arquivo = path.join(os.homedir(), '.local', 'share', 'applications', 'primocode.desktop');
+    escrever(arquivo, `[Desktop Entry]
+Type=Application
+Name=${NOME}
+Comment=Agente de engenharia em português
+Exec=${node} ${cli} --app
+Icon=primocode
+Terminal=false
+Categories=Development;Utility;
+StartupWMClass=primocode
+X-PrimoCode-Version=${versao}
+`);
+    fs.chmodSync(arquivo, 0o755);
+    // Sem atualizar o banco, o menu só mostra o aplicativo na sessão seguinte.
+    try {
+        execFileSync('update-desktop-database', [path.dirname(arquivo)],
+            { stdio: 'ignore', timeout: 15000 });
+    } catch { /* nem toda distribuição tem, e a entrada funciona sem */ }
+    return { ok: true, caminho: arquivo, onde: 'menu de aplicativos' };
+}
+
+// ── porta única ──────────────────────────────────────────────────────────
+
+function instalar(versao) {
+    try {
+        const p = os.platform();
+        if (p === 'darwin') return instalarMac(versao);
+        if (p === 'win32') return instalarWindows(versao);
+        return instalarLinux(versao);
+    } catch (e) {
+        return { ok: false, error: e.message };
+    }
+}
+
+/** Já instalado? Serve para o /app oferecer a instalação uma vez só. */
+function instalado() {
+    const p = os.platform();
+    const alvo = p === 'darwin'
+        ? path.join(os.homedir(), 'Applications', `${NOME}.app`)
+        : p === 'win32'
+            ? path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'),
+                'Microsoft', 'Windows', 'Start Menu', 'Programs', `${NOME}.lnk`)
+            : path.join(os.homedir(), '.local', 'share', 'applications', 'primocode.desktop');
+    try { return fs.existsSync(alvo) ? alvo : null; } catch { return null; }
+}
+
+function desinstalar() {
+    const alvo = instalado();
+    if (!alvo) return { ok: true, jaSaiu: true };
+    try {
+        fs.rmSync(alvo, { recursive: true, force: true });
+        if (os.platform() === 'win32') {
+            try { fs.rmSync(path.join(os.homedir(), 'Desktop', `${NOME}.lnk`), { force: true }); } catch {}
+        }
+        return { ok: true, caminho: alvo };
+    } catch (e) { return { ok: false, error: e.message }; }
+}
+
+module.exports = { instalar, instalado, desinstalar, NOME };