@jxsuite/protocol 3.0.0 → 5.0.0

package/README.md

@@ -7,11 +7,11 @@ The **Studio Backend Protocol**: the wire types and canonical route table that e
 
 ## Who implements this
 
-| Backend                         | Transport                                                                                                 |
-| ------------------------------- | --------------------------------------------------------------------------------------------------------- |
-| `@jxsuite/server` (dev server)  | The literal `/__studio/*` HTTP routes (the reference implementation)                                      |
-| Desktop (Electrobun / Chromium) | Typed RPC / WebSocket JSON-RPC dispatching into the same handlers                                         |
-| Cloud platforms                 | HTTP behind a session gateway (e.g. `/api/v1/p/:owner/:repo/:branch/studio/*`), same sub-paths and shapes |
+| Backend                        | Transport                                                                                                 |
+| ------------------------------ | --------------------------------------------------------------------------------------------------------- |
+| `@jxsuite/server` (dev server) | The literal `/__studio/*` HTTP routes (the reference implementation)                                      |
+| Desktop (Electron / Chromium)  | Typed RPC / WebSocket JSON-RPC dispatching into the same handlers                                         |
+| Cloud platforms                | HTTP behind a session gateway (e.g. `/api/v1/p/:owner/:repo/:branch/studio/*`), same sub-paths and shapes |
 
 A backend is free to change the transport and path prefix; the **sub-path, method, and body shapes are the contract**. `STUDIO_PROTOCOL_VERSION` bumps when any shape changes incompatibly.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jxsuite/protocol",
-  "version": "3.0.0",
+  "version": "5.0.0",
   "description": "The Studio Backend Protocol — wire types and the canonical route table every Jx Studio backend implements",
   "license": "MIT",
   "repository": {
@@ -27,6 +27,6 @@
     "test:coverage": "bun test --isolate --coverage"
   },
   "dependencies": {
-    "@jxsuite/schema": "^4.0.0"
+    "@jxsuite/schema": "^4.1.0"
   }
 }

package/src/routes.ts

@@ -12,17 +12,6 @@
 /** Bumped when a route's request/response shape changes incompatibly. */
 export const STUDIO_PROTOCOL_VERSION = 1;
 
-/**
- * Hidden file a browser-hosted Studio drops into a folder chosen with `showDirectoryPicker()` so
- * the backend can find it (specs/desktop.md §8.2.1). Its contents are a one-shot random id; the
- * backend matches on those contents, not on the filename, and deletes the file once it matches.
- *
- * Lives here because the writer (`@jxsuite/studio/directory-picker`) and the reader (the backend
- * serving `locateDirectory`) must agree on it, and this package is the contract both already
- * share.
- */
-export const LOCATION_ID_FILE = ".jx-loc-id";
-
 export type StudioRouteMethod = "GET" | "POST" | "PUT" | "DELETE";
 
 export interface StudioRoute {
@@ -81,18 +70,6 @@ export const STUDIO_ROUTES = {
     "Enumerate site projects [{config, path}] (backs listProjects)",
     "The welcome screen's Projects catalogue stays hidden.",
   ),
-  findProject: route(
-    "GET",
-    "/__studio/find-project",
-    "Locate a project directory by name outside the root",
-    "openProject falls back to config-matching only.",
-  ),
-  locateDirectory: route(
-    "GET",
-    "/__studio/locate-directory",
-    `Resolve the absolute path of a showDirectoryPicker() folder by the id in its ${LOCATION_ID_FILE}`,
-    "Browse… reports that the folder could not be placed; the Location is typed by hand.",
-  ),
   createProject: route(
     "POST",
     "/__studio/create-project",

package/src/types.ts

@@ -223,6 +223,12 @@ export interface GitStatusResult {
 export interface GitBranchesResult {
   current: string;
   branches: string[];
+  /**
+   * The repository's default branch (the one a pull request merges into), when the host knows it. A
+   * host whose branches are sessions reports it so a review is never committed to the live branch;
+   * a local repository may omit it.
+   */
+  defaultBranch?: string;
 }
 
 export interface GitLogEntry {