pyric-tools 0.1.0-alpha.7

package/dist/serve/state-store.js

@@ -0,0 +1,120 @@
+/**
+ * On-disk state store for `pyric dev --persist` — the substrate side of
+ * flow doc section 3c ("persistence = an autosaved seed").
+ *
+ * The file is an ENVELOPE around two sections:
+ *   - `firestore`: the `pyric/sandbox` persistence controller's own blob
+ *     (`{version, savedAt, firestore: {path: fields}}`), stored verbatim as
+ *     parsed JSON. The page's controller wrote it and will read it back
+ *     through its own (de)serializer — wrapper types (Timestamp, Bytes, …)
+ *     live as marker shapes and re-hydrate to class instances on restore.
+ *     This store never interprets it.
+ *   - `auth`: `{users: SeedUser[]}` — what `sandbox.exportUsers` emits and
+ *     `sandbox.seedUsers` accepts.
+ *
+ * Everything is plain, diffable JSON on purpose: the persisted state
+ * doubles as a context artifact agents can read and promote to a fixture
+ * (`pyric snapshot`, plan P3).
+ *
+ * Durability stance (judgment zone 6, recorded): writes are atomic
+ * (tmp + rename, same volume) so a crash never truncates the file. A
+ * CORRUPT or version-mismatched file makes `load()` throw rather than
+ * silently discarding user data — serve fails fast and tells the user to
+ * inspect or delete it. Last-writer-wins between section writes is
+ * accepted (single serve process, sync fs — effectively serialized).
+ */
+import { copyFileSync, mkdirSync, readFileSync, renameSync, writeFileSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export const STATE_FILE_VERSION = 1;
+/** Expected inner version of the sandbox persistence controller's blob.
+ *  MIRRORS pyric's `serialize.ts` `SCHEMA_VERSION` — bump in lockstep when
+ *  pyric does (they ship together). Drift-risk noted: not importable
+ *  (pyric doesn't export it), so a check, not a re-use. */
+export const EXPECTED_CONTROLLER_BLOB_VERSION = 1;
+export class StateFileError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StateFileError';
+    }
+}
+export const STATE_RELATIVE_PATH = join('.pyric', 'state', 'state.json');
+export function createStateStore(projectDir) {
+    const path = join(projectDir, STATE_RELATIVE_PATH);
+    const backupPath = `${path}.bak`;
+    const load = () => {
+        if (!existsSync(path))
+            return null;
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch (e) {
+            throw new StateFileError(`state file at ${path} is not valid JSON (${e instanceof Error ? e.message : String(e)}). ` +
+                'Inspect or delete it to continue — pyric will not overwrite it silently.');
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new StateFileError(`state file at ${path} is not an object.`);
+        }
+        const file = parsed;
+        if (file.version !== STATE_FILE_VERSION) {
+            throw new StateFileError(`state file at ${path} has version ${String(file.version)}; this pyric-tools expects ` +
+                `${STATE_FILE_VERSION}. Delete it (or promote it with a matching pyric-tools) to continue.`);
+        }
+        // Inner controller-blob version (pre-mortem #6): the page's
+        // `deserializeSnapshot` validates this at restore — so a pyric upgrade
+        // that bumps its SCHEMA_VERSION would otherwise fail IN THE PAGE while
+        // the banner cheerfully reports "N docs restored". Peek it server-side
+        // and fail fast here instead. (Read-only peek; the section is still
+        // never re-encoded.) EXPECTED_CONTROLLER_BLOB_VERSION mirrors pyric's
+        // serialize `SCHEMA_VERSION` and must bump in lockstep — they ship
+        // together in this monorepo.
+        const inner = file.firestore?.version;
+        if (inner !== undefined && inner !== EXPECTED_CONTROLLER_BLOB_VERSION) {
+            throw new StateFileError(`state file at ${path} holds a firestore blob of version ${String(inner)}; this ` +
+                `pyric expects ${EXPECTED_CONTROLLER_BLOB_VERSION} (pyric was likely upgraded). ` +
+                'Delete the state file or re-promote it with a matching pyric to continue.');
+        }
+        return file;
+    };
+    const writeAtomic = (file) => {
+        mkdirSync(dirname(path), { recursive: true });
+        const tmp = `${path}.tmp-${process.pid}`;
+        writeFileSync(tmp, JSON.stringify(file, null, 2) + '\n', 'utf8');
+        renameSync(tmp, path); // same volume — atomic replace
+    };
+    return {
+        projectDir,
+        path,
+        backupPath,
+        load,
+        exists: () => existsSync(path),
+        readSection(section) {
+            return load()?.[section] ?? null;
+        },
+        writeSection(section, value) {
+            const current = load() ?? { version: STATE_FILE_VERSION, firestore: null, auth: null };
+            // Data-loss guard (flow doc section 3c / pre-mortem #2): a `sandbox.reset()`
+            // makes the persistence controller flush EMPTY firestore over the
+            // live file (pyric flushes on session_boundary by design), and the
+            // backend write can't tell that from a legitimate delete-all. Before
+            // a firestore write would collapse a NON-empty doc set to empty, keep
+            // the prior file as `.bak` (one-deep) so it's recoverable. Intent-
+            // agnostic on purpose — covers reset, agent error, and accidental
+            // delete-all uniformly.
+            if (section === 'firestore' &&
+                firestoreDocCount(value) === 0 &&
+                firestoreDocCount(current.firestore) > 0 &&
+                existsSync(path)) {
+                copyFileSync(path, backupPath);
+            }
+            writeAtomic({ ...current, [section]: value });
+        },
+    };
+}
+/** Doc count inside a controller firestore blob (`{…, firestore: {path:
+ *  fields}}`), 0 for null/empty/malformed. */
+export function firestoreDocCount(section) {
+    const docs = section?.firestore;
+    return docs && typeof docs === 'object' ? Object.keys(docs).length : 0;
+}
+//# sourceMappingURL=state-store.js.map

