@mdguggenbichler/slugbase-core 0.0.17 → 0.0.18

package/backend/dist/routes/bookmarks.js

@@ -25,103 +25,6 @@ async function recordAiSuggestionUsage(userId, used) {
         // Table may not exist yet; do not fail the bookmark request
     }
 }
-/**
- * @swagger
- * /api/bookmarks:
- *   get:
- *     summary: Get all bookmarks
- *     description: Returns all bookmarks for the authenticated user, including own bookmarks and bookmarks shared via teams or users. Supports filtering by folder and tag.
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     parameters:
- *       - in: query
- *         name: folder_id
- *         schema:
- *           type: string
- *         description: Filter bookmarks by folder ID
- *         example: "123e4567-e89b-12d3-a456-426614174000"
- *       - in: query
- *         name: tag_id
- *         schema:
- *           type: string
- *         description: Filter bookmarks by tag ID
- *         example: "123e4567-e89b-12d3-a456-426614174000"
- *       - in: query
- *         name: limit
- *         schema:
- *           type: integer
- *           default: 50
- *         description: Max items per page (1-100)
- *       - in: query
- *         name: offset
- *         schema:
- *           type: integer
- *           default: 0
- *         description: Number of items to skip
- *     responses:
- *       200:
- *         description: List of bookmarks
- *         content:
- *           application/json:
- *             schema:
- *               type: array
- *               items:
- *                 type: object
- *                 properties:
- *                   id:
- *                     type: string
- *                     example: "123e4567-e89b-12d3-a456-426614174000"
- *                   title:
- *                     type: string
- *                     example: "Example Bookmark"
- *                   url:
- *                     type: string
- *                     example: "https://example.com"
- *                   slug:
- *                     type: string
- *                     nullable: true
- *                     example: "example-slug"
- *                   forwarding_enabled:
- *                     type: boolean
- *                     example: true
- *                   bookmark_type:
- *                     type: string
- *                     enum: [own, shared]
- *                     example: "own"
- *                   folders:
- *                     type: array
- *                     items:
- *                       type: object
- *                       properties:
- *                         id:
- *                           type: string
- *                         name:
- *                           type: string
- *                         icon:
- *                           type: string
- *                           nullable: true
- *                   tags:
- *                     type: array
- *                     items:
- *                       type: object
- *                       properties:
- *                         id:
- *                           type: string
- *                         name:
- *                           type: string
- *                   shared_teams:
- *                     type: array
- *                     items:
- *                       type: object
- *                   shared_users:
- *                     type: array
- *                     items:
- *                       type: object
- *       401:
- *         description: Unauthorized
- */
 // Get all bookmarks for user (including shared bookmarks)
 router.get('/', async (req, res) => {
     const authReq = req;
@@ -445,79 +348,6 @@ router.get('/', async (req, res) => {
         res.status(500).json({ error: error.message });
     }
 });
-/**
- * @swagger
- * /api/bookmarks/{id}:
- *   get:
- *     summary: Get bookmark by ID
- *     description: Returns a single bookmark by ID. User must own the bookmark or have access via sharing.
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     parameters:
- *       - in: path
- *         name: id
- *         required: true
- *         schema:
- *           type: string
- *         description: Bookmark ID
- *         example: "123e4567-e89b-12d3-a456-426614174000"
- *     responses:
- *       200:
- *         description: Bookmark details
- *         content:
- *           application/json:
- *             schema:
- *               type: object
- *               properties:
- *                 id:
- *                   type: string
- *                 title:
- *                   type: string
- *                 url:
- *                   type: string
- *                 slug:
- *                   type: string
- *                   nullable: true
- *                 forwarding_enabled:
- *                   type: boolean
- *                 folders:
- *                   type: array
- *                 tags:
- *                   type: array
- *                 shared_teams:
- *                   type: array
- *                 shared_users:
- *                   type: array
- *       404:
- *         description: Bookmark not found
- *       401:
- *         description: Unauthorized
- */
-/**
- * @swagger
- * /api/bookmarks/search:
- *   get:
- *     summary: Search bookmarks, folders, and tags
- *     description: Global search across bookmarks, folders, and tags
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     parameters:
- *       - in: query
- *         name: q
- *         required: true
- *         schema:
- *           type: string
- *         description: Search query
- *     responses:
- *       200:
- *         description: Search results
- *       401:
- *         description: Unauthorized
- */
 // Search endpoint (must be before /:id route)
 router.get('/search', async (req, res) => {
     const authReq = req;
@@ -611,26 +441,6 @@ router.get('/search', async (req, res) => {
         res.status(500).json({ error: 'Search failed' });
     }
 });
-/**
- * @swagger
- * /api/bookmarks/export:
- *   get:
- *     summary: Export bookmarks as JSON
- *     description: Export all user's bookmarks as JSON
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     responses:
- *       200:
- *         description: JSON export of bookmarks
- *         content:
- *           application/json:
- *             schema:
- *               type: array
- *       401:
- *         description: Unauthorized
- */
 // Export bookmarks as JSON (must be before /:id route)
 router.get('/export', async (req, res) => {
     const authReq = req;
@@ -793,51 +603,6 @@ router.get('/ids', async (req, res) => {
         res.status(500).json({ error: 'Failed to fetch bookmark IDs' });
     }
 });
-/**
- * @swagger
- * /api/bookmarks/ai-suggest:
- *   post:
- *     summary: Get AI suggestions for bookmark metadata
- *     description: Returns suggested title, slug, and tags for a URL. Requires AI feature enabled. Non-blocking; bookmark creation never depends on this.
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     requestBody:
- *       required: true
- *       content:
- *         application/json:
- *           schema:
- *             type: object
- *             required: [url]
- *             properties:
- *               url:
- *                 type: string
- *                 format: uri
- *               page_title:
- *                 type: string
- *     responses:
- *       200:
- *         description: AI suggestions
- *         content:
- *           application/json:
- *             schema:
- *               type: object
- *               properties:
- *                 title: { type: string }
- *                 slug: { type: string }
- *                 tags: { type: array, items: { type: string } }
- *                 language: { type: string }
- *                 confidence: { type: number }
- *       400:
- *         description: Invalid URL
- *       403:
- *         description: AI feature disabled or not available for plan
- *       408:
- *         description: AI request timeout
- *       503:
- *         description: AI not configured
- */
 router.post('/ai-suggest', async (req, res) => {
     const authReq = req;
     try {
@@ -977,31 +742,6 @@ router.get('/:id', async (req, res) => {
         res.status(500).json({ error: error.message });
     }
 });
-/**
- * @swagger
- * /api/bookmarks/{id}/track-access:
- *   post:
- *     summary: Track bookmark access
- *     description: Increments access_count and updates last_accessed_at for a bookmark when it is opened
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     parameters:
- *       - in: path
- *         name: id
- *         required: true
- *         schema:
- *           type: string
- *         description: Bookmark ID
- *     responses:
- *       200:
- *         description: Access tracked successfully
- *       404:
- *         description: Bookmark not found
- *       401:
- *         description: Unauthorized
- */
 // Track bookmark access (must be before PUT /:id)
 router.post('/:id/track-access', async (req, res) => {
     const authReq = req;
@@ -1025,97 +765,6 @@ router.post('/:id/track-access', async (req, res) => {
         res.status(500).json({ error: error.message });
     }
 });
-/**
- * @swagger
- * /api/bookmarks:
- *   post:
- *     summary: Create a new bookmark
- *     description: Creates a new bookmark. Slug is required only if forwarding is enabled. Can assign to multiple folders, tags, and share with users/teams.
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     requestBody:
- *       required: true
- *       content:
- *         application/json:
- *           schema:
- *             type: object
- *             required:
- *               - title
- *               - url
- *             properties:
- *               title:
- *                 type: string
- *                 example: "Example Bookmark"
- *               url:
- *                 type: string
- *                 format: uri
- *                 example: "https://example.com"
- *               slug:
- *                 type: string
- *                 nullable: true
- *                 description: Required if forwarding_enabled is true, optional otherwise
- *                 example: "example-slug"
- *               forwarding_enabled:
- *                 type: boolean
- *                 default: false
- *                 example: true
- *               folder_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of folder IDs to assign bookmark to
- *                 example: ["123e4567-e89b-12d3-a456-426614174000"]
- *               tag_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of tag IDs to assign to bookmark
- *                 example: ["123e4567-e89b-12d3-a456-426614174000"]
- *               team_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of team IDs to share bookmark with
- *                 example: ["123e4567-e89b-12d3-a456-426614174000"]
- *               user_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of user IDs to share bookmark with
- *                 example: ["123e4567-e89b-12d3-a456-426614174000"]
- *               share_all_teams:
- *                 type: boolean
- *                 default: false
- *                 description: Share bookmark with all teams user is a member of
- *                 example: false
- *     responses:
- *       201:
- *         description: Bookmark created successfully
- *         content:
- *           application/json:
- *             schema:
- *               type: object
- *               properties:
- *                 id:
- *                   type: string
- *                 title:
- *                   type: string
- *                 url:
- *                   type: string
- *                 slug:
- *                   type: string
- *                   nullable: true
- *                 forwarding_enabled:
- *                   type: boolean
- *       400:
- *         description: Missing required fields, slug required when forwarding enabled, or slug already exists
- *       401:
- *         description: Unauthorized
- *       403:
- *         description: User does not own folder or is not member of team
- */
 // Create bookmark
 router.post('/', async (req, res) => {
     const authReq = req;
@@ -1224,81 +873,6 @@ router.post('/', async (req, res) => {
         res.status(500).json({ error: error.message });
     }
 });
-/**
- * @swagger
- * /api/bookmarks/{id}:
- *   put:
- *     summary: Update bookmark
- *     description: Updates an existing bookmark. User must own the bookmark. All fields are optional.
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     parameters:
- *       - in: path
- *         name: id
- *         required: true
- *         schema:
- *           type: string
- *         description: Bookmark ID
- *         example: "123e4567-e89b-12d3-a456-426614174000"
- *     requestBody:
- *       required: true
- *       content:
- *         application/json:
- *           schema:
- *             type: object
- *             properties:
- *               title:
- *                 type: string
- *                 example: "Updated Bookmark Title"
- *               url:
- *                 type: string
- *                 format: uri
- *                 example: "https://updated-example.com"
- *               slug:
- *                 type: string
- *                 nullable: true
- *                 description: Required if forwarding_enabled is true
- *                 example: "updated-slug"
- *               forwarding_enabled:
- *                 type: boolean
- *                 example: true
- *               folder_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of folder IDs (replaces existing assignments)
- *               tag_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of tag IDs (replaces existing assignments)
- *               team_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of team IDs to share with (replaces existing shares)
- *               user_ids:
- *                 type: array
- *                 items:
- *                   type: string
- *                 description: Array of user IDs to share with (replaces existing shares)
- *               share_all_teams:
- *                 type: boolean
- *                 description: Share with all teams user is a member of
- *     responses:
- *       200:
- *         description: Bookmark updated successfully
- *       400:
- *         description: Slug required when forwarding enabled or slug already exists
- *       401:
- *         description: Unauthorized
- *       403:
- *         description: User does not own folder or is not member of team
- *       404:
- *         description: Bookmark not found
- */
 // Update bookmark
 router.put('/:id', async (req, res) => {
     const authReq = req;
@@ -1457,40 +1031,6 @@ router.put('/:id', async (req, res) => {
         res.status(500).json({ error: error.message });
     }
 });
-/**
- * @swagger
- * /api/bookmarks/{id}:
- *   delete:
- *     summary: Delete bookmark
- *     description: Deletes a bookmark. User must own the bookmark.
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     parameters:
- *       - in: path
- *         name: id
- *         required: true
- *         schema:
- *           type: string
- *         description: Bookmark ID
- *         example: "123e4567-e89b-12d3-a456-426614174000"
- *     responses:
- *       200:
- *         description: Bookmark deleted successfully
- *         content:
- *           application/json:
- *             schema:
- *               type: object
- *               properties:
- *                 message:
- *                   type: string
- *                   example: "Bookmark deleted"
- *       401:
- *         description: Unauthorized
- *       404:
- *         description: Bookmark not found
- */
 // Delete bookmark
 router.delete('/:id', async (req, res) => {
     const authReq = req;
@@ -1509,68 +1049,6 @@ router.delete('/:id', async (req, res) => {
         res.status(500).json({ error: error.message });
     }
 });
-/**
- * @swagger
- * /api/bookmarks/search:
- *   get:
- *     summary: Search bookmarks, folders, and tags
- *     description: Search across bookmarks, folders, and tags for the authenticated user
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     parameters:
- *       - in: query
- *         name: q
- *         required: true
- *         schema:
- *           type: string
- *         description: Search query
- *         example: "example"
- *     responses:
- *       200:
- *         description: Search results
- *       401:
- *         description: Unauthorized
- */
-/**
- * @swagger
- * /api/bookmarks/import:
- *   post:
- *     summary: Import bookmarks from JSON
- *     description: Import bookmarks from a JSON array
- *     tags: [Bookmarks]
- *     security:
- *       - cookieAuth: []
- *       - bearerAuth: []
- *     requestBody:
- *       required: true
- *       content:
- *         application/json:
- *           schema:
- *             type: object
- *             properties:
- *               bookmarks:
- *                 type: array
- *                 items:
- *                   type: object
- *                   properties:
- *                     title:
- *                       type: string
- *                     url:
- *                       type: string
- *                     slug:
- *                       type: string
- *                     forwarding_enabled:
- *                       type: boolean
- *     responses:
- *       200:
- *         description: Import successful
- *       400:
- *         description: Invalid import data
- *       401:
- *         description: Unauthorized
- */
 // Import bookmarks from JSON
 router.post('/import', async (req, res) => {
     const authReq = req;