forked from akai/readest
80cab8e56d
* feat(hardcover): add one-way Hardcover sync integration - Add HardcoverClient with ISBN/title-based book lookup, progress push, and note sync - Add HardcoverSyncMapStore for persistent local mapping of note IDs to Hardcover journal IDs - Add GraphQL queries/mutations for Hardcover API (insert/update/recreate journal entries) - Add DB migration for hardcover_note_mappings table (schema: hardcover-sync) - Add HardcoverSettings dialog component (connect/disconnect/enable toggle) - Add useHardcoverSync hook wired in Annotator for push-notes and push-progress events - Add Hardcover Sync section in BookMenu with per-book toggle (persisted in BookConfig) - Add HardcoverSettings type and DEFAULT_HARDCOVER_SETTINGS to system settings - Add hardcoverSyncEnabled per-book flag to BookConfig - Mount HardcoverSettingsWindow in Reader alongside KOSync and Readwise windows Sync is one-way (Readest → Hardcover), manual-action only, per-book opt-in. Supports idempotent note sync: insert new, skip unchanged, update changed, recreate on stale remote ID. * fix(hardcover): proxy API calls server-side to fix CORS, normalize Bearer token - Add /api/hardcover/graphql Next.js route that proxies POST requests server-side, bypassing CORS restrictions (Hardcover API has no Access-Control-Allow-Origin header) - On Tauri (desktop), calls Hardcover directly; on web, routes through the proxy - Normalize token in HardcoverClient: accept raw JWT or 'Bearer <jwt>' format - Update helper text to point to hardcover.app → Settings → API * fix(hardcover): surface note-sync no-ops and harden book resolution - Show toast feedback when book data is still loading, Hardcover is not configured, or the current book has no annotations/excerpts to sync - Show an explicit info toast when note sync finds no new changes - Parse Hardcover search results in the current hits/document response shape - Resolve note sync through ensureBookInLibrary for parity with progress sync - Add console logging for note/progress sync failures * debug(hardcover): add runtime instrumentation for note sync * feat(metadata): keep identifier stable and store ISBN separately - Add dedicated metadata.isbn field - Expose ISBN as its own editable field in book metadata - Preserve identifier semantics for existing source IDs and hashes - Route metadata auto-retrieval ISBN handling through the new field - Prefer metadata.isbn for Hardcover matching * fix(hardcover): avoid wasm sqlite for note mappings on web - Store Hardcover note sync mappings in localStorage on web - Keep sqlite-backed mappings for desktop/native environments - Remove the web-only database dependency from manual note sync * fix(hardcover): dedupe notes by payload hash across unstable note IDs - Add payload-hash lookup in HardcoverSyncMapStore - Reuse existing journal mapping when payload already synced - Prevent duplicate insertions when note IDs change or duplicate locally * fix(hardcover): avoid duplicate quote export when annotation note exists - Detect excerpt+annotation pairs for the same highlight - Skip standalone excerpt export when annotation has note text - Keep annotation export as the single source of truth * docs(hardcover): add consolidated change summary for review * fix(hardcover): suppress excerpt export by CFI when annotation note exists * fix(hardcover): suppress empty-note annotation duplicates when note exists * fix(hardcover): deduplicate notes by text and cfi base node * refactor(hardcover): optimize sync performance, add rate limiting and clean up debug tools * chore: remove dev-only change log from main * test(hardcover): add unit tests for sync mapping and client logic * chore: custom deployment and UI fixes * fix(hardcover): use timestamptz for accurate annotation time * fix(hardcover): use date scalar and RFC 3339 formatting for journal entries * Revert "chore: custom deployment and UI fixes" This reverts commit 0329aba7129d1e1ebf2c663804b8fba9a9f87b91. * Fix hardcover progress dates and surface imported ISBNs * Fix Hardcover currently reading sync * fix(hardcover): avoid promoting note sync status * style(hardcover): apply prettier formatting * test(hardcover): fix strict TypeScript assertions * test(hardcover): harden sync regression coverage * test(hardcover): fix lint and formatting regressions * fix(hardcover): narrow note dedupe range matching * refactor(hardcover): extract note dedupe helpers * refactor(isbn): extract metadata normalization helpers * feat(hardcover): improve synced quote formatting
167 lines
6.0 KiB
TypeScript
167 lines
6.0 KiB
TypeScript
import React, { useState, useEffect } from 'react';
|
|
import { useEnv } from '@/context/EnvContext';
|
|
import { useTranslation } from '@/hooks/useTranslation';
|
|
import { useSettingsStore } from '@/store/settingsStore';
|
|
import { eventDispatcher } from '@/utils/event';
|
|
import { HardcoverClient, HardcoverSyncMapStore } from '@/services/hardcover';
|
|
import Dialog from '@/components/Dialog';
|
|
|
|
export const setHardcoverSettingsWindowVisible = (visible: boolean) => {
|
|
const dialog = document.getElementById('hardcover_settings_window');
|
|
if (dialog) {
|
|
const event = new CustomEvent('setHardcoverSettingsVisibility', {
|
|
detail: { visible },
|
|
});
|
|
dialog.dispatchEvent(event);
|
|
}
|
|
};
|
|
|
|
export const HardcoverSettingsWindow: React.FC = () => {
|
|
const _ = useTranslation();
|
|
const { envConfig } = useEnv();
|
|
const { settings, setSettings, saveSettings } = useSettingsStore();
|
|
|
|
const [isOpen, setIsOpen] = useState(false);
|
|
const [accessToken, setAccessToken] = useState('');
|
|
const [isConnecting, setIsConnecting] = useState(false);
|
|
|
|
const isConfigured = !!settings.hardcover?.accessToken;
|
|
|
|
useEffect(() => {
|
|
const handleCustomEvent = (event: CustomEvent) => {
|
|
setIsOpen(event.detail.visible);
|
|
if (event.detail.visible) {
|
|
setAccessToken('');
|
|
}
|
|
};
|
|
const el = document.getElementById('hardcover_settings_window');
|
|
el?.addEventListener('setHardcoverSettingsVisibility', handleCustomEvent as EventListener);
|
|
return () => {
|
|
el?.removeEventListener('setHardcoverSettingsVisibility', handleCustomEvent as EventListener);
|
|
};
|
|
}, []);
|
|
|
|
const handleConnect = async () => {
|
|
setIsConnecting(true);
|
|
try {
|
|
const appService = await envConfig.getAppService();
|
|
const mapStore = new HardcoverSyncMapStore(appService);
|
|
const client = new HardcoverClient({ accessToken }, mapStore);
|
|
const { valid, isNetworkError } = await client.validateToken();
|
|
if (valid) {
|
|
const newSettings = {
|
|
...settings,
|
|
hardcover: {
|
|
enabled: true,
|
|
accessToken,
|
|
lastSyncedAt: settings.hardcover?.lastSyncedAt ?? 0,
|
|
},
|
|
};
|
|
setSettings(newSettings);
|
|
await saveSettings(envConfig, newSettings);
|
|
} else if (isNetworkError) {
|
|
eventDispatcher.dispatch('toast', {
|
|
message: _('Unable to connect to Hardcover. Please check your network connection.'),
|
|
type: 'error',
|
|
});
|
|
} else {
|
|
eventDispatcher.dispatch('toast', {
|
|
message: _('Invalid Hardcover API token'),
|
|
type: 'error',
|
|
});
|
|
}
|
|
} finally {
|
|
setIsConnecting(false);
|
|
setAccessToken('');
|
|
}
|
|
};
|
|
|
|
const handleDisconnect = async () => {
|
|
const newSettings = {
|
|
...settings,
|
|
hardcover: { enabled: false, accessToken: '', lastSyncedAt: 0 },
|
|
};
|
|
setSettings(newSettings);
|
|
await saveSettings(envConfig, newSettings);
|
|
eventDispatcher.dispatch('toast', { message: _('Disconnected from Hardcover'), type: 'info' });
|
|
};
|
|
|
|
const handleToggleEnabled = async () => {
|
|
const newSettings = {
|
|
...settings,
|
|
hardcover: { ...settings.hardcover, enabled: !settings.hardcover?.enabled },
|
|
};
|
|
setSettings(newSettings);
|
|
await saveSettings(envConfig, newSettings);
|
|
};
|
|
|
|
const lastSyncedAt = settings.hardcover?.lastSyncedAt ?? 0;
|
|
const lastSyncedLabel = lastSyncedAt ? new Date(lastSyncedAt).toLocaleString() : _('Never');
|
|
|
|
return (
|
|
<Dialog
|
|
id='hardcover_settings_window'
|
|
isOpen={isOpen}
|
|
onClose={() => setIsOpen(false)}
|
|
title={_('Hardcover Settings')}
|
|
boxClassName='sm:!min-w-[520px] sm:h-auto'
|
|
>
|
|
{isOpen && (
|
|
<div className='mb-4 mt-0 flex flex-col gap-4 p-2 sm:p-4'>
|
|
{isConfigured ? (
|
|
<>
|
|
<div className='text-center'>
|
|
<p className='text-base-content/80 text-sm'>{_('Connected to Hardcover')}</p>
|
|
<p className='text-base-content/60 mt-1 text-xs'>
|
|
{_('Last synced: {{time}}', { time: lastSyncedLabel })}
|
|
</p>
|
|
</div>
|
|
<div className='flex h-14 items-center justify-between'>
|
|
<span className='text-base-content/80'>{_('Sync Enabled')}</span>
|
|
<input
|
|
type='checkbox'
|
|
className='toggle'
|
|
checked={settings.hardcover?.enabled ?? false}
|
|
onChange={handleToggleEnabled}
|
|
/>
|
|
</div>
|
|
<button className='btn btn-outline btn-sm mt-2' onClick={handleDisconnect}>
|
|
{_('Disconnect')}
|
|
</button>
|
|
</>
|
|
) : (
|
|
<>
|
|
<p className='text-base-content/70 text-center text-sm'>
|
|
{_('Connect your Hardcover account to sync reading progress and notes.')}
|
|
</p>
|
|
<p className='text-base-content/60 text-center text-xs'>
|
|
{_('Get your API token from hardcover.app → Settings → API.')}
|
|
</p>
|
|
<div className='form-control w-full'>
|
|
<label className='label py-1'>
|
|
<span className='label-text font-medium'>{_('API Token')}</span>
|
|
</label>
|
|
<input
|
|
type='password'
|
|
placeholder={_('Paste your Hardcover API token')}
|
|
className='input input-bordered h-12 w-full focus:outline-none focus:ring-0'
|
|
spellCheck='false'
|
|
value={accessToken}
|
|
onChange={(e) => setAccessToken(e.target.value)}
|
|
/>
|
|
</div>
|
|
<button
|
|
className='btn btn-primary mt-2 h-12 min-h-12 w-full'
|
|
onClick={handleConnect}
|
|
disabled={isConnecting || !accessToken}
|
|
>
|
|
{isConnecting ? <span className='loading loading-spinner'></span> : _('Connect')}
|
|
</button>
|
|
</>
|
|
)}
|
|
</div>
|
|
)}
|
|
</Dialog>
|
|
);
|
|
};
|