@glassnote/client 2.4.15 → 2.4.16

package/INSTALACION.md

@@ -67,11 +67,18 @@ curl -fsSL https://glassnote.intermark.ec/install.sh | sh -s -- \
 ```
 
 ```powershell
-# Windows
+# Windows — con parámetros: `[scriptblock]` es lo que deja pasárselos al script bajado
 & ([scriptblock]::Create((irm https://glassnote.intermark.ec/install.ps1))) `
   -OrgId 55 -ApiKey <clave> -DeviceName 'Caja 01' -UserName 'Santiago'
 ```
 
+```powershell
+# Windows — con variables de entorno: `irm | iex` no deja pasar parámetros, pero el
+# cliente lee las variables (quedan puestas en esa ventana de PowerShell)
+$env:GLASSNOTE_ORG_ID='55'; $env:GLASSNOTE_API_KEY='<clave>'; $env:GLASSNOTE_DEVICE_NAME='Caja 01'; $env:GLASSNOTE_USER_NAME='Santiago'
+irm https://glassnote.intermark.ec/install.ps1 | iex
+```
+
 | bandera | variable de entorno | por defecto |
 |---|---|---|
 | `--org-id` | `GLASSNOTE_ORG_ID` | — (obligatoria) |
@@ -84,6 +91,115 @@ curl -fsSL https://glassnote.intermark.ec/install.sh | sh -s -- \
 Las variables de entorno existen porque un despliegue por GPO o por MDM muchas veces no
 puede pasar argumentos pero sí poner entorno.
 
+### SCCM, Intune y GPO: el cliente es por usuario
+
+El ejecutable, los datos, el token y el autoarranque viven en el perfil de quien instala.
+Es el diseño: en GlassNote un dispositivo es un usuario en un equipo. Dos usuarios en la
+misma máquina son dos dispositivos en el tablero, cada uno con su `device-id`, y cada
+cliente corre mientras su usuario tiene la sesión abierta.
+
+Estas herramientas suelen correr los scripts como **SYSTEM**, y un cliente instalado así
+quedaría en el perfil de SYSTEM, donde nadie lo ve.
+
+**Lo primero es pedirle a la herramienta que corra en la sesión del usuario:**
+
+| herramienta | cómo |
+|---|---|
+| SCCM, Application | *Installation behavior: Install for user*, desplegada a una colección de usuarios |
+| SCCM, Package/Program | *Program can run: Only when a user is logged on* y *Run mode: Run with user's rights*; sirve con colecciones de equipos |
+| Intune, Win32 app | *Install behavior: User* |
+| Intune, script de PowerShell | *Run this script using the logged on credentials: Yes* |
+| GPO | script de inicio de sesión en *User Configuration*, no de arranque en *Computer Configuration* |
+
+**Cuando no se puede** —*Run Scripts* de SCCM corre siempre como SYSTEM, igual que una
+Application con *Install for system*— el instalador lo detecta y no instala en SYSTEM:
+
+1. busca al usuario con sesión iniciada (el dueño de `explorer.exe`);
+2. deja el instalador en el `%TEMP%` de ese usuario y lo corre con una tarea programada de
+   un solo uso, en su sesión y con sus permisos;
+3. espera a que termine, muestra su salida y sale con su código;
+4. borra la tarea y la carpeta.
+
+El comando es el mismo en los dos casos. Las variables de entorno y los parámetros llegan
+a la sesión del usuario; la API key viaja como variable de entorno, nunca en una línea de
+comandos, y el script que la lleva se borra al arrancar.
+
+```powershell
+# el mismo script para todo el parque
+$env:GLASSNOTE_ORG_ID  = '<id de la organización>'
+$env:GLASSNOTE_API_KEY = '<clave>'
+irm https://glassnote.intermark.ec/install.ps1 | iex
+```
+
+Sin `GLASSNOTE_DEVICE_NAME` ni `GLASSNOTE_USER_NAME`: cada equipo toma su hostname y el
+usuario de la sesión. Fijos en un despliegue masivo, todos los equipos quedan con el mismo
+nombre.
+
+Límites del camino por SYSTEM:
+
+- **Sin nadie con sesión iniciada no instala** y sale con código 1. En una Application,
+  *Only when a user is logged on*.
+- **Instala para el usuario con sesión**, el primero que encuentra. Otro usuario del mismo
+  equipo es otro dispositivo y necesita su propia instalación.
+- ***Run Scripts* corta por timeout** (60 s por defecto) y la primera instalación tarda más
+  (baja electron). Si corta, la instalación sigue en la sesión del usuario, pero SCCM no
+  ve el resultado. Hay que subir el timeout.
+- El `out.log` de la instalación queda tomado por el cliente, que hereda esa salida, hasta
+  que se cierra. La carpeta `glassnote-install-*` se limpia en la siguiente instalación.
+
+Para desinstalar, también como SYSTEM, el mismo script con `-Uninstall`:
+
+```powershell
+& ([scriptblock]::Create((irm https://glassnote.intermark.ec/install.ps1))) -Uninstall
+```
+
+Cierra el cliente, quita el autoarranque y el PATH, y borra `%USERPROFILE%\.glassnote`.
+**No toca `%APPDATA%\glassnote`**: la identidad del equipo (`device-id`), la configuración
+y el token se conservan, así que al reinstalar es el mismo dispositivo en el tablero. Si el
+node que corre la desinstalación vive dentro de `.glassnote` (el que bajó el instalador),
+esa carpeta la borra un proceso aparte unos segundos después, porque Windows no deja borrar
+un ejecutable en uso.
+
+### Dónde queda cada cosa en Windows
+
+| | ruta |
+|---|---|
+| paquete y `electron.exe` | `%USERPROFILE%\.glassnote\npm\node_modules\@glassnote\client` |
+| comando `glassnote` | `%USERPROFILE%\.glassnote\npm\glassnote.cmd` |
+| Node bajado por el instalador, si no había | `%USERPROFILE%\.glassnote\node-v20.18.1-win-x64` |
+| configuración y token | `%APPDATA%\glassnote\.glassnote` |
+| identidad del equipo | `%APPDATA%\glassnote\device-id` |
+| logs: uno por día, se borran a los 30 días | `%APPDATA%\glassnote\logs` |
+| renderer bajado en caliente | `%APPDATA%\glassnote\renderer` |
+| volcados de crash | `%APPDATA%\@glassnote\client\Crashpad` |
+| autoarranque | `%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\glassnote.lnk` |
+
+### Auto-actualización
+
+Las dos corren como el usuario y sin administrador, así que siguen funcionando aunque la
+instalación la haya lanzado SYSTEM.
+
+- **Cliente**: cada hora pregunta a `registry.npmjs.org` por la versión `latest`, o por
+  `desiredVersion` si está puesta. Si hay otra, lanza un ayudante con un node de fuera
+  del paquete, la app se cierra, el ayudante corre `npm install -g --prefix
+  %USERPROFILE%\.glassnote\npm` y la vuelve a abrir. La salida va al log del día. Si
+  falla, no reintenta hasta el siguiente chequeo.
+- **Renderer**: a los 10 s de arrancar y después cada hora mira `version_renderer.txt` en el
+  bucket de S3 y baja el zip a `%APPDATA%\glassnote\renderer`. No toca el binario.
+
+Salidas a internet que necesita el equipo: `registry.npmjs.org` (instalar y actualizar),
+`glassnote.s3.us-east-1.amazonaws.com` (renderer), `nodejs.org` (solo si no hay Node) y
+la API.
+
+Sin probar, pero a revisar con el área de sistemas del cliente:
+
+- `%APPDATA%` es *Roaming*. Con perfiles móviles, `device-id` y el token viajan con el
+  usuario: dos equipos podrían presentarse como el mismo.
+- Una política de AppLocker o WDAC que no deje correr ejecutables desde el perfil del
+  usuario bloquea `electron.exe` y `node.exe`.
+- Un proxy: npm no toma el proxy de Windows, necesita `HTTPS_PROXY` o
+  `npm_config_proxy`.
+
 ### Otro servidor
 
 **El websocket no se elige en el instalador: lo decide la API que atiende el alta.** El

package/bin/glassnote.js

@@ -257,7 +257,7 @@ let warnedNoSandbox = false;
 function launch({ detach = false, extra = [] } = {}) {
 	const binary = electronPath();
 	const args = launchArgs(binary).concat(extra);
-	const env = Object.assign({}, process.env, {
+	const env = Object.assign(pairing.envWithoutPairing(process.env), {
 		// El modo se marca aquí, no se adivina desde el main: sobrevive a symlinks.
 		GLASSNOTE_INSTALL_MODE: mode.detect(),
 		GLASSNOTE_CLI: path.join(__dirname, 'glassnote.js'),
@@ -792,8 +792,63 @@ function cmdUpdate(args) {
 	return 0;
 }
 
+// Borra ~/.glassnote. En Windows el node.exe que corre ESTE codigo suele vivir adentro (el
+// instalador lo baja ahi cuando el equipo no tiene Node), y un ejecutable en uso no se puede
+// borrar: rmSync moria con EPERM a mitad y dejaba la carpeta a medias, con el autoarranque
+// ya quitado. Se borra ahora todo lo demas -el paquete incluido, que es lo que mira quien
+// comprueba si esta instalado- y la carpeta de ese node la borra un cmd desprendido cuando
+// este proceso ya termino.
+function removeHomeDir() {
+	// Tampoco el cwd puede quedar adentro: Windows no borra el directorio actual de un proceso.
+	try {
+		process.chdir(os.tmpdir());
+	} catch (error) {
+		/* se intenta igual */
+	}
+	const ownExe = path.resolve(process.execPath).toLowerCase();
+	let deferred = false;
+	let complete = true;
+	for (const entry of fs.readdirSync(mode.HOME_DIR)) {
+		const entryPath = path.join(mode.HOME_DIR, entry);
+		if (IS_WIN && ownExe.startsWith(path.resolve(entryPath).toLowerCase() + path.sep)) {
+			deferred = true;
+			continue;
+		}
+		try {
+			fs.rmSync(entryPath, { recursive: true, force: true });
+		} catch (error) {
+			complete = false;
+			console.error(`glassnote: no pude borrar ${entryPath}: ${error.message}`);
+		}
+	}
+	if (!complete) return false;
+	if (!deferred) {
+		fs.rmSync(mode.HOME_DIR, { recursive: true, force: true });
+		return true;
+	}
+	// ping hace de espera porque funciona sin consola; timeout.exe no.
+	spawn(process.env.ComSpec || 'cmd.exe', [`/d /s /c "ping -n 4 127.0.0.1 >nul & rmdir /s /q "${mode.HOME_DIR}""`], {
+		detached: true,
+		stdio: 'ignore',
+		windowsHide: true,
+		windowsVerbatimArguments: true,
+	}).unref();
+	step(`${path.dirname(process.execPath)} está en uso: se borra al terminar este proceso`);
+	return true;
+}
+
 function cmdUninstall() {
 	log('glassnote — desinstalando');
+	// En Windows no se pueden borrar los archivos de un proceso vivo: se cierra el cliente
+	// antes de tocar nada, igual que en install. Sin esto quedaba abierto y con la carpeta
+	// a medio borrar.
+	if (!cerrarClienteWindows()) {
+		fail(
+			'el cliente sigue abierto y Windows no deja borrar sus archivos.\n' +
+				'  Cerralo desde el ícono de la bandeja (clic derecho → Salir) y volvé a intentar.\n' +
+				'  No se tocó nada.'
+		);
+	}
 	// Se comprueba ANTES de borrar: después los archivos ya no están, pero el proceso que
 	// los tenía abiertos sigue vivo y con su ícono en la bandeja. Decir "Desinstalado" con
 	// la app todavía en pantalla es lo que confunde.
@@ -814,7 +869,7 @@ function cmdUninstall() {
 
 	if (fs.existsSync(mode.HOME_DIR)) {
 		step(`borrando ${mode.HOME_DIR}`);
-		fs.rmSync(mode.HOME_DIR, { recursive: true, force: true });
+		if (!removeHomeDir()) fail(`no pude borrar todo ${mode.HOME_DIR} (arriba dice qué quedó).`);
 	}
 	log('');
 	if (seguiaAbierto) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassnote/client",
-  "version": "2.4.15",
+  "version": "2.4.16",
   "description": "GlassNote — cliente de escritorio de notas superpuestas. Se instala con npx, sin instaladores nativos ni firmas.",
   "main": "main.js",
   "publishConfig": {

package/pairing.js

@@ -318,8 +318,22 @@ function argumentoPosicional(args) {
 	return undefined;
 }
 
+// El entorno para la app, sin las variables del alta. La API key de la organizacion solo
+// sirve para darse de alta: heredada, queda semanas en el entorno del cliente y de todo lo
+// que el cliente lance. Windows no distingue mayusculas en los nombres de variable, asi que
+// se comparan sin ellas.
+function envWithoutPairing(env) {
+	const pairingNames = OPCIONES.map((o) => o.env.toUpperCase());
+	const clean = {};
+	for (const key of Object.keys(env || {})) {
+		if (!pairingNames.includes(key.toUpperCase())) clean[key] = env[key];
+	}
+	return clean;
+}
+
 module.exports = {
 	API_URL_POR_DEFECTO,
+	envWithoutPairing,
 	BANDERAS_CON_VALOR,
 	argumentoPosicional,
 	OPCIONES,