hn-bits 0.2.0 → 0.3.0

package/dist/ui/SubscriptionsView.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from 'react';
+import { Box, Text, useInput, useWindowSize } from 'ink';
+import { listSubscriptions, removeSubscription } from '../db/subscriptions.js';
+import { formatAge } from '../lib/format.js';
+import { clampSelection, mapFeedKey } from '../lib/listNavigation.js';
+import { ensureVisibleLines, sliceByLines } from '../lib/viewport.js';
+import { footerRows, SUBS_KEYS } from './keymap.js';
+import { HEADER_ROWS } from './Layout.js';
+import { theme } from './theme.js';
+function pointsLabel(minPoints) {
+    return minPoints === 0 ? 'any' : `≥${minPoints} pts`;
+}
+export function SubscriptionsView({ onSelectMatches, onAdd, onEdit, onFeedChange, onTabChange, }) {
+    const { columns, rows } = useWindowSize();
+    const bodyHeight = Math.max(1, rows - HEADER_ROWS - footerRows(SUBS_KEYS, columns));
+    const [subs, setSubs] = useState(() => listSubscriptions());
+    const [selected, setSelected] = useState(0);
+    const [deleteConfirm, setDeleteConfirm] = useState(null);
+    const pendingTopJump = useRef(false);
+    const topLineRef = useRef(0);
+    function reload() {
+        const next = listSubscriptions();
+        setSubs(next);
+        setSelected((s) => clampSelection(s, 0, next.length));
+    }
+    function handleInput(input, key) {
+        if (deleteConfirm) {
+            if (input === 'y') {
+                removeSubscription(deleteConfirm);
+                reload();
+            }
+            setDeleteConfirm(null);
+            return;
+        }
+        const isG = input === 'g';
+        if (isG && pendingTopJump.current) {
+            pendingTopJump.current = false;
+            return setSelected(0);
+        }
+        pendingTopJump.current = isG;
+        const targetFeed = mapFeedKey(input);
+        if (targetFeed)
+            return onFeedChange(targetFeed);
+        if (key.leftArrow)
+            return onTabChange(-1);
+        if (key.rightArrow)
+            return onTabChange(1);
+        if (input === 'j' || key.downArrow)
+            return setSelected((s) => clampSelection(s, 1, subs.length));
+        if (input === 'k' || key.upArrow)
+            return setSelected((s) => clampSelection(s, -1, subs.length));
+        if (input === 'G')
+            return setSelected(Math.max(0, subs.length - 1));
+        if (key.return && subs[selected])
+            return onSelectMatches(subs[selected]);
+        if (input === 'a')
+            return onAdd();
+        if (input === 'e' && subs[selected])
+            return onEdit(subs[selected]);
+        if (input === 'd' && subs[selected])
+            return setDeleteConfirm(subs[selected].name);
+    }
+    useInput(handleInput);
+    if (subs.length === 0) {
+        return _jsx(Text, { dimColor: true, children: "no subscriptions yet - press a to add" });
+    }
+    const statusLineHeight = deleteConfirm ? 1 : 0;
+    const listHeight = Math.max(1, bodyHeight - statusLineHeight);
+    const heights = subs.map(() => 1);
+    const topLine = ensureVisibleLines(heights, selected, topLineRef.current, listHeight);
+    topLineRef.current = topLine;
+    const { first, last } = sliceByLines(heights, topLine, listHeight);
+    const nameWidth = Math.max(...subs.map((s) => s.name.length));
+    return (_jsxs(Box, { flexDirection: "column", children: [subs.slice(first, last + 1).map((sub, i) => {
+                const index = first + i;
+                const isSelected = index === selected;
+                const marker = isSelected ? theme.glyphs.selection : ' ';
+                const background = isSelected ? theme.colors.selectionBackground : undefined;
+                return (_jsxs(Text, { backgroundColor: background, children: [marker, " ", sub.name.padEnd(nameWidth), "  \"", sub.query, "\"  ", pointsLabel(sub.minPoints).padEnd(9), "  added", ' ', formatAge(sub.createdAt), " ago"] }, sub.id));
+            }), deleteConfirm && _jsxs(Text, { dimColor: true, children: ["delete '", deleteConfirm, "'? y/n"] })] }));
+}

package/dist/ui/TabBar.js

@@ -2,17 +2,19 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text, useWindowSize } from 'ink';
 import { theme } from './theme.js';
 const TABS = [
-    { feed: 'top', label: 'Top' },
-    { feed: 'new', label: 'New' },
-    { feed: 'best', label: 'Best' },
-    { feed: 'ask', label: 'Ask' },
-    { feed: 'show', label: 'Show' },
+    { id: 'top', label: 'Top' },
+    { id: 'new', label: 'New' },
+    { id: 'best', label: 'Best' },
+    { id: 'ask', label: 'Ask' },
+    { id: 'show', label: 'Show' },
+    { id: 'saved', label: 'Saved' },
+    { id: 'subs', label: 'Subs' },
 ];
 const BRAND = 'Hacker News';
 const HELP_HINT = '? help';
 const TAB_GAP = '   ';
 function tabSegment(tab, active) {
-    if (tab.feed !== active)
+    if (tab.id !== active)
         return { segment: { text: tab.label, color: 'muted' }, width: tab.label.length };
     const inner = ` ${tab.label} `;
     return { segment: { text: `│${inner}│`, color: 'accent', bold: true }, width: inner.length };
@@ -29,7 +31,7 @@ function buildTabSegments(active) {
         }
         const { segment, width } = tabSegment(tab, active);
         segments.push(segment);
-        if (tab.feed === active) {
+        if (tab.id === active) {
             activeWallColumn = column;
             activeInnerWidth = width;
         }

package/dist/ui/keymap.js

@@ -14,6 +14,7 @@ export const LIST_KEYS = [
     { key: '/', label: 'search' },
     { key: 's', label: 'summary' },
     { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'bookmark' },
 ];
 export const COMMENTS_KEYS = [
     { key: 'j/k', label: 'move' },
@@ -24,6 +25,7 @@ export const COMMENTS_KEYS = [
     { key: 'r', label: 'reload' },
     { key: 's', label: 'summary' },
     { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'bookmark' },
     { key: 'esc', label: 'back' },
 ];
 export const SEARCH_RESULTS_KEYS = [
@@ -34,8 +36,48 @@ export const SEARCH_RESULTS_KEYS = [
     { key: '/', label: 'new search' },
     { key: 's', label: 'summary' },
     { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'bookmark' },
+    { key: 'S', label: 'subscribe' },
     { key: 'esc', label: 'back/quit' },
 ];
+export const SUBS_KEYS = [
+    { key: 'j/k', label: 'move' },
+    { key: '←/→', label: 'tab' },
+    { key: 't/n/b', label: 'feed' },
+    { key: 'enter', label: 'matches' },
+    { key: 'a', label: 'add' },
+    { key: 'e', label: 'edit' },
+    { key: 'd', label: 'delete' },
+];
+export const SUB_MATCHES_KEYS = [
+    { key: 'j/k', label: 'move' },
+    { key: 'gg/G', label: 'top/bottom' },
+    { key: 'enter', label: 'comments' },
+    { key: 'o', label: 'browser' },
+    { key: 'B', label: 'bookmark' },
+    { key: 's', label: 'summary' },
+    { key: 'a', label: 'ask ai' },
+    { key: 'r', label: 'refetch' },
+    { key: 'esc', label: 'back' },
+];
+export const SUB_FORM_KEYS = [
+    { key: 'tab', label: 'next field' },
+    { key: 'enter', label: 'save' },
+    { key: 'esc', label: 'cancel' },
+];
+export const SAVED_KEYS = [
+    { key: 'j/k', label: 'move' },
+    { key: '←/→', label: 'tab' },
+    { key: 't/n/b', label: 'feed' },
+    { key: 'gg/G', label: 'top/bottom' },
+    { key: 'enter', label: 'comments' },
+    { key: 'o', label: 'browser' },
+    { key: 'r', label: 'reload' },
+    { key: '/', label: 'search' },
+    { key: 's', label: 'summary' },
+    { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'remove' },
+];
 /** Footer hint string: view keys followed by the global keys. */
 export function footerHint(viewKeys) {
     return [...viewKeys, ...GLOBAL_KEYS].map((binding) => `${binding.key} ${binding.label}`).join(' · ');

package/dist/ui/theme.js

@@ -3,6 +3,7 @@ const glyphs = {
     foldOpen: '▾',
     foldClosed: '▸',
     upvote: '▲',
+    bookmark: '★',
 };
 function ansi256(code) {
     return `ansi256(${code})`;

package/dist/ui/useFlash.js

@@ -0,0 +1,14 @@
+import { useRef, useState } from 'react';
+const FLASH_MS = 1500;
+/** Transient status text (e.g. "bookmarked ✓") that self-clears after FLASH_MS. */
+export function useFlash() {
+    const [message, setMessage] = useState(null);
+    const timer = useRef(null);
+    function flash(text) {
+        if (timer.current)
+            clearTimeout(timer.current);
+        setMessage(text);
+        timer.current = setTimeout(() => setMessage(null), FLASH_MS);
+    }
+    return [message, flash];
+}

package/dist/watch.js

@@ -0,0 +1,96 @@
+import { searchRecent } from './api/algolia.js';
+import { isSeen, markSeen } from './db/seen.js';
+import { listSubscriptions, touchLastRun } from './db/subscriptions.js';
+import { loadConfig } from './lib/config.js';
+import { createTelegramNotifier } from './notify/telegram.js';
+const SIX_HOURS = 6 * 60 * 60;
+const TWENTY_FOUR_HOURS = 24 * 60 * 60;
+function log(message) {
+    console.log(`[${new Date().toISOString()}] ${message}`);
+}
+function windowStart(lastRunAt, now) {
+    if (lastRunAt == null)
+        return now - TWENTY_FOUR_HOURS;
+    return Math.max(lastRunAt - SIX_HOURS, 0);
+}
+function buildNotifiers() {
+    const config = loadConfig();
+    const telegram = config?.telegram;
+    if (telegram?.enabled && telegram.botToken && telegram.chatId) {
+        return [createTelegramNotifier({ botToken: telegram.botToken, chatId: telegram.chatId })];
+    }
+    return [];
+}
+async function notifyStory(sub, story, notifiers) {
+    try {
+        for (const notifier of notifiers)
+            await notifier.send({ subscription: sub, story });
+        return true;
+    }
+    catch (err) {
+        log(`${sub.name}: notify failed for ${story.id} - ${err.message}`);
+        return false;
+    }
+}
+async function processSubscription(sub, notifiers, now, dryRun) {
+    let stories;
+    try {
+        stories = await searchRecent(sub.query, { createdAfter: windowStart(sub.lastRunAt, now), minPoints: sub.minPoints });
+    }
+    catch (err) {
+        log(`${sub.name}: query failed - ${err.message}`);
+        return { notified: 0, hadFailure: true };
+    }
+    const matches = stories.filter((story) => !isSeen(story.id, sub.id)).sort((a, b) => a.time - b.time);
+    if (matches.length === 0) {
+        log(`${sub.name}: no new matches`);
+        if (!dryRun)
+            touchLastRun(sub.id, now);
+        return { notified: 0, hadFailure: false };
+    }
+    log(`${sub.name}: ${matches.length} new matches`);
+    let notified = 0;
+    let hadFailure = false;
+    for (const story of matches) {
+        if (dryRun) {
+            log(`would notify: [${sub.name}] ${story.title} (${story.score} pts)`);
+            continue;
+        }
+        const sent = await notifyStory(sub, story, notifiers);
+        if (!sent) {
+            hadFailure = true;
+            continue;
+        }
+        markSeen(story.id, sub.id, now);
+        log(`${sub.name}: notified ${story.id} "${story.title}" (${story.score} pts)`);
+        notified++;
+    }
+    if (!dryRun)
+        touchLastRun(sub.id, now);
+    return { notified, hadFailure };
+}
+/** hn watch --once: one-shot pass over all subscriptions. Returns the process exit code. */
+export async function runWatch(options) {
+    const notifiers = buildNotifiers();
+    if (notifiers.length === 0) {
+        console.error('no notifier configured: hn config set telegram.enabled true (and botToken/chatId)');
+        return 2;
+    }
+    const subs = listSubscriptions();
+    if (subs.length === 0) {
+        log('no subscriptions');
+        return 0;
+    }
+    log(`watch: ${subs.length} subscriptions`);
+    const now = Math.floor(Date.now() / 1000);
+    let totalNotified = 0;
+    let failedSubs = 0;
+    for (const sub of subs) {
+        const result = await processSubscription(sub, notifiers, now, options.dryRun);
+        totalNotified += result.notified;
+        if (result.hadFailure)
+            failedSubs++;
+    }
+    log(`done: ${totalNotified} notified, ${failedSubs} failed`);
+    return failedSubs > 0 ? 1 : 0;
+}

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "hn-bits",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Terminal-first Hacker News client",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/navinrc/hn-bits.git"
+  },
   "bin": {
     "hn": "./dist/index.js"
   },
@@ -22,6 +26,7 @@
   "license": "MIT",
   "dependencies": {
     "@mozilla/readability": "^0.6.0",
+    "better-sqlite3": "^12.11.1",
     "commander": "^15.0.0",
     "ink": "^7.1.0",
     "jsdom": "^29.1.1",
@@ -29,6 +34,7 @@
     "react": "^19.2.7"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/jsdom": "^28.0.3",
     "@types/node": "^26.1.0",
     "@types/react": "^19.2.17",