@ecuafact/cli 0.0.0-stage → 0.0.1-preview.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ecuanexus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+# @ecuafact/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+CLI oficial de Ecuafact para la facturación electrónica del SRI (Ecuador): emite comprobantes desde JSON, JSONL, carpetas, CSV o Excel; los valida sin consumir cupo; sigue su autorización; descarga el RIDE y el XML; consulta el SRI y vigila carpetas para emitir lo que deja tu ERP.
+
+> **Versión preliminar (`preview`).** Puede cambiar sin aviso. Pruébala primero en el entorno `sandbox`.
+
+Funciona en Windows, Linux y macOS, en equipos x64 y arm64. npm, Bun, pnpm y Yarn instalan automáticamente la versión de tu sistema; requiere Node.js 18 o superior.
+
+```bash
+npm install -g @ecuafact/cli@preview   # o: bun add -g @ecuafact/cli@preview / pnpm add -g @ecuafact/cli@preview
+npx @ecuafact/cli@preview --help       # o: bunx @ecuafact/cli@preview --help
+```
+
+## Primeros pasos
+
+```bash
+ecuafact --entorno sandbox login      # pide tu API Key sin mostrarla y la guarda en el almacén de credenciales del sistema
+ecuafact --entorno sandbox doctor     # revisa conexión, API Key, IP registrada y cupo
+ecuafact --entorno sandbox emitir factura.json --esperar --descargar ride
+```
+
+Tu API Key solo funciona desde una IP registrada en el portal (**Cuenta > IP permitidas**).
+
+## Documentación
+
+- Guía completa: https://docsapi.ecuafact.com/v1/guias/cli
+- Ayuda sin conexión: `ecuafact ayuda` y `ecuafact <comando> --help`

package/bin/ecuafact.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// Lanzador del CLI ecuafact para npm, Bun, pnpm y Yarn: ubica el binario nativo del paquete de la
+// plataforma (instalado como dependencia opcional) y le pasa los argumentos, la entrada y la salida.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+
+const PLATAFORMAS = {
+  "win32-x64": "@ecuafact/cli-win32-x64",
+  "win32-arm64": "@ecuafact/cli-win32-arm64",
+  "linux-x64": "@ecuafact/cli-linux-x64",
+  "linux-arm64": "@ecuafact/cli-linux-arm64",
+  "linux-x64-musl": "@ecuafact/cli-linux-x64-musl",
+  "darwin-x64": "@ecuafact/cli-darwin-x64",
+  "darwin-arm64": "@ecuafact/cli-darwin-arm64",
+};
+
+function sufijoLibc() {
+  if (process.platform !== "linux") {
+    return "";
+  }
+  try {
+    const reporte = process.report && process.report.getReport();
+    return reporte && reporte.header && reporte.header.glibcVersionRuntime ? "" : "-musl";
+  } catch {
+    return "";
+  }
+}
+
+function binario() {
+  if (process.env.ECUAFACT_BINARIO) {
+    return process.env.ECUAFACT_BINARIO;
+  }
+  const clave = `${process.platform}-${process.arch}${sufijoLibc()}`;
+  const paquete = PLATAFORMAS[clave];
+  if (!paquete) {
+    console.error(`ecuafact: no hay binario para esta plataforma (${clave}).`);
+    process.exit(1);
+  }
+  const archivo = process.platform === "win32" ? "ecuafact.exe" : "ecuafact";
+  try {
+    return require.resolve(`${paquete}/bin/${archivo}`);
+  } catch {
+    console.error(`ecuafact: falta el paquete ${paquete}.`);
+    console.error("Reinstala sin omitir dependencias opcionales, por ejemplo: npm install -g @ecuafact/cli");
+    process.exit(1);
+  }
+}
+
+const ruta = binario();
+if (process.platform !== "win32") {
+  try {
+    fs.accessSync(ruta, fs.constants.X_OK);
+  } catch {
+    // Algunos empaquetados pierden el permiso de ejecucion: se restablece.
+    try {
+      fs.chmodSync(ruta, 0o755);
+    } catch (error) {
+      console.error(`ecuafact: el binario no es ejecutable (${ruta}): ${error.message}`);
+      process.exit(1);
+    }
+  }
+}
+
+const resultado = spawnSync(ruta, process.argv.slice(2), { stdio: "inherit", windowsHide: false });
+if (resultado.error) {
+  console.error(`ecuafact: no se pudo ejecutar ${ruta}: ${resultado.error.message}`);
+  process.exit(1);
+}
+process.exit(resultado.status === null ? 1 : resultado.status);

package/package.json

@@ -1,6 +1,38 @@
-{
-  "name": "@ecuafact/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+    "name":  "@ecuafact/cli",
+    "version":  "0.0.1-preview.2",
+    "description":  "CLI de facturacion electronica de Ecuafact (SRI Ecuador).",
+    "license":  "MIT",
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/Ecuanexus/ecuafact-cli.git"
+                   },
+    "homepage":  "https://docsapi.ecuafact.com/",
+    "keywords":  [
+                     "ecuafact",
+                     "sri",
+                     "ecuador",
+                     "facturacion-electronica",
+                     "cli"
+                 ],
+    "bin":  {
+                "ecuafact":  "bin/ecuafact.js"
+            },
+    "files":  [
+                  "bin/ecuafact.js",
+                  "README.md",
+                  "LICENSE"
+              ],
+    "engines":  {
+                    "node":  "\u003e=18"
+                },
+    "optionalDependencies":  {
+                                 "@ecuafact/cli-win32-x64":  "0.0.1-preview.2",
+                                 "@ecuafact/cli-win32-arm64":  "0.0.1-preview.2",
+                                 "@ecuafact/cli-linux-x64":  "0.0.1-preview.2",
+                                 "@ecuafact/cli-linux-arm64":  "0.0.1-preview.2",
+                                 "@ecuafact/cli-linux-x64-musl":  "0.0.1-preview.2",
+                                 "@ecuafact/cli-darwin-x64":  "0.0.1-preview.2",
+                                 "@ecuafact/cli-darwin-arm64":  "0.0.1-preview.2"
+                             }
+}