@jxsuite/protocol 4.0.0 → 6.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jxsuite/protocol",
-  "version": "4.0.0",
+  "version": "6.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": "^5.0.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",
@@ -358,13 +335,21 @@ export const STUDIO_ROUTES = {
 
   // ─── Packages ─────────────────────────────────────────────────────────────
   packages: route("GET", "/__studio/packages", "List dependencies (PackageInfo[])"),
-  packagesAdd: route("POST", "/__studio/packages/add", "Add a dependency"),
-  packagesRemove: route("POST", "/__studio/packages/remove", "Remove a dependency"),
+  packagesAdd: route(
+    "POST",
+    "/__studio/packages/add",
+    "Add a registry dependency, writing package.json and package-lock.json together",
+  ),
+  packagesRemove: route(
+    "POST",
+    "/__studio/packages/remove",
+    "Remove a dependency, writing package.json and package-lock.json together",
+  ),
   packagesInstall: route(
     "POST",
     "/__studio/packages/install",
-    "Run the package manager install",
-    "Install/reinstall affordances are hidden; manifest-only edits still work.",
+    "Install the declared dependencies (npm's installer, writing package-lock.json)",
+    "Install/reinstall affordances are hidden; add, remove and version updates still work where the backend serves them (a cloud session updates the lockfile without installing).",
   ),
   packagesNeedsInstall: route(
     "GET",
@@ -381,7 +366,7 @@ export const STUDIO_ROUTES = {
   packagesSetVersions: route(
     "POST",
     "/__studio/packages/set-versions",
-    "Rewrite dependency ranges and install",
+    "Rewrite dependency ranges and install (lockfile-only where nothing installs)",
     "Bulk version updates are hidden.",
   ),
 

package/src/types.ts

@@ -328,7 +328,7 @@ export interface ExtensionSectionInfo {
 
 /** One extension a backend can offer a project, whether or not the project enables it. */
 export interface ExtensionCatalogEntry {
-  /** Package name: the identity, and the `bun add` argument. */
+  /** Package name: the identity, and the argument an add passes the installer. */
   name: string;
   /**
    * The string that goes in `project.json` `extensions[]`. Usually `name`, but a linked or
@@ -350,12 +350,6 @@ export interface ExtensionCatalogEntry {
   formats?: string[];
   /** Other catalogue members it depends on — auth needs connector. */
   requires?: string[];
-  /**
-   * THIS host resolves the package without a project install, so enabling it is a config write
-   * alone. Probed per host, never declared: what a desktop build stages and what a Worker bundles
-   * are different facts, and neither is knowable from the package list.
-   */
-  bundled?: boolean;
   /**
    * The PROJECT resolves it.
    *
@@ -590,7 +584,7 @@ export interface PackageVersionInfo {
   dev?: boolean;
 }
 
-/** Result of a package mutation that runs `bun install` (install / set-versions). */
+/** Result of a package mutation that runs an install (install / set-versions). */
 export interface PackageOpResult {
   ok: boolean;
   /** Combined stdout/stderr from the bun invocation, surfaced to the user on failure. */