@blotout/qinto-cli 0.1.16 → 0.1.17

package/README.md

@@ -263,8 +263,19 @@ goes caller → the site worker's broker → callee, each app in its own worker.
 apps are mounted; a `private` one is refused with `403 forbidden` until you approve it under **App-to-app approvals** on the
 callee's page, exactly as a site manager does on a deployed site.
 
+**An app you call but do not have is mocked for you.** When a mounted app's `rpc.calls` names a slug nothing mounts, `dev`
+scaffolds `mocks/<slug>.ts` inside the calling app — one exported function per function it exposes — and mounts it under that
+slug. `ctx.apps.call('resend', 'send', args)` then takes the real path: caller → broker → the mock's own worker, with no `if` in
+your code and nothing to change when the real app arrives beside you.
+
+If you are logged in, the mock is typed: `dev` fetches the app's published rpc contract, writes it next to the stub as
+`mocks/<slug>.rpc.json`, generates `mocks/<slug>.types.ts` from it, and the platform validates every call and result against it —
+so a mock that lies about its shape fails locally the way the real app would. Commit all three files; the sidecar keeps the mock
+typed offline and for anyone else who checks the app out. Without a contract (not logged in, or the app is unpublished) the stub
+takes and returns `unknown` and the terminal says why.
+
 An app folder added or removed while `dev` is running is not picked up — it says so and asks for a restart. A save inside a
-mounted app rebuilds that app alone.
+mounted app rebuilds that app and every mock alongside it.
 
 Declared `server.schedules` fire on their own while `dev` runs — at the cron's minute, in UTC, with `scheduledTime` set to that
 instant, exactly as the deployed sweep dispatches them. Each schedule on the app's console page also has a **Run now** button,
@@ -532,7 +543,7 @@ digest is what the version is finalized against. Every field and option is docum
 | `variables` | Up to 32 per-install settings a team fills in — `plain` or `secret`, `text`/`password`/`toggle`. |
 | `appVariables` | Up to 16 settings you fill in once for the whole app with `qinto app var set` / `qinto app secret set`. |
 | `endpoints` | Up to 16 HTTP routes served at `https://<site>/app/<slug><path>`. |
-| `rpc` | Functions this app `exposes` to other apps, and the ones it `calls` on them. |
+| `rpc` | Functions this app `exposes` to other apps, and the ones it `calls` on them. Each exposed one is built with `defineRpc`, and publish uploads its argument and result schemas as the version's contract. |
 | `events` | The push topics this app broadcasts to every app on the site. |
 | `ui` | `dir` holding the built panel, and the `build` command that produces it. |
 | `install` | `multiple: true` to let a site install the app more than once, plus a `labelHint`. |