Develop

[Rabithua]

This pull request introduces support for link preview extraction, storage, and API exposure for notes ("rote") in the application. It adds a new database table for storing link previews, updates the backend to extract and manage these previews asynchronously, and extends the API to return link preview data with note objects. Documentation and migration scripts are also provided.

Database schema and migrations:

• Added new table rote_link_previews to store link preview metadata (URL, title, description, image, site name, excerpt, score, timestamps) with unique constraint and foreign key to notes. [1] [2] [3] [4] [5]
• Added and then removed columns (status, error, parserVersion, fetchedAt) for future extensibility and rollback in migrations. [1] [2]
• Updated migration journal to track new migrations.

Backend logic for link preview extraction and management:

• Implemented asynchronous extraction and storage of link previews for note content, triggered on note creation and update (unless the note is linked to an article). [1] [2] [3]
• Ensured that link previews are deleted if a note is linked to an article, or if content changes such that no URLs remain.
• Added utility functions for upserting, retrieving, and deleting link previews by note ID. [1] [2]

API and data model updates:

• Extended API endpoints to include linkPreviews in note responses (single, batch, search, random, etc.) and updated related TypeScript types. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

Documentation and planning:

• Added a detailed implementation plan and frontend integration guide for link preview extraction and display, including UI/UX requirements and prioritization rules.
• Updated API documentation to describe the linkPreviews field in note objects and provide example payloads. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11]

These changes lay the groundwork for robust link preview support in notes, enabling future frontend enhancements and richer note content.