wasam

name

wasam

description

Crear, servir y operar web apps locales sobre PHP (WebAssembly) + SQLite con la CLI `wasam`, e interactuar con ellas por API HTTP o por CLI. Úsala cuando el usuario quiera levantar una app local PHP+SQLite sin instalar PHP/Apache/MySQL, exponer una REST API en localhost para que otra app o un agente la consuma, o cuando mencione "wasam", "php-wasm", "app local php sqlite", o pida que un agente interactúe por CLI/HTTP con una app local.

wasam — web apps locales PHP-WASM + SQLite

wasam corre apps PHP (compilado a WebAssembly, sin instalar PHP/Apache/MySQL) con SQLite, server-side en Node, cada app en su propio puerto loopback (127.0.0.1:<port>). Dos vías de interop, ambas disponibles a la vez:

• API HTTP: cualquier proceso pega a http://localhost:<port>/... (curl, fetch, otra app).
• CLI: wasam call <app> <MÉTODO> <ruta> [json] hace la request por ti (ideal para un agente).

Modelo mental (importante)

• El paquete (wasam-kit, el runtime) está instalado globalmente; tú no lo tocas.
• Los datos viven en un workspace = el directorio actual: un registry.json (mapa app→puerto) y una carpeta apps/. Cada app es apps/<app>/public/index.php (front controller PHP) + apps/<app>/store/app.sqlite (su base, archivo real en disco).
• Antes de crear apps en un directorio, hay que inicializarlo una vez con wasam init.

Instalación (una vez)

Si wasam no está disponible (wasam help falla), instálalo desde el repo del kit:

cd <ruta-a-wasam-kit> && npm install && npm