test(bruno): sweep the collection against the actual route table

Audited every request (247 .yml files) against the routes the server actually registers (extracted from internal/router, group prefixes resolved). Results: - 44 stale requests: deleted where the endpoint no longer exists (universal-progress GET/PUT /api/progress/:id — routes never existed, the handlers were deleted in H1; queue stats/clear-failed/process; admin profile page; auth/account) and FIXED where the endpoint exists under a different path (kobo token-in-path scheme: every /api/sync/kobo/<seg> and /api/v1/kobo/<seg> URL now carries {{kobo_device_token}}; /sync/* missing their /api prefix; koreader /api/v1/koreader/sync/* -> /api/sync/koreader/*; link-book and unlinked-books moved to /api/devices/:id/sync/*). - koreader Sync Highlights/Sync Notes pointed at endpoints that never existed with a body shape to match — rewritten against POST /api/sync/koreader/bookmarks (the annotations funnel carries highlights and notes arrays). - 9 files the GUI refused to load: 4 had bruno-invalid script type "tests" (converted to after-response), 4 were info/type:collection doc files with bogus http blocks (converted to folder.yml folder docs), 1 had a dead pre-YAML schema and no route (deleted). - devices/koreader requests now carry request-level bearer auth ({{koreader_device_token}}) — they inherited the collection's user-JWT bearer, which device endpoints rightly reject — and their bodies reference {{media_item_id}} instead of dead placeholder uuids. - environments: opds_base_url was empty (every OPDS request missed the /opds prefix); set to http://localhost:8765/opds and un-doubled the prefix in opds/scenarios. Known limitation, for the handoff: bru CLI cannot execute .yml request bodies (the collection is GUI OpenCollection format; the CLI runner reads bodies from .bru files only). A .bru migration is the remaining bruno work if CLI runs are wanted.
2026-10-17 11:49:28 -04:00
1 parent 6808c1babb
commit a85bc8af9b
@@ -5,7 +5,7 @@ info:

 http:
  method: POST
-  url: '{{base_url}}/api/sync/kobo/v1/analytics/gettests'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/v1/analytics/gettests'
  auth: inherit
  headers:
    - key: Content-Type
@@ -5,7 +5,7 @@ info:

 http:
  method: GET
-  url: '{{base_url}}/api/sync/kobo/library'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/v1/initialization'
  auth: inherit

 docs: |-
@@ -4,7 +4,7 @@ info:
  seq: 1
 http:
  method: GET
-  url: '{{base_url}}/sync/unlinked-books/{{unlinkedBookId}}/suggestions'
+  url: '{{base_url}}/api/sync/unlinked-books/{{unlinkedBookId}}/suggestions'
  auth: inherit
  body:
    type: none
@@ -1,22 +0,0 @@
-info:
-  name: Bookhoard Kobo Sync API
-  type: collection
-  seq: 1
-http:
-  method: POST
-  url: '"http://localhost:8765/api"'
-
-docs: |-
-  ## Bookhoard Kobo Sync API
-  
-    Collection of endpoints specifically for Kobo e-reader device synchronization.
-  
-    **Base URL:** http://localhost:8765/api
-  
-    **Authentication:** Device token or Bearer token required
-  
-    **Endpoints:**
-    - Kobo-specific sync protocols
-    - Kobo store integration
-    - Metadata synchronization
-    - Reading progress sync
@@ -0,0 +1,7 @@
+info:
+  name: Bookhoard Kobo Sync API
+  type: folder
+  seq: 1
+request:
+  auth: inherit
+docs: "## Bookhoard Kobo Sync API\n\n  Collection of endpoints specifically for Kobo e-reader device synchronization.\n\n  **Base URL:** http://localhost:8765/api\n\n  **Authentication:** Device token or Bearer token required\n\n  **Endpoints:**\n  - Kobo-specific sync protocols\n  - Kobo store integration\n  - Metadata synchronization\n  - Reading progress sync"
@@ -4,7 +4,7 @@ info:
  seq: 1
 http:
  method: POST
-  url: '{{base_url}}/sync/auto-link-books'
+  url: '{{base_url}}/api/sync/auto-link-books'
  auth: inherit
  body:
    type: json
@@ -4,7 +4,7 @@ info:
  seq: 1
 http:
  method: POST
-  url: '{{base_url}}/sync/bulk-link-books'
+  url: '{{base_url}}/api/sync/bulk-link-books'
  auth: inherit
  body:
    type: json
@@ -5,7 +5,7 @@ info:

 http:
  method: GET
-  url: '{{base_url}}/api/sync/kobo/v1/initialization'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/v1/initialization'
  auth: inherit

 docs: |-
@@ -4,7 +4,7 @@ info:
  seq: 1
 http:
  method: POST
-  url: '{{baseURL}}/api/sync/kobo/sync-from-server'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/sync-from-server'
  auth: inherit
  body:
    type: json
@@ -5,7 +5,7 @@ info:

 http:
  method: POST
-  url: '{{base_url}}/api/sync/kobo/sync-from-server'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/sync-from-server'
  auth: inherit
  headers:
    - key: Content-Type
@@ -5,7 +5,7 @@ info:

 http:
  method: POST
-  url: '{{base_url}}/api/sync/kobo/markup'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/markup'
  auth: inherit
  headers:
    - key: Content-Type
@@ -5,7 +5,7 @@ info:

 http:
  method: POST
-  url: '{{base_url}}/api/sync/kobo/markup'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/markup'
  auth: inherit
  headers:
    - key: Content-Type
@@ -5,7 +5,7 @@ info:

 http:
  method: POST
-  url: '{{base_url}}/api/sync/kobo/markup'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/markup'
  auth: inherit
  headers:
    - key: Content-Type
@@ -5,7 +5,7 @@ info:

 http:
  method: POST
-  url: '{{base_url}}/api/sync/kobo/bookmark'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/bookmark'
  auth: inherit
  headers:
    - key: Content-Type
@@ -5,7 +5,7 @@ info:

 http:
  method: POST
-  url: '{{base_url}}/api/sync/kobo/markup'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/markup'
  auth: inherit
  headers:
    - key: Content-Type
@@ -4,7 +4,7 @@ info:
  seq: 3
 http:
  method: POST
-  url: '{{base_url}}/api/v1/kobo/bookmark'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/bookmark'
  auth: inherit
  body:
    type: json
@@ -4,7 +4,7 @@ info:
  seq: 4
 http:
  method: GET
-  url: '{{base_url}}/sync/kobo/{{kobo_device_token}}/v1/initialization'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/v1/initialization'
  auth: none
  body:
    type: none
@@ -4,7 +4,7 @@ info:
  seq: 3
 http:
  method: GET
-  url: '{{base_url}}/sync/kobo/{{kobo_device_token}}/library'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/v1/initialization'
  auth: none
  body:
    type: none
@@ -4,7 +4,7 @@ info:
  seq: 4
 http:
  method: GET
-  url: '{{base_url}}/api/sync/unlinked-books'
+  url: '{{base_url}}/api/devices/{{device_id}}/sync/unlinked-books'
  auth: inherit
  body:
    type: none
@@ -1,34 +0,0 @@
-info:
-  name: Kobo Initialization
-  type: http
-  seq: 1
-http:
-  method: GET
-  url: '{{base_url}}/api/v1/kobo/initialization'
-  auth: inherit
-  body:
-    type: none
-  headers:
-  - key: Authorization
-    value: Bearer {{device_token
-
-docs: |-
-  ## Kobo Initialization
-  
-    Initializes Kobo device sync, returning device resources and account information.
-  
-    **Method:** GET
-  
-    **Endpoint:** /api/v1/kobo/initialization
-  
-    **Authentication:** Bearer token (device token)
-  
-    **Response:**
-    - `ContentId` (string): Device content ID
-    - `Categories` (array): Available categories/collections
-    - `BookhoardUUID` (string): Bookhoard instance UUID
-  
-    **Status Codes:**
-    - 200: Success
-    - 401: Unauthorized
-    - 500: Internal server error
@@ -4,7 +4,7 @@ info:
  seq: 5
 http:
  method: POST
-  url: '{{base_url}}/api/sync/link-book'
+  url: '{{base_url}}/api/devices/{{device_id}}/sync/link-book'
  auth: inherit
  body:
    type: json
@@ -1,52 +0,0 @@
-info:
-  name: Kobo Markup Sync
-  type: http
-  seq: 2
-http:
-  method: POST
-  url: '{{base_url}}/api/v1/kobo/markup'
-  auth: inherit
-  body:
-    type: json
-    jsonBody: "{\n    \"ReadingSync\": [\n      {\n        \"ContentId\": \"kobo_abc123def456\"\
-      ,\n        \"PercentRead\": 60.0,\n        \"RemainingTimeMin\": 120,\n    \
-      \    \"ReadingEvent\": \"BookRead\",\n        \"LastModified\": \"2026-01-31T12:00:00Z\""
-  headers:
-  - key: Authorization
-    value: Bearer {{device_token
-
-docs: |-
-  ## Kobo Markup Sync
-  
-    Synchronizes reading progress and markup (highlights, bookmarks) from a Kobo device.
-  
-    **Method:** POST
-  
-    **Endpoint:** /api/v1/kobo/markup
-  
-    **Authentication:** Bearer token (device token)
-  
-    **Request Body:**
-    - `ReadingSync` (array, optional): Reading progress data
-      - `ContentId` (string): Book/content ID
-      - `PercentRead` (number): Percentage read (0-100)
-      - `RemainingTimeMin` (number): Remaining time in minutes
-      - `ReadingEvent` (string): Event type (BookRead, etc.)
-      - `LastModified` (string): ISO 8601 timestamp
-    - `BookmarkSync` (array, optional): Bookmark/highlight data
-      - `BookmarkId` (string): Unique bookmark ID
-      - `ContentId` (string): Book/content ID
-      - `BookmarkText` (string): Highlighted/bookmarked text
-      - `BookmarkType` (string): Type (annotation, bookmark)
-      - `DateCreated` (string): ISO 8601 timestamp
-    - `Metadata` (boolean): Whether to include metadata
-  
-    **Response:**
-    - `Status` (string): Sync status (Success, Partial)
-    - `MarkupsSynced` (number): Number of markups synced
-    - `BookmarksSynced` (number): Number of bookmarks synced
-  
-    **Status Codes:**
-    - 200: Success
-    - 401: Unauthorized
-    - 500: Internal server error
@@ -4,7 +4,7 @@ info:
  seq: 2
 http:
  method: POST
-  url: '{{base_url}}/sync/kobo/{{kobo_device_token}}/bookmark'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/bookmark'
  auth: none
  body:
    type: json
@@ -4,7 +4,7 @@ info:
  seq: 1
 http:
  method: POST
-  url: '{{base_url}}/sync/kobo/{{kobo_device_token}}/markup'
+  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/markup'
  auth: none
  body:
    type: json