@montytools/cli 0.2.6 → 0.2.8

package/bin/monty.mjs

@@ -489,6 +489,7 @@ async function dev() {
   let hbTimer = null;
   let publishing = false;
   let ended = false;
+  const sessionId = `dev_${randomBytes(16).toString("hex")}`;
   const buildFile = join(appDir, ".monty", "build");
   const buildId = existsSync(buildFile) ? readFileSync(buildFile, "utf8").trim() : undefined;
   // The DEV schema channel: heartbeats carry the compiled schema, and edits
@@ -519,7 +520,7 @@ async function dev() {
         await fetch(`${host}/api/dev-session`, {
           method: "POST",
           headers: { authorization: `Bearer ${cfg.key}`, "content-type": "application/json" },
-          body: JSON.stringify({ slug: meta.slug, end: true }),
+          body: JSON.stringify({ slug: meta.slug, sessionId, end: true }),
           signal: AbortSignal.timeout(timeoutMs),
         });
       } catch { /* best effort */ }
@@ -534,7 +535,17 @@ async function dev() {
     await clearDevSession();
   }
 
-  async function heartbeat(originUrl) {
+  function stopSuperseded(fix) {
+    if (ended) return;
+    ended = true;
+    if (hbTimer) clearInterval(hbTimer);
+    try { tunnelChild?.kill(); } catch { /* already gone */ }
+    try { child.kill(); } catch { /* already gone */ }
+    console.log(`dev-session: superseded — ${fix}`);
+    setTimeout(() => process.exit(0), 50);
+  }
+
+  async function heartbeat(originUrl, { claim = false } = {}) {
     await refreshSchemaIfChanged();
     try {
       const r = await fetch(`${host}/api/dev-session`, {
@@ -543,6 +554,8 @@ async function dev() {
         body: JSON.stringify({
           slug: meta.slug,
           tunnelUrl: originUrl,
+          sessionId,
+          claim,
           name: currentMeta.name,
           icon: currentMeta.icon,
           buildId,
@@ -552,6 +565,10 @@ async function dev() {
       });
       const data = await r.json().catch(() => null);
       if (!r.ok) {
+        if (data?.code === "DEV_SESSION_SUPERSEDED") {
+          stopSuperseded(data.fix ?? "A newer `monty dev` session is active for this app.");
+          return false;
+        }
         console.log(`dev-session: ${data?.code ?? r.status}${data?.fix ? ` — ${data.fix}` : ""}`);
         return false;
       }
@@ -633,7 +650,7 @@ async function dev() {
         console.log("tunnel: unavailable — dev mode registered on localhost (visible on this machine's browser only)");
       }
     }
-    const registered = await heartbeat(originUrl);
+    const registered = await heartbeat(originUrl, { claim: true });
     console.log(
       registered
         ? `studio: ${host}/studio/${meta.slug} — your app is live there while this runs; click Publish to ship`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@montytools/cli",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "bin": {
     "monty": "./bin/monty.mjs"

package/template/AGENTS.md

@@ -39,6 +39,9 @@ Folders are managed for you: this app lives in `~/Monty/<slug>`. `monty current`
 
 ```ts
 // monty.config.ts
+import { defineApp, montyFileSchema } from "@montytools/sdk";
+import { z } from "zod";
+
 export const app = defineApp({
   slug: "expenses",
   tables: {
@@ -47,13 +50,14 @@ export const app = defineApp({
       amount: z.number().positive(),
       status: z.enum(["draft", "submitted", "approved"]).default("draft"),
       assigneeId: z.string().optional(), // userId from useMembers()
+      receipt: montyFileSchema.optional(),
     }),
   },
 });
 ```
 
 ```tsx
-import { useList, useRecord, useInsert, useUpdate, useRemove, useMembers } from "@montytools/sdk/react";
+import { useList, useRecord, useInsert, useUpdate, useRemove, useMembers, useUploadFile, useFileUrl } from "@montytools/sdk/react";
 import { app } from "../../monty.config";
 
 const { data, status, loadMore } = useList(app, "expenses", {
@@ -81,6 +85,11 @@ await remove(row._id);
 
 const one = useRecord(app, "expenses", idOrNull);       // row | null(missing or no selection) | undefined(loading)
 const members = useMembers();                           // [{ userId, name, email, imageUrl, role }]
+
+const uploadFile = useUploadFile(app);                  // File/Blob -> MontyFile descriptor
+const receipt = await uploadFile(input.files[0]);
+await update(row._id, { receipt });                     // store descriptor, not bytes
+const { url } = useFileUrl(app, row.receipt);            // authenticated blob: URL for previews/downloads
 ```
 
 ## Errors are instructions
@@ -97,6 +106,7 @@ Every platform error is one line shaped like:
 | `NOT_FOUND` | Stale, foreign, or WRONG-TABLE record id — ids come from `useList`/`useRecord` on the same table; never hard-code or mix them. |
 | `INVALID_SCHEMA` | A table field uses a reserved name (`_*`, `updatedAt`, `createdBy`) — rename it. |
 | `SCHEMA_DRIFT` (warning) | Stored rows predate your latest schema change; nothing crashes, but make changed fields `.optional()`/`.default(...)`. |
+| `FILE_TOO_LARGE` | Platform file uploads are currently capped at 10 MiB per file. |
 | `UNAUTHENTICATED` / `NO_ACTIVE_WORKSPACE` | App isn't running through the Monty host/dev shell. |
 | `MISSING_ENV` / `NO_PROVIDER` | `.env.local` or the `<MontyProvider>` in `main.tsx` was removed. |
 
@@ -136,6 +146,8 @@ confirms it.
 
 - Rows, not embedded arrays: a comments thread is a `comments` table with a
   `parentId` field, not an array inside a record (records cap at 1 MiB).
+- Files are `montyFileSchema` descriptors in records; bytes live in platform
+  storage and are previewed with `useFileUrl(app, file)`.
 - People are `z.string()` userIds from `useMembers()`; render names/avatars
   from the member list.
 - Timestamps are `z.number()` epochs or `z.iso.datetime()` strings — never

package/template/package.json

@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@fontsource-variable/roboto": "^5.2.10",
-    "@montytools/sdk": "^0.1.1",
+    "@montytools/sdk": "^0.1.2",
     "@tanstack/react-router": "1.170.17",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",