package/dist/serve/state-store.js.map

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

package/dist/serve/studio/disk-project-store.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectStore } from './store-types.js';
+/** Thrown when an id isn't a safe single path segment. */
+export declare class ProjectIdError extends Error {
+    constructor(id: string);
+}
+/** Slug a title into a filesystem-safe id segment. */
+export declare function slugifyProjectId(title: string): string;
+export declare function diskProjectStore(rootDir: string): ProjectStore;
+//# sourceMappingURL=disk-project-store.d.ts.map

package/dist/serve/studio/disk-project-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-project-store.d.ts","sourceRoot":"","sources":["../../../src/serve/studio/disk-project-store.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,kBAAkB,CAAC;AAI1B,0DAA0D;AAC1D,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,EAAE,EAAE,MAAM;CAIvB;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtD;AASD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAsI9D"}

package/dist/serve/studio/disk-project-store.js

@@ -0,0 +1,173 @@
+/**
+ * `diskProjectStore(root)` — a {@link ProjectStore} where each project is a
+ * subdirectory of `root` carrying a small metadata file (`.pyric-project.json`,
+ * shape {@link ProjectMeta}). `open(id)` hands back a {@link ProjectHandle}
+ * whose `workspace` is a {@link diskWorkspace} rooted at that subdirectory.
+ *
+ * Project ids ARE the directory names; they're slugged from the title (or
+ * generated) and validated to a safe charset so an id can never traverse out of
+ * `root`. The metadata file lives alongside the project's working tree — it's
+ * skipped by `diskWorkspace.list` callers only by convention (the file tree
+ * shows it; that's acceptable for a `.pyric-*` dotfile).
+ */
+import { mkdir, readFile, readdir, rm, stat, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { diskWorkspace } from './disk-workspace.js';
+const META_FILE = '.pyric-project.json';
+/** Thrown when an id isn't a safe single path segment. */
+export class ProjectIdError extends Error {
+    constructor(id) {
+        super(`invalid project id: '${id}'`);
+        this.name = 'ProjectIdError';
+    }
+}
+/** Slug a title into a filesystem-safe id segment. */
+export function slugifyProjectId(title) {
+    const slug = title
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 48);
+    return slug;
+}
+/** A safe id is a single non-dot path segment of `[a-z0-9-_]`. */
+function assertSafeId(id) {
+    if (!/^[a-z0-9][a-z0-9_-]*$/.test(id) || id.includes('/') || id.includes('..')) {
+        throw new ProjectIdError(id);
+    }
+}
+export function diskProjectStore(rootDir) {
+    const root = resolve(rootDir);
+    function projectDir(id) {
+        assertSafeId(id);
+        return join(root, id);
+    }
+    async function readMeta(id) {
+        try {
+            const raw = await readFile(join(projectDir(id), META_FILE), 'utf8');
+            const parsed = JSON.parse(raw);
+            const now = Date.now();
+            return {
+                id,
+                title: typeof parsed.title === 'string' ? parsed.title : id,
+                createdAt: typeof parsed.createdAt === 'number' ? parsed.createdAt : now,
+                updatedAt: typeof parsed.updatedAt === 'number' ? parsed.updatedAt : now,
+            };
+        }
+        catch (e) {
+            if (e.code === 'ENOENT')
+                return null;
+            throw e;
+        }
+    }
+    async function writeMeta(meta) {
+        const dir = projectDir(meta.id);
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, META_FILE), JSON.stringify(meta, null, 2) + '\n', 'utf8');
+    }
+    return {
+        async list() {
+            let names;
+            try {
+                names = await readdir(root);
+            }
+            catch (e) {
+                if (e.code === 'ENOENT')
+                    return [];
+                throw e;
+            }
+            const metas = [];
+            for (const name of names) {
+                if (name.startsWith('.'))
+                    continue;
+                let isDir = false;
+                try {
+                    isDir = (await stat(join(root, name))).isDirectory();
+                }
+                catch {
+                    continue;
+                }
+                if (!isDir)
+                    continue;
+                try {
+                    const meta = await readMeta(name);
+                    // A directory without a meta file is still a project — synthesize.
+                    metas.push(meta ?? {
+                        id: name,
+                        title: name,
+                        createdAt: 0,
+                        updatedAt: 0,
+                    });
+                }
+                catch (e) {
+                    if (e instanceof ProjectIdError)
+                        continue; // not a valid project dir
+                    throw e;
+                }
+            }
+            metas.sort((a, b) => b.updatedAt - a.updatedAt);
+            return metas;
+        },
+        async open(id) {
+            const dir = projectDir(id);
+            let meta = await readMeta(id);
+            if (meta === null) {
+                // Allow opening a bare directory that exists but lacks metadata.
+                try {
+                    if ((await stat(dir)).isDirectory()) {
+                        meta = { id, title: id, createdAt: Date.now(), updatedAt: Date.now() };
+                    }
+                }
+                catch {
+                    /* fall through to throw */
+                }
+            }
+            if (meta === null) {
+                throw new Error(`project not found: '${id}'`);
+            }
+            const handle = {
+                meta,
+                workspace: diskWorkspace(dir),
+            };
+            return handle;
+        },
+        async create(input) {
+            const title = input.title?.trim() || 'untitled';
+            const base = slugifyProjectId(title) || 'project';
+            // Disambiguate against existing dirs.
+            let id = base;
+            let n = 1;
+            while (true) {
+                try {
+                    await stat(join(root, id));
+                    id = `${base}-${++n}`;
+                }
+                catch {
+                    break; // free
+                }
+            }
+            const now = Date.now();
+            const meta = { id, title, createdAt: now, updatedAt: now };
+            await writeMeta(meta);
+            return meta;
+        },
+        async update(id, patch) {
+            const existing = await readMeta(id);
+            if (existing === null)
+                throw new Error(`project not found: '${id}'`);
+            const next = {
+                ...existing,
+                ...patch,
+                id, // id is immutable
+                updatedAt: Date.now(),
+            };
+            await writeMeta(next);
+        },
+        async remove(id) {
+            const dir = projectDir(id);
+            await rm(dir, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=disk-project-store.js.map

package/dist/serve/studio/disk-project-store.js.map

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

package/dist/serve/studio/disk-workspace.d.ts

@@ -0,0 +1,14 @@
+import type { WorkspaceStore } from './store-types.js';
+/** Thrown when a request path escapes the workspace root. */
+export declare class WorkspacePathError extends Error {
+    constructor(path: string);
+}
+/**
+ * Resolve a project-relative POSIX path to an absolute OS path inside `root`,
+ * or throw {@link WorkspacePathError} if it would escape. Leading slashes are
+ * stripped (treated as project-root-relative); empty / `.` resolves to the
+ * root itself.
+ */
+export declare function resolveWorkspacePath(root: string, rel: string): string;
+export declare function diskWorkspace(dir: string): WorkspaceStore;
+//# sourceMappingURL=disk-workspace.d.ts.map

package/dist/serve/studio/disk-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-workspace.d.ts","sourceRoot":"","sources":["../../../src/serve/studio/disk-workspace.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,6DAA6D;AAC7D,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,IAAI,EAAE,MAAM;CAIzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAatE;AAOD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAmGzD"}

package/dist/serve/studio/disk-workspace.js

@@ -0,0 +1,152 @@
+/**
+ * `diskWorkspace(dir)` — a {@link WorkspaceStore} over a real filesystem
+ * directory (the Studio `local` mode's project file tree, served at
+ * `/__pyric/workspace`).
+ *
+ * Paths are project-relative POSIX strings (`src/app.tsx`, `firestore.rules`).
+ * Every op resolves the path inside `dir` and REFUSES anything that escapes the
+ * root (`..` traversal, absolute paths) — the same posture the static server
+ * takes for `publicDir`. `watch(cb)` uses a recursive `fs.watch` and reports
+ * create/update/delete as {@link WorkspaceChange} events.
+ */
+import { mkdir, readFile, readdir, rm, stat, writeFile, } from 'node:fs/promises';
+import { existsSync, mkdirSync, watch as fsWatch } from 'node:fs';
+import { dirname, join, posix, relative, resolve, sep } from 'node:path';
+/** Thrown when a request path escapes the workspace root. */
+export class WorkspacePathError extends Error {
+    constructor(path) {
+        super(`workspace path escapes root: '${path}'`);
+        this.name = 'WorkspacePathError';
+    }
+}
+/**
+ * Resolve a project-relative POSIX path to an absolute OS path inside `root`,
+ * or throw {@link WorkspacePathError} if it would escape. Leading slashes are
+ * stripped (treated as project-root-relative); empty / `.` resolves to the
+ * root itself.
+ */
+export function resolveWorkspacePath(root, rel) {
+    const cleaned = rel.replace(/^\/+/, '');
+    // Normalize via POSIX semantics first so `a/../b` collapses predictably,
+    // then map separators to the host OS.
+    const normalized = posix.normalize(cleaned === '' ? '.' : cleaned);
+    if (normalized === '..' || normalized.startsWith('../')) {
+        throw new WorkspacePathError(rel);
+    }
+    const abs = resolve(root, normalized.split('/').join(sep));
+    if (abs !== root && !abs.startsWith(root + sep)) {
+        throw new WorkspacePathError(rel);
+    }
+    return abs;
+}
+/** Convert an absolute OS path under `root` to a project-relative POSIX path. */
+function toPosixRel(root, abs) {
+    return relative(root, abs).split(sep).join('/');
+}
+export function diskWorkspace(dir) {
+    const root = resolve(dir);
+    return {
+        async read(path) {
+            const abs = resolveWorkspacePath(root, path);
+            try {
+                return await readFile(abs, 'utf8');
+            }
+            catch (e) {
+                if (e.code === 'ENOENT')
+                    return null;
+                // A directory read errors as EISDIR — treat as "no file content".
+                if (e.code === 'EISDIR')
+                    return null;
+                throw e;
+            }
+        },
+        async write(path, content) {
+            const abs = resolveWorkspacePath(root, path);
+            await mkdir(dirname(abs), { recursive: true });
+            await writeFile(abs, content, 'utf8');
+        },
+        async list(dir) {
+            const abs = resolveWorkspacePath(root, dir ?? '');
+            let names;
+            try {
+                names = await readdir(abs);
+            }
+            catch (e) {
+                if (e.code === 'ENOENT')
+                    return [];
+                throw e;
+            }
+            const entries = [];
+            for (const name of names) {
+                const childAbs = join(abs, name);
+                let isDir = false;
+                try {
+                    isDir = (await stat(childAbs)).isDirectory();
+                }
+                catch {
+                    continue; // raced away between readdir and stat
+                }
+                entries.push({
+                    path: toPosixRel(root, childAbs),
+                    kind: isDir ? 'dir' : 'file',
+                });
+            }
+            entries.sort((a, b) => a.path.localeCompare(b.path));
+            return entries;
+        },
+        async remove(path) {
+            const abs = resolveWorkspacePath(root, path);
+            if (abs === root)
+                throw new WorkspacePathError(path); // never nuke the root
+            await rm(abs, { recursive: true, force: true });
+        },
+        watch(cb) {
+            if (!existsSync(root)) {
+                try {
+                    // best-effort: ensure the dir exists so the watcher can attach.
+                    mkdirSync(root, { recursive: true });
+                }
+                catch {
+                    /* watcher just won't fire */
+                }
+            }
+            let watcher = null;
+            try {
+                watcher = fsWatch(root, { recursive: true }, (_event, filename) => {
+                    if (filename == null)
+                        return;
+                    const relPath = String(filename).split(sep).join('/');
+                    // fs.watch doesn't tell us create vs update vs delete reliably across
+                    // platforms; derive it from current existence.
+                    let abs;
+                    try {
+                        abs = resolveWorkspacePath(root, relPath);
+                    }
+                    catch {
+                        return; // ignore anything outside the root
+                    }
+                    const type = existsSync(abs)
+                        ? 'update'
+                        : 'delete';
+                    cb({ path: relPath, type });
+                });
+            }
+            catch {
+                // Recursive watch unsupported here — degrade to no live updates.
+                return () => { };
+            }
+            // Watcher failure (EMFILE, root renamed) must not surface as an
+            // unhandled 'error' event — that would kill the serve process.
+            // Degrade to no live updates instead.
+            watcher.on('error', () => {
+                watcher?.close();
+                watcher = null;
+            });
+            return () => {
+                watcher?.close();
+                watcher = null;
+            };
+        },
+    };
+}
+//# sourceMappingURL=disk-workspace.js.map

package/dist/serve/studio/disk-workspace.js.map

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

package/dist/serve/studio/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Studio storage (Track T3) — disk-backed `WorkspaceStore` / `ProjectStore`
+ * impls + the `/__pyric/workspace` and `/__pyric/projects` serve routes that
+ * `@pyric/studio`'s `local` mode talks to. See the design rationale.
+ */
+export { diskWorkspace, resolveWorkspacePath, WorkspacePathError } from './disk-workspace.js';
+export { diskProjectStore, slugifyProjectId, ProjectIdError, } from './disk-project-store.js';
+export { createStudioRoutes, type StudioRouteOptions } from './routes.js';
+export type { ProjectHandle, ProjectMeta, ProjectStore, WorkspaceChange, WorkspaceEntry, WorkspaceStore, } from './store-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/serve/studio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/serve/studio/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/serve/studio/index.js

@@ -0,0 +1,9 @@
+/**
+ * Studio storage (Track T3) — disk-backed `WorkspaceStore` / `ProjectStore`
+ * impls + the `/__pyric/workspace` and `/__pyric/projects` serve routes that
+ * `@pyric/studio`'s `local` mode talks to. See the design rationale.
+ */
+export { diskWorkspace, resolveWorkspacePath, WorkspacePathError } from './disk-workspace.js';
+export { diskProjectStore, slugifyProjectId, ProjectIdError, } from './disk-project-store.js';
+export { createStudioRoutes } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/serve/studio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/serve/studio/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAA2B,MAAM,aAAa,CAAC"}

package/dist/serve/studio/routes.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Studio storage routes — the HTTP surface for `@pyric/studio` in `local` mode.
+ * Mounted inside the `/__pyric/` namespace; the browser-side `httpWorkspace`
+ * / `httpProjectStore` clients in `packages/studio/src/clients` speak exactly
+ * these endpoints.
+ *
+ *   WORKSPACE (a single project's file tree)
+ *     GET    /__pyric/workspace?path=src/app.tsx  → file body (200) | 404
+ *     PUT    /__pyric/workspace?path=...          → write body (204)
+ *     DELETE /__pyric/workspace?path=...          → remove (204)
+ *     GET    /__pyric/workspace/list?dir=src      → WorkspaceEntry[] (200)
+ *     GET    /__pyric/workspace/watch             → SSE stream of WorkspaceChange
+ *
+ *   PROJECTS (sessions/projects)
+ *     GET    /__pyric/projects                     → ProjectMeta[] (200)
+ *     POST   /__pyric/projects   {title?}          → ProjectMeta (created) (200)
+ *     GET    /__pyric/projects/<id>                → ProjectMeta (200) | 404
+ *     PATCH  /__pyric/projects/<id>  {title?,...}  → (204)
+ *     DELETE /__pyric/projects/<id>                → (204)
+ *
+ * The `watch` stream reuses the SSE pattern already used for `/__pyric/events`
+ * (the hot-reload hub): one `text/event-stream` response per subscriber, frames
+ * are `event: change\ndata: <json>\n\n`, and the subscription is torn down on
+ * `req.close`.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ProjectStore, WorkspaceStore } from './store-types.js';
+export interface StudioRouteOptions {
+    /** The single-project file tree served at `/__pyric/workspace`. */
+    workspace?: WorkspaceStore;
+    /** The project list served at `/__pyric/projects`. */
+    projects?: ProjectStore;
+}
+/**
+ * Build a namespace fragment for the Studio storage routes. Returns a handler
+ * shaped like the other `/__pyric/*` fragments: it resolves `true` when it
+ * owned the request, `false` otherwise (so the caller can fall through).
+ */
+export declare function createStudioRoutes(opts: StudioRouteOptions): (req: IncomingMessage, res: ServerResponse, url: URL) => Promise<boolean>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/serve/studio/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/serve/studio/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIjE,OAAO,KAAK,EAEV,YAAY,EAEZ,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAwKD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,IAEvD,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,GAAG,KACP,OAAO,CAAC,OAAO,CAAC,CAiBpB"}