@t4h.framework/dev 0.0.0-experimental-20260812130420 → 0.0.0-experimental-20260902161345

package/CHANGELOG.md

@@ -1,13 +1,72 @@
 # @t4h.framework/dev
 
-## 0.0.0-experimental-20260812130420
+## 0.0.0-experimental-20260902161345
+
+### Minor Changes
+
+- [#145](https://github.com/tech4humans-brasil/framework/pull/145) [`13c7a2e`](https://github.com/tech4humans-brasil/framework/commit/13c7a2e80ad5cd3e9ab10ebe5f3cdfc66f4bc664) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Replaces the interactive REPL of `framework dev` with an HTTP dev server: Hono routes workflow (`POST /projects/:projectId/workflows/:workflowId/runs` answers `201 { id }`, `PATCH .../runs/:runId/activities/:activityId` advances a pending async activity), mandatory workflow authorization resolved from the app/workflow `Authorization` manifest, `/_dev` routes for tooling (manifest, runs, waiting activities, env, SSE events) and Vite in middleware mode for a UI. Workflow runs now live in an in-memory SQLite database inside the app process, the ORM dev claim stores its rows in `db.sqlite` instead of rewriting `db.json` on every change, child workflows run in parallel, and `framework dev` gains `--port` (`PORT`) and `--host`. `DevServer` and `isWorkflowWaiting` are gone; use `Server`.
+
+## 0.14.2
+
+### Patch Changes
+
+- [#143](https://github.com/tech4humans-brasil/framework/pull/143) [`00563fd`](https://github.com/tech4humans-brasil/framework/commit/00563fd9f30cf007a1e5ec8372085cf392d839f4) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Fix start workflow many interruptions
+
+## 0.14.1
+
+### Patch Changes
+
+- [`298806e`](https://github.com/tech4humans-brasil/framework/commit/298806ec8f05fecd7d03465627b45236c5d4f8f1) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Points the `@t4h.framework/http` dependency back to the `0.x` line (`^0.4.3`). `0.14.0` was published depending on the accidental `http@1.0.0`.
+
+## 0.14.0
+
+### Minor Changes
+
+- [`8c56f76`](https://github.com/tech4humans-brasil/framework/commit/8c56f7697390a1ea966d1e91ff5f35ce5751a0d7) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - feat: write in-memory content to durable storage from a workflow
+
+  There was no supported way to turn a string or a Buffer into a `Binary` inside
+  a workflow — every `Binary` came from an existing file (`http` response,
+  `sftp.get`, `split`, `join`). Anyone needing to upload computed content had to
+  implement `Binary` by hand, and such an instance can never be persisted, so the
+  activity carrying it failed to serialize.
+
+  `write(content, options?)` covers that gap: it pushes an activity that stores
+  the content through the `FileSystemClaim` and returns a `Binary` that survives
+  replay.
+
+  ```ts
+  const file = await write(JSON.stringify(data), {
+    contentType: 'application/json',
+  })
+
+  await sftp.put('/out/data.json', file)
+  ```
+
+  `FileSystemClaim.write` takes an optional `contentType` — until now the content
+  type was always inferred from the file extension.
+
+  The dev codec no longer diverges from the runtime one: its binary kind used to
+  match only `DevFileBinary`, so a hand-written `Binary` was silently serialized
+  as a plain object locally and blew up once deployed. It now matches any
+  `Binary` and spools unknown ones to disk, the same way the runtime spools them
+  to the file storage.
+
+- [`8c56f76`](https://github.com/tech4humans-brasil/framework/commit/8c56f7697390a1ea966d1e91ff5f35ce5751a0d7) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Adds FS write activity
+
+### Patch Changes
+
+- Updated dependencies [[`8c56f76`](https://github.com/tech4humans-brasil/framework/commit/8c56f7697390a1ea966d1e91ff5f35ce5751a0d7), [`8c56f76`](https://github.com/tech4humans-brasil/framework/commit/8c56f7697390a1ea966d1e91ff5f35ce5751a0d7)]:
+  - @t4h.framework/fs@0.8.0
+  - @t4h.framework/http@1.0.0
+
+## 0.13.2
 
 ### Patch Changes
 
-- [#135](https://github.com/tech4humans-brasil/framework/pull/135) [`f87f69a`](https://github.com/tech4humans-brasil/framework/commit/f87f69a98cf438d7efd4ebcd6c0400acb26dc2bf) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Fix start workflow activity
+- [#135](https://github.com/tech4humans-brasil/framework/pull/135) [`c238dbe`](https://github.com/tech4humans-brasil/framework/commit/c238dbea4199169c935c714442d9e316abd74e20) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Fix start workflow activity
 
-- Updated dependencies [[`f87f69a`](https://github.com/tech4humans-brasil/framework/commit/f87f69a98cf438d7efd4ebcd6c0400acb26dc2bf)]:
-  - @t4h.framework/core@0.0.0-experimental-20260812130420
+- Updated dependencies [[`c238dbe`](https://github.com/tech4humans-brasil/framework/commit/c238dbea4199169c935c714442d9e316abd74e20)]:
+  - @t4h.framework/core@0.9.1
 
 ## 0.13.1
 

package/README.md

@@ -1,35 +1,38 @@
 # @t4h.framework/dev
 
-Local development runtime for [T4H Framework](https://github.com/tech4humans-brasil/framework) apps. Watches your project, compiles TypeScript, loads your `App`, and executes workflows with in-memory claim implementations — no external infrastructure required.
+Local development runtime for [T4H Framework](https://github.com/tech4humans-brasil/framework) apps. Watches your project, compiles TypeScript, loads your `App` in a child process and exposes it over HTTP with the same routes as the production runtime — no external infrastructure required.
 
 ## What it does
 
 When you run `framework dev` (via `@t4h.framework/cli`), this package powers the experience behind the scenes:
 
 1. **TypeScript watch** — compiles your app on every change.
-2. **App process** — forks a child Node process that loads your compiled `App`.
-3. **JSON-RPC over IPC** — the parent process drives workflows, env vars, and async activity advancement through a typed RPC layer.
-4. **Dev claims** — provides local implementations for ORM, HTTP, file system, cache, SMTP, and more.
+2. **App process** — forks a child Node process that loads your compiled `App` and runs the workflow engine on an in-memory SQLite database.
+3. **HTTP server** — a [Hono](https://hono.dev) app that mirrors the production routes (without the tenant prefix), enforces the workflow authorization and exposes `/_dev` routes for tooling.
+4. **Vite** — a Vite dev server in middleware mode serves everything that is not an API route, ready for a UI plugin.
+5. **Dev claims** — provides local implementations for ORM, HTTP, file system, cache, SMTP, and more.
 
 ```mermaid
 flowchart TB
-  subgraph parent ["Parent process (DevServer)"]
+  subgraph parent ["Parent process (Server)"]
     Watch["TypeScript watch"]
-    RPCClient["JSON-RPC client"]
-    Watch -->|"build success"| Fork
-    Fork["fork()"]
-    Fork --> RPCClient
+    HTTP["Hono (/projects, /_dev)"]
+    Vite["Vite middlewares (UI)"]
+    Auth["Workflow authorization"]
+    Watch -->|"build success"| Fork["AppProcess.up()"]
+    HTTP --> Auth
   end
 
   subgraph child ["Child process (app-process worker)"]
     App["User App"]
-    RPCServer["JSON-RPC server"]
+    Engine["Workflow engine + SQLite :memory:"]
     Claims["Dev claims"]
-    App --> RPCServer
+    App --> Engine
     Claims --> App
   end
 
-  RPCClient <-->|"IPC / JSON-RPC"| RPCServer
+  Fork --> App
+  HTTP <-->|"IPC / JSON-RPC"| Engine
 ```
 
 ## Installation
@@ -76,6 +79,8 @@ Then run:
 yarn dev
 ```
 
+The server listens right away and prints the routes of every workflow once the first build finishes.
+
 ### Options
 
 | Flag | Description | Default |
@@ -83,6 +88,8 @@ yarn dev
 | `--entrypoint <path>` | Path to the project's `package.json` | `./package.json` |
 | `-e, --env <KEY=VALUE>` | Environment variable (repeatable) | — |
 | `--env-file-if-exists <path>` | Load variables from a `.env` file if it exists | — |
+| `-p, --port <port>` | HTTP port (also `PORT`) | `3000` |
+| `--host <host>` | HTTP host | `localhost` |
 
 Example with env vars:
 
@@ -90,47 +97,89 @@ Example with env vars:
 framework dev --entrypoint ./package.json -e API_KEY=secret -e DB_HOST=localhost
 ```
 
-## Programmatic usage
+## HTTP routes
+
+The routes are the production ones without the `/tenants/:tenant` and `/versions/:projectVersionId` segments: the dev server has no tenants and a single live version (the last build). `projectId` must match your `App` id.
+
+| Method | Route | Authorization | Response |
+|--------|-------|---------------|----------|
+| `GET` | `/projects/:projectId/manifest.json` | no | `200` the app manifest |
+| `POST` | `/projects/:projectId/workflows/:workflowId/runs` | yes | `201 { "id": "<run id>" }` |
+| `PATCH` | `/projects/:projectId/workflows/:workflowId/runs/:runId/activities/:activityId` | yes | `200 { id, type, status }` |
+
+The `POST` body is the workflow input, validated against the workflow schema (`400` with the validation errors). The `PATCH` body is `{ "payload": ... }`, validated against the pending async activity schema (`400 Payload is invalid`, `400 AsyncActivity is not pending`). Errors use the NestJS shape `{ statusCode, message, error }`; `503` means the app process is still starting.
+
+```bash
+curl -X POST http://localhost:3000/projects/my-app/workflows/my-workflow/runs \
+  -H 'content-type: application/json' \
+  -H 'x-signature: <hmac>' \
+  -d '{ "userId": "123" }'
+```
+
+### Authorization
+
+Every production-mirror route requires an authorization, exactly like the production runtime: the workflow `authorization` wins over the app one, its manifest `pathToModule` is imported and its default export receives the manifest `context` templated with the request (`<< headers.x-signature >>`, `<< rawBody >>`, `<< body.id >>`, `<< params.projectId >>`, `<< query.token >>`). A falsy result or a thrown error answers `401`. A workflow without any authorization answers `500` on purpose: it will not work in production either.
+
+`pathToModule` may be `@t4h.framework/hmac/authorize`, `@t4h.framework/jwks/authorize`, `@t4h.framework/oidc/authorize`, an absolute path, a path relative to the project or a `file://` URL.
+
+### Dev routes (no authorization)
 
-You can embed `DevServer` in your own tooling instead of using the interactive CLI:
+| Method | Route | Description |
+|--------|-------|-------------|
+| `GET` | `/_dev/manifest` | App manifest |
+| `GET` | `/_dev/state` | `{ state: 'idle' \| 'starting' \| 'ready' \| 'exited' }` |
+| `GET` | `/_dev/runs?status=&workflow=&limit=&offset=` | `{ count, runs }` newest first |
+| `GET` | `/_dev/runs/:id` | Run with activities, pendings and logs (framework tagged JSON) |
+| `GET` | `/_dev/activities/waiting` | Async activities waiting for an advance |
+| `GET` | `/_dev/env` | Environment variables of the app process |
+| `PUT` | `/_dev/env/:name` | `{ value }` sets an environment variable |
+| `GET` | `/_dev/events` | SSE: `manifest`, `build:status`, `build:fail`, `app:exit` |
+
+Everything else is handed to Vite, so a UI plugin registered in the project's `vite.config.*` (or through `vite.plugins`) is served by the same port.
+
+## State
+
+Workflow runs, activities, pending async activities and logs live in an in-memory SQLite database (`node:sqlite`) inside the app process. Every successful build forks a fresh process, so **a rebuild resets all runs, timers and pending activities**; the `manifest` SSE event tells a UI to reload. Durability, queues and resume belong to the production runtime.
+
+Sync activities run inline, `sleep` and other timers use `setTimeout`, and child workflows started with `startWorkflow` / `startWorkflowMany` run in parallel, like in production.
+
+The ORM claim is the exception: its rows live in `db.sqlite` next to your `package.json` and survive rebuilds and restarts (add it to `.gitignore`). Delete the file to start over. The previous `db.json` is no longer read.
+
+## Programmatic usage
 
 ```typescript
-import { DevServer } from '@t4h.framework/dev'
-
-const devServer = new DevServer(
-  {
-    entrypoint: './package.json',
-    env: { API_KEY: 'secret' },
-  },
-  manifest => {
-    console.log('App loaded:', manifest.workflows.map(w => w.id))
-  },
-)
-
-await devServer.start()
-
-const result = await devServer.runWorkflow('my-workflow/v1', {
-  userId: '123',
-  amount: 100,
+import { Server } from '@t4h.framework/dev'
+
+const server = new Server({
+  entrypoint: './package.json',
+  env: { API_KEY: 'secret' },
+  port: 3000,
+  host: 'localhost',
+  vite: { plugins: [myPanelPlugin()] },
+})
+
+server.on('manifest', manifest => {
+  console.log('App ready:', manifest.workflows.map(workflow => workflow.id))
 })
 
-await devServer.setEnv('API_KEY', 'new-value')
-const env = await devServer.listEnv()
+const address = await server.up()
 
-const pending = await devServer.listWaitingAsyncActivities()
-await devServer.advanceAsyncActivity(pending[0].id, { approved: true })
+console.log(address.url)
+
+await server.down()
 ```
 
-### DevServer API
+### Server API
 
-| Method | Description |
+| Member | Description |
 |--------|-------------|
-| `start()` | Resolves project paths, starts TypeScript watch, and boots the app process on first successful build. |
-| `runWorkflow(id, input)` | Runs a workflow by id with the given input. |
-| `setEnv(name, value)` | Sets an environment variable in the running app process. |
-| `listEnv()` | Returns all environment variables. |
-| `listWaitingAsyncActivities()` | Lists async activities waiting for manual advancement. |
-| `advanceAsyncActivity(id, payload)` | Advances a pending async activity with the given payload. |
+| `up()` | Starts HTTP + Vite, then the TypeScript watch; resolves with `{ host, port, url }`. |
+| `down()` | Stops the watch, the app process, Vite and the HTTP server. |
+| `manifest` | Current app manifest or `null`. |
+| `address` | Listening address (throws before `up()`). |
+| events | `manifest`, `build:status`, `build:fail`, `app:exit`, `error`. |
+
+`vite: false` disables Vite; `vite.root` / `vite.configFile` point at another Vite project. The server logs the listening URL, build output and the routes of every workflow through `logger` (default `console`, `false` to silence). A manifest with a workflow that has no authorization (and no app default) emits `error` with a `WorkflowAuthorizationMissingError`; `framework dev` exits with code 1 in that case.
 
 ## Dev claims
 
@@ -138,7 +187,7 @@ In production, claims are fulfilled by the runtime (database connections, real H
 
 | Claim | Dev implementation |
 |-------|-------------------|
-| `ORMClaim` | In-memory database |
+| `ORMClaim` | SQLite file `db.sqlite` in the project directory; `where` keeps the Mongo-like semantics (`$like`, `$ilike`, `$or`, ...) |
 | `HttpClientRequestClaim` | Real HTTP via `undici` |
 | `FileSystemClaim` | Local file system with dev binary codec |
 | `SmtpSendEmailClaim` | Captures emails in memory (no delivery) |
@@ -164,7 +213,7 @@ import {
 
 ## Requirements
 
-- Node.js >= 22
+- Node.js >= 22.13 (`node:sqlite`)
 - A T4H Framework `App` exported from your project's entry point (`default` or named `app` export)
 
 ## License

package/dist/AppProcess.d.ts

@@ -0,0 +1,36 @@
+import { fork } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import type { App } from '@t4h.framework/core';
+export type AppManifest = ReturnType<App['toManifest']>;
+export type AppProcessState = 'idle' | 'starting' | 'ready' | 'exited';
+export declare class AppProcessNotReadyError extends Error {
+    readonly name = "AppProcessNotReadyError";
+}
+export interface AppProcessOptions {
+    workerPath?: string;
+    readyTimeoutInMs?: number;
+    killTimeoutInMs?: number;
+    fork?: typeof fork;
+}
+export declare class AppProcess extends EventEmitter {
+    private readonly workerPath;
+    private readonly readyTimeoutInMs;
+    private readonly killTimeoutInMs;
+    private readonly forkProcess;
+    private readonly server;
+    private child;
+    private client;
+    private ready;
+    private currentManifest;
+    private currentState;
+    constructor({ workerPath, readyTimeoutInMs, killTimeoutInMs, fork: forkProcess, }?: AppProcessOptions);
+    get manifest(): AppManifest | null;
+    get state(): AppProcessState;
+    up(entrypoint: string, env: Record<string, string>): Promise<AppManifest>;
+    down(): Promise<void>;
+    private kill;
+    whenReady(): Promise<AppManifest>;
+    call<T = any>(method: string, ...params: any[]): Promise<T>;
+    private onManifest;
+    private onExit;
+}

package/dist/AppProcess.js

@@ -0,0 +1,125 @@
+import { fork } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import path from 'node:path';
+import { styleText } from 'node:util';
+import Type from 'typebox';
+import { APP_KILL_TIMEOUT_IN_MS, APP_READY_TIMEOUT_IN_MS, } from './constants/server.js';
+import { JSONRPCClient } from './models/JSONRPCClient.js';
+import { JSONRPCServer, JSONRPCServerMethod } from './models/JSONRPCServer.js';
+export class AppProcessNotReadyError extends Error {
+    name = 'AppProcessNotReadyError';
+}
+export class AppProcess extends EventEmitter {
+    workerPath;
+    readyTimeoutInMs;
+    killTimeoutInMs;
+    forkProcess;
+    server;
+    child = null;
+    client = null;
+    ready = null;
+    currentManifest = null;
+    currentState = 'idle';
+    constructor({ workerPath = path.join(import.meta.dirname, 'workers', 'app-process.js'), readyTimeoutInMs = APP_READY_TIMEOUT_IN_MS, killTimeoutInMs = APP_KILL_TIMEOUT_IN_MS, fork: forkProcess = fork, } = {}) {
+        super();
+        this.workerPath = workerPath;
+        this.readyTimeoutInMs = readyTimeoutInMs;
+        this.killTimeoutInMs = killTimeoutInMs;
+        this.forkProcess = forkProcess;
+        this.server = new JSONRPCServer([
+            new JSONRPCServerMethod('manifest', { schema: [Type.Any()] }, (manifest) => this.onManifest(manifest)),
+        ], message => {
+            this.child?.send(message);
+        });
+    }
+    get manifest() {
+        return this.currentManifest;
+    }
+    get state() {
+        return this.currentState;
+    }
+    async up(entrypoint, env) {
+        const previous = this.child;
+        this.child = null;
+        this.client?.rejectPending(new AppProcessNotReadyError('App process is restarting'));
+        this.client = null;
+        this.ready = Promise.withResolvers();
+        this.ready.promise.catch(() => { });
+        this.currentState = 'starting';
+        await this.kill(previous);
+        const child = this.forkProcess(this.workerPath, [
+            entrypoint,
+            ...Object.entries(env).map(([name, value]) => `${name}=${value}`),
+        ], { stdio: ['ignore', 'inherit', 'inherit', 'ipc'] });
+        const client = new JSONRPCClient(message => {
+            child.send(message);
+        });
+        this.child = child;
+        this.client = client;
+        child.on('message', message => Promise.all([this.server.handle(message), client.handle(message)]).catch(error => {
+            console.error(styleText('red', '[AppProcess] failed to handle message:', {
+                stream: process.stderr,
+            }), error);
+        }));
+        child.on('exit', code => this.onExit(child, code));
+        return this.whenReady();
+    }
+    async down() {
+        await this.kill(this.child);
+    }
+    async kill(child) {
+        if (!child)
+            return;
+        if (child.exitCode !== null || child.signalCode !== null)
+            return;
+        await new Promise(resolve => {
+            const timer = setTimeout(() => child.kill('SIGKILL'), this.killTimeoutInMs);
+            child.once('exit', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            child.kill();
+        });
+    }
+    whenReady() {
+        if (this.currentState === 'ready' && this.currentManifest)
+            return Promise.resolve(this.currentManifest);
+        if (this.currentState !== 'starting' || !this.ready)
+            return Promise.reject(new AppProcessNotReadyError('App process is not running'));
+        const { promise } = this.ready;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new AppProcessNotReadyError(`App process did not become ready in ${this.readyTimeoutInMs}ms`)), this.readyTimeoutInMs);
+            promise.then(manifest => {
+                clearTimeout(timer);
+                resolve(manifest);
+            }, error => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    async call(method, ...params) {
+        await this.whenReady();
+        if (!this.client)
+            throw new AppProcessNotReadyError('App process is not running');
+        return this.client.call(method, ...params);
+    }
+    onManifest(manifest) {
+        this.currentManifest = manifest;
+        this.currentState = 'ready';
+        this.ready?.resolve(manifest);
+        this.emit('manifest', manifest);
+    }
+    onExit(child, code) {
+        if (this.child !== child)
+            return;
+        const error = new AppProcessNotReadyError(`App process exited with code ${code}`);
+        this.child = null;
+        this.currentState = 'exited';
+        this.client?.rejectPending(error);
+        this.client = null;
+        this.ready?.reject(error);
+        this.emit('exit', code);
+    }
+}
+//# sourceMappingURL=AppProcess.js.map

package/dist/AppProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProcess.js","sourceRoot":"","sources":["../src/AppProcess.ts"],"names":[],"mappings":"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"}

package/dist/Server.d.ts

@@ -0,0 +1,45 @@
+import { EventEmitter } from 'node:events';
+import type { PluginOption } from 'vite';
+import { type AppManifest } from './AppProcess.js';
+export interface ServerViteOptions {
+    root?: string;
+    configFile?: string | false;
+    plugins?: PluginOption[];
+}
+export type ServerLogger = Pick<Console, 'log' | 'error'>;
+export interface ServerOptions {
+    entrypoint: string;
+    env: Record<string, string>;
+    port?: number;
+    host?: string;
+    vite?: ServerViteOptions | false;
+    logger?: ServerLogger | false;
+}
+export interface ServerAddress {
+    host: string;
+    port: number;
+    url: string;
+}
+export declare class Server extends EventEmitter {
+    private readonly options;
+    private readonly appProcess;
+    private readonly logger;
+    private routes;
+    private tsBuildWatcher;
+    private httpServer;
+    private vite;
+    private currentAddress;
+    private packageJsonPath;
+    private outDir;
+    constructor(options: ServerOptions);
+    get manifest(): AppManifest | null;
+    get address(): ServerAddress;
+    up(): Promise<ServerAddress>;
+    down(): Promise<void>;
+    private onTsBuildSuccess;
+    /**
+     * Vite only serves the UI (a panel plugin from the project's vite.config or
+     * from `vite.plugins`); the API never goes through it.
+     */
+    private createVite;
+}