@tecsom/apipos-js 2.0.3 → 2.0.4

package/README.md

@@ -1,6 +1,7 @@
 # @tecsom/apipos-js
 
-> 📖 Documentación: https://tecsom.github.io/Apipos/
+> 📖 Documentación: https://tecsom.github.io/Apipos/ ·
+> [![npm](https://img.shields.io/npm/v/@tecsom/apipos-js)](https://www.npmjs.com/package/@tecsom/apipos-js)
 
 Cliente oficial para [Apipos](https://github.com/Tecsom/Apipos), el agente local
 de impresión de Tecsom que corre en cada caja (`http://127.0.0.1:50432`) y
@@ -21,12 +22,18 @@ El contrato HTTP que envuelve está en `APIPOS_API.md` del repo de Apipos.
 
 | Caso | Comando |
 |---|---|
+| Release (recomendado) | `npm i -D @tecsom/apipos-js@X.Y.Z`  ·  `pnpm add -D @tecsom/apipos-js@X.Y.Z` |
 | Desarrollo local (repos hermanos en `REPOSITORIES/`) | `pnpm add -D "file:../apipos-js"` |
+| **Alternativas sin npm** | |
 | Release, desde git | `pnpm add -D "github:Tecsom/apipos-js#vX.Y.Z"` |
 | Release, tarball | `pnpm add -D "https://github.com/Tecsom/apipos-js/releases/download/vX.Y.Z/tecsom-apipos-js-X.Y.Z.tgz"` |
 
+`X.Y.Z` es siempre la versión del Apipos instalado en las cajas (nunca `latest`
+ni `^`). Paquete en npm: https://www.npmjs.com/package/@tecsom/apipos-js
+
 Desde git, el gestor de paquetes instala las devDependencies y corre `prepare`
-(= `npm run build`), así que `dist/` se genera solo. El tarball ya trae `dist/`.
+(= `npm run build`), así que `dist/` se genera solo. El paquete de npm y el
+tarball ya traen `dist/`.
 
 Usa siempre la versión **igual** a la del Apipos instalado en las cajas.
 
@@ -309,6 +316,9 @@ Por defecto leen `../Apipos/app-meta.env` (el checkout hermano); con otra ruta:
 
 Un release publica el mismo tag `vX.Y.Z` en ambos repos: Apipos con sus
 instaladores y apipos-js con `release/tecsom-apipos-js-X.Y.Z.tgz` (`npm run pack`).
+Además, el push del tag `vX.Y.Z` a apipos-js dispara `.github/workflows/publish.yml`,
+que corre las pruebas y publica `@tecsom/apipos-js@X.Y.Z` en npm con *provenance*
+(trusted publishing, sin token).
 El checklist completo está en el README de Apipos ("Librería JS (`apipos-js`)").
 
 ### Handshake: el aviso en la consola
@@ -376,8 +386,9 @@ describeVersions('1.0.6', '1.0.6');    // { client: '1.0.6', backend: '1.0.6', s
 
 ## Desarrollo
 
-Requiere Node ≥ 22.18 (corre las pruebas y los scripts `.ts` directamente, por
-type stripping).
+Requiere **Node ≥ 22.18** (corre las pruebas y los scripts `.ts` directamente, por
+type stripping: `scripts/sync-version.ts` es TypeScript sin compilar y Node 20
+no lo ejecuta). El repo trae `.nvmrc` (Node 24): `nvm use` lo toma.
 
 ```bash
 npm install          # instala TypeScript y @types/node (versiones exactas) y compila (prepare)

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.0.3";
+export declare const VERSION = "2.0.4";
 export declare const CLIENT_NAME = "apipos-js";

package/dist/version.js

@@ -1,4 +1,4 @@
 // Generado por scripts/sync-version.ts a partir del app-meta.env de Apipos. NO editar a mano:
 // la versión de la librería SIEMPRE es la del backend (versionado en lockstep).
-export const VERSION = '2.0.3';
+export const VERSION = '2.0.4';
 export const CLIENT_NAME = 'apipos-js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tecsom/apipos-js",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Cliente JavaScript (ES modules para el navegador, con tipos TypeScript) para Apipos.",
   "type": "module",
   "main": "./dist/index.js",