@bongos/core 1.24.29 → 1.24.31

package/clients/bongos-client/README.md

@@ -5,7 +5,7 @@ A **generated**, zero-dependency typed client for the Bongos API — produced fr
 by hand; it regenerates when the spec changes, so it can never drift from the routes.
 
 - API version: **v1** (served at `/api/bongos/v1`)
-- 679 operations across 84 resource groups
+- 684 operations across 85 resource groups
 
 ## Use it from your project
 

package/clients/bongos-client/bongos-client.global.js

@@ -393,6 +393,8 @@ function createClient(opts = {}) {
       getCopyDeskQueue: (args) => request("GET", "/copy-desk/queue", { hasBody: false }, args),
       // GET /copy-desk/strings — rank: any-builder — GET /copy-desk/strings
       getCopyDeskStrings: (args) => request("GET", "/copy-desk/strings", { hasBody: false }, args),
+      // GET /copy-desk/studio — rank: any-builder — GET /copy-desk/studio
+      getCopyDeskStudio: (args) => request("GET", "/copy-desk/studio", { hasBody: false }, args),
       // GET /copy-desk/tally — rank: any-builder — GET /copy-desk/tally
       getCopyDeskTally: (args) => request("GET", "/copy-desk/tally", { hasBody: false }, args),
     },
@@ -702,6 +704,16 @@ function createClient(opts = {}) {
       // GET /help-requests/mine — rank: any-builder — GET /help-requests/mine
       getHelpRequestsMine: (args) => request("GET", "/help-requests/mine", { hasBody: false }, args),
     },
+    "home": {
+      // GET /home/city — rank: any-builder — GET /home/city
+      getHomeCity: (args) => request("GET", "/home/city", { hasBody: false }, args),
+      // GET /home/gallery — rank: any-builder — GET /home/gallery
+      getHomeGallery: (args) => request("GET", "/home/gallery", { hasBody: false }, args),
+      // PUT /home/gallery/{id}/heart — rank: any-builder — PUT /home/gallery/:id/heart
+      putHomeGalleryIdHeart: (args) => request("PUT", "/home/gallery/{id}/heart", { hasBody: true }, args),
+      // GET /home/studio/works — rank: any-builder — GET /home/studio/works
+      getHomeStudioWorks: (args) => request("GET", "/home/studio/works", { hasBody: false }, args),
+    },
     "inbox": {
       // GET /inbox — rank: any-builder — GET /inbox
       getInbox: (args) => request("GET", "/inbox", { hasBody: false }, args),

package/clients/bongos-client/index.cjs

@@ -392,6 +392,8 @@ function createClient(opts = {}) {
       getCopyDeskQueue: (args) => request("GET", "/copy-desk/queue", { hasBody: false }, args),
       // GET /copy-desk/strings — rank: any-builder — GET /copy-desk/strings
       getCopyDeskStrings: (args) => request("GET", "/copy-desk/strings", { hasBody: false }, args),
+      // GET /copy-desk/studio — rank: any-builder — GET /copy-desk/studio
+      getCopyDeskStudio: (args) => request("GET", "/copy-desk/studio", { hasBody: false }, args),
       // GET /copy-desk/tally — rank: any-builder — GET /copy-desk/tally
       getCopyDeskTally: (args) => request("GET", "/copy-desk/tally", { hasBody: false }, args),
     },
@@ -701,6 +703,16 @@ function createClient(opts = {}) {
       // GET /help-requests/mine — rank: any-builder — GET /help-requests/mine
       getHelpRequestsMine: (args) => request("GET", "/help-requests/mine", { hasBody: false }, args),
     },
+    "home": {
+      // GET /home/city — rank: any-builder — GET /home/city
+      getHomeCity: (args) => request("GET", "/home/city", { hasBody: false }, args),
+      // GET /home/gallery — rank: any-builder — GET /home/gallery
+      getHomeGallery: (args) => request("GET", "/home/gallery", { hasBody: false }, args),
+      // PUT /home/gallery/{id}/heart — rank: any-builder — PUT /home/gallery/:id/heart
+      putHomeGalleryIdHeart: (args) => request("PUT", "/home/gallery/{id}/heart", { hasBody: true }, args),
+      // GET /home/studio/works — rank: any-builder — GET /home/studio/works
+      getHomeStudioWorks: (args) => request("GET", "/home/studio/works", { hasBody: false }, args),
+    },
     "inbox": {
       // GET /inbox — rank: any-builder — GET /inbox
       getInbox: (args) => request("GET", "/inbox", { hasBody: false }, args),

package/clients/bongos-client/index.d.ts

@@ -1045,6 +1045,8 @@ export interface BongosClient {
     getCopyDeskQueue(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /copy-desk/strings — rank: any-builder */
     getCopyDeskStrings(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /copy-desk/studio — rank: any-builder */
+    getCopyDeskStudio(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /copy-desk/tally — rank: any-builder */
     getCopyDeskTally(args?: RequestArgs): Promise<ApiResponse>;
   };
@@ -1354,6 +1356,16 @@ export interface BongosClient {
     /** GET /help-requests/mine — rank: any-builder */
     getHelpRequestsMine(args?: RequestArgs): Promise<GetHelpRequestsMineResponse>;
   };
+  "home": {
+    /** GET /home/city — rank: any-builder */
+    getHomeCity(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /home/gallery — rank: any-builder */
+    getHomeGallery(args?: RequestArgs): Promise<ApiResponse>;
+    /** PUT /home/gallery/{id}/heart — rank: any-builder */
+    putHomeGalleryIdHeart(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /home/studio/works — rank: any-builder */
+    getHomeStudioWorks(args?: RequestArgs): Promise<ApiResponse>;
+  };
   "inbox": {
     /** GET /inbox — rank: any-builder */
     getInbox(args?: RequestArgs): Promise<GetInboxResponse>;

package/clients/bongos-client/index.mjs

@@ -389,6 +389,8 @@ export function createClient(opts = {}) {
       getCopyDeskQueue: (args) => request("GET", "/copy-desk/queue", { hasBody: false }, args),
       // GET /copy-desk/strings — rank: any-builder — GET /copy-desk/strings
       getCopyDeskStrings: (args) => request("GET", "/copy-desk/strings", { hasBody: false }, args),
+      // GET /copy-desk/studio — rank: any-builder — GET /copy-desk/studio
+      getCopyDeskStudio: (args) => request("GET", "/copy-desk/studio", { hasBody: false }, args),
       // GET /copy-desk/tally — rank: any-builder — GET /copy-desk/tally
       getCopyDeskTally: (args) => request("GET", "/copy-desk/tally", { hasBody: false }, args),
     },
@@ -698,6 +700,16 @@ export function createClient(opts = {}) {
       // GET /help-requests/mine — rank: any-builder — GET /help-requests/mine
       getHelpRequestsMine: (args) => request("GET", "/help-requests/mine", { hasBody: false }, args),
     },
+    "home": {
+      // GET /home/city — rank: any-builder — GET /home/city
+      getHomeCity: (args) => request("GET", "/home/city", { hasBody: false }, args),
+      // GET /home/gallery — rank: any-builder — GET /home/gallery
+      getHomeGallery: (args) => request("GET", "/home/gallery", { hasBody: false }, args),
+      // PUT /home/gallery/{id}/heart — rank: any-builder — PUT /home/gallery/:id/heart
+      putHomeGalleryIdHeart: (args) => request("PUT", "/home/gallery/{id}/heart", { hasBody: true }, args),
+      // GET /home/studio/works — rank: any-builder — GET /home/studio/works
+      getHomeStudioWorks: (args) => request("GET", "/home/studio/works", { hasBody: false }, args),
+    },
     "inbox": {
       // GET /inbox — rank: any-builder — GET /inbox
       getInbox: (args) => request("GET", "/inbox", { hasBody: false }, args),

package/docs/api/openapi.json

@@ -177,6 +177,10 @@
       "name": "help-requests",
       "description": "Endpoints under `/api/bongos/help-requests`."
     },
+    {
+      "name": "home",
+      "description": "Endpoints under `/api/bongos/home`."
+    },
     {
       "name": "inbox",
       "description": "Endpoints under `/api/bongos/inbox`."
@@ -6228,6 +6232,37 @@
         ]
       }
     },
+    "/copy-desk/studio": {
+      "get": {
+        "operationId": "get_copy_desk_studio",
+        "tags": [
+          "copy-desk"
+        ],
+        "summary": "GET /copy-desk/studio",
+        "description": "GET /copy-desk/studio, the caller's easel, the pages waiting for an artist and the newest open flags. A work list, like /copy-desk/next and /copy-desk/queue, which any signed-in builder may already read.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/copy-desk/routes/copy-desk-studio.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/copy-desk/tally": {
       "get": {
         "operationId": "get_copy_desk_tally",
@@ -12885,6 +12920,144 @@
         ]
       }
     },
+    "/home/city": {
+      "get": {
+        "operationId": "get_home_city",
+        "tags": [
+          "home"
+        ],
+        "summary": "GET /home/city",
+        "description": "GET /home/city, the counts Home's city draws. Every number in it is a count of rows a signed-in builder can already list (shipped tasks, ideas, votes, open claims); the per-area \"waits on you\" half is the docket's routing for this viewer (task 1005056), computed inside the read. Nothing here is writable.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/home-city.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/home/gallery": {
+      "get": {
+        "operationId": "get_home_gallery",
+        "tags": [
+          "home"
+        ],
+        "summary": "GET /home/gallery",
+        "description": "GET /home/gallery?order=popular|latest, at most 60 works. Every work is a shipped task whose picture a signed-in builder can already open (the task-visuals audience); a work under a private goal the viewer cannot read is left off. Each carries its heart count and whether the viewer gave one.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/home-gallery.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/home/gallery/{id}/heart": {
+      "put": {
+        "operationId": "put_home_gallery_id_heart",
+        "tags": [
+          "home"
+        ],
+        "summary": "PUT /home/gallery/:id/heart",
+        "description": "PUT /home/gallery/:id/heart { on }. Appreciation, never a grade: one heart per builder per work, given or taken back by the builder themself (the caller, never the body). Refused for anything their wall would not hang.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/home-gallery.js",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `id`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/home/studio/works": {
+      "get": {
+        "operationId": "get_home_studio_works",
+        "tags": [
+          "home"
+        ],
+        "summary": "GET /home/studio/works",
+        "description": "GET /home/studio/works?page=<page id>, the studio's two shelves (task 1005061): the works the CALLER appreciated and the works the caller signed, at most six each, and the easel page's newest work, all by the wall's own rule.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/home-gallery.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/inbox": {
       "get": {
         "operationId": "get_inbox",
@@ -42734,7 +42907,7 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 679,
+  "x-endpoint-count": 684,
   "x-schema-count": 719,
   "x-undocumented-bodies": 12,
   "x-response-schemas": 457,

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 679 endpoints across 114 route files.
+> **Generated from the live route files** — the route file is authoritative. 684 endpoints across 117 route files.
 > Machine-readable spec: [`docs/api/openapi.json`](api/openapi.json) (OpenAPI 3.1). Rendered docs site: **`/docs`** (e.g. `cloudbongos.com/docs`).
 
 Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust-boundary-server-enforced-permissions.md)): `public` < `any-builder` < `metic+archon` < `archon`.
@@ -221,7 +221,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/connections/requests` | `any-builder` | — | MY pending requests, both directions (own data). |
 | GET | `/api/bongos/connections/suggestions` | `any-builder` | — | "builders you may know" (R21, task 1002297; ADR 0202 D5). |
 
-## `copy-desk` (21)
+## `copy-desk` (22)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -245,6 +245,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/copy-desk/proposals` | `any-builder` | `string_id`, `proposed_text`, `why`, `file`, `line`, `flag_id` | ------------------------------------------------------------------------- POST /copy-desk/proposals — an artist proposes new wording, and… |
 | GET | `/api/bongos/copy-desk/queue` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/queue — the artist's working list. |
 | GET | `/api/bongos/copy-desk/strings` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/strings — search the inventory, to find somethin… |
+| GET | `/api/bongos/copy-desk/studio` | `any-builder` | — | GET /copy-desk/studio, the caller's easel, the pages waiting for an artist and the newest open flags. |
 | GET | `/api/bongos/copy-desk/tally` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/tally — the caller's corner tally in the studio:… |
 
 ## `core-update` (1)
@@ -472,6 +473,15 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/help-requests/for-me` | `any-builder` | — | The addressed read — C01's answer to "and fires a notification". |
 | GET | `/api/bongos/help-requests/mine` | `any-builder` | — | your own asks, so you can settle them. |
 
+## `home` (4)
+
+| Method | Path | Rank | Body | Description |
+|---|---|---|---|---|
+| GET | `/api/bongos/home/city` | `any-builder` | — | GET /home/city, the counts Home's city draws. |
+| GET | `/api/bongos/home/gallery` | `any-builder` | — | GET /home/gallery?order=popular\|latest, at most 60 works. |
+| PUT | `/api/bongos/home/gallery/:id/heart` | `any-builder` | — | PUT /home/gallery/:id/heart { on }. |
+| GET | `/api/bongos/home/studio/works` | `any-builder` | — | GET /home/studio/works?page=<page id>, the studio's two shelves (task 1005061): the works the CALLER appreciated and the works the caller… |
+
 ## `inbox` (20)
 
 | Method | Path | Rank | Body | Description |