outerbase-backups

CLI para exportar archivos (SQL) de consultas locales de Outerbase.

Requisitos

• Node.js 22 o superior

Instalacion

1. Instala dependencias (si aplica):

npm install

2. Para usarlo como comando global/local de consola, vincula el paquete:

npm link

Con eso podras ejecutar el comando:

ob-backup

Tambien puedes ejecutarlo sin link global:

npm run backup

Variables de entorno

El script lee variables desde un archivo .env en la raiz del proyecto.

• FILE_PATH: ruta al archivo JSON de entrada.
• OUTPUT_PATH: carpeta base donde se van a generar los archivos.
• DIR_NAME: nombre de subcarpeta dentro de OUTPUT_PATH para agrupar la salida.

Ejemplo de .env:

FILE_PATH=C:/Users/tu-usuario/Desktop/outerbase-backups/data.json
OUTPUT_PATH=C:/Users/tu-usuario/Desktop/outerbase-backups
DIR_NAME=estratificacion_local_queries

La ruta final de salida queda asi:

OUTPUT_PATH/DIR_NAME/<namespace.name>/<archivo>.<type>

Uso

1. Define las variables en .env.
2. Ejecuta el comando:

ob-backup

Si prefieres, tambien funciona:

pnpm run backup

Formato esperado del JSON

El archivo en FILE_PATH debe tener esta estructura:

{
	"namespace": [
		{ "id": "ns_1" }
	],
	"docs": {
		"ns_1": [
			{
				"name": "asegurar",
				"type": "sql",
				"content": "SELECT *\nFROM tabla;",
				"namespace": {
					"name": "ns_1"
				}
			}
		]
	}
}

Campos importantes por archivo en docs:

• name: nombre del archivo sin extension.
• type: extension del archivo (sql, txt, etc).
• content: contenido literal a escribir en disco.
• namespace.name: carpeta donde se guardara el archivo.

Notas

• El contenido se escribe tal cual viene en content. Si en el JSON hay saltos de linea escapados (\n), al parsear JSON se convierten a saltos reales en el archivo generado.
• El script crea automaticamente las carpetas necesarias antes de escribir cada archivo.