@zhin.js/plugin-rss 1.0.1 → 1.1.0

package/lib/memory-store.d.ts

@@ -0,0 +1,30 @@
+/**
+ * In-memory RSS models (slice-2) until Plugin Runtime DatabaseFeature Resource lands.
+ *
+ * 模型表面与 `@zhin.js/plugin-runtime` 的 DatabaseHostModel 结构兼容：
+ * select 的 where 返回 PromiseLike（host 返回链式 Selection，memory 返回 Promise），
+ * 这样 plugin.ts 可以把 PluginDatabaseHost 直接当 RssMemoryDb 用。
+ */
+export type RssRow = Record<string, unknown>;
+export interface RssModel {
+    select: (...fields: string[]) => {
+        where: (query: Record<string, unknown>) => PromiseLike<RssRow[]>;
+        then: <TResult1 = RssRow[], TResult2 = never>(onfulfilled?: ((value: RssRow[]) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null) => Promise<TResult1 | TResult2>;
+    };
+    insert: (row: Record<string, unknown>) => Promise<unknown>;
+    delete: () => {
+        where: (query: Record<string, unknown>) => Promise<unknown>;
+    };
+    update: (patch: Record<string, unknown>) => {
+        where: (query: Record<string, unknown>) => Promise<unknown>;
+    };
+}
+export interface RssMemoryDb {
+    models: {
+        get: (name: string) => RssModel | undefined;
+    };
+}
+export declare const RSS_SUBS_TABLE = "rss_subscriptions";
+export declare const RSS_SEEN_TABLE = "rss_seen_items";
+export declare function createInMemoryRssDb(): RssMemoryDb;
+//# sourceMappingURL=memory-store.d.ts.map

package/lib/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../src/memory-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK;QAC/B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,IAAI,EAAE,CAAC,QAAQ,GAAG,MAAM,EAAE,EAAE,QAAQ,GAAG,KAAK,EAC1C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC5E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,KACxE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;KACnC,CAAC;IACF,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,EAAE,MAAM;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC9E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK;QAC1C,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7D,CAAC;CACH;AA6CD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;KAC7C,CAAC;CACH;AAED,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,wBAAgB,mBAAmB,IAAI,WAAW,CAUjD"}

package/lib/memory-store.js

@@ -0,0 +1,61 @@
+/**
+ * In-memory RSS models (slice-2) until Plugin Runtime DatabaseFeature Resource lands.
+ *
+ * 模型表面与 `@zhin.js/plugin-runtime` 的 DatabaseHostModel 结构兼容：
+ * select 的 where 返回 PromiseLike（host 返回链式 Selection，memory 返回 Promise），
+ * 这样 plugin.ts 可以把 PluginDatabaseHost 直接当 RssMemoryDb 用。
+ */
+function createMemoryModel() {
+    const rows = [];
+    let nextId = 1;
+    function matches(row, query) {
+        return Object.entries(query).every(([key, value]) => row[key] === value);
+    }
+    function all() {
+        return rows.map((row) => ({ ...row }));
+    }
+    return {
+        select: () => {
+            const promise = Promise.resolve(all());
+            return {
+                where: async (query) => rows.filter((row) => matches(row, query)).map((row) => ({ ...row })),
+                then: (onfulfilled, onrejected) => promise.then(onfulfilled, onrejected),
+            };
+        },
+        insert: async (row) => {
+            const withId = { id: String(nextId++), ...row };
+            rows.push(withId);
+            return { ...withId };
+        },
+        delete: () => ({
+            where: async (query) => {
+                for (let i = rows.length - 1; i >= 0; i -= 1) {
+                    if (matches(rows[i], query))
+                        rows.splice(i, 1);
+                }
+            },
+        }),
+        update: (patch) => ({
+            where: async (query) => {
+                for (const row of rows) {
+                    if (matches(row, query))
+                        Object.assign(row, patch);
+                }
+            },
+        }),
+    };
+}
+export const RSS_SUBS_TABLE = 'rss_subscriptions';
+export const RSS_SEEN_TABLE = 'rss_seen_items';
+export function createInMemoryRssDb() {
+    const models = new Map([
+        [RSS_SUBS_TABLE, createMemoryModel()],
+        [RSS_SEEN_TABLE, createMemoryModel()],
+    ]);
+    return {
+        models: {
+            get: (name) => models.get(name),
+        },
+    };
+}
+//# sourceMappingURL=memory-store.js.map

package/lib/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../src/memory-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,SAAS,OAAO,CAAC,GAA4B,EAAE,KAA8B;QAC3E,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,GAAG;QACV,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACvC,OAAO;gBACL,KAAK,EAAE,KAAK,EAAE,KAA8B,EAAE,EAAE,CAC9C,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;gBACtE,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;aACzE,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,GAA4B,EAAE,EAAE;YAC7C,MAAM,MAAM,GAAW,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,KAAK,EAAE,KAAK,EAAE,KAA8B,EAAE,EAAE;gBAC9C,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7C,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC;wBAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;SACF,CAAC;QACF,MAAM,EAAE,CAAC,KAA8B,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK,EAAE,KAAK,EAAE,KAA8B,EAAE,EAAE;gBAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,IAAI,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;wBAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC;AAQD,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAmB;QACvC,CAAC,cAAc,EAAE,iBAAiB,EAAE,CAAC;QACrC,CAAC,cAAc,EAAE,iBAAiB,EAAE,CAAC;KACtC,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE;YACN,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;SACxC;KACF,CAAC;AACJ,CAAC"}

package/lib/poll.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Feed poll helpers: detect new items; optional OutboundHost push to subscribers.
+ */
+import { type FeedItem, type RssConfig } from './feed.js';
+export type RssOutboundPush = (input: {
+    readonly adapterName: string;
+    readonly endpointKey: string;
+    readonly channelType: string;
+    readonly channelId: string;
+    readonly content: string;
+}) => Promise<void>;
+export declare function setRssOutboundPush(push: RssOutboundPush | null): void;
+export declare function getRssOutboundPush(): RssOutboundPush | null;
+export declare function formatNewItems(feedTitle: string, items: FeedItem[], maxItems: number): string;
+export declare function markItemsSeen(feedUrl: string, items: FeedItem[]): Promise<void>;
+export interface CheckResult {
+    readonly text: string;
+    readonly totalNew: number;
+    readonly pushed: number;
+}
+/**
+ * Check subscribed feeds for new items and mark them seen.
+ * When OutboundHost is wired, pushes formatted text to each subscriber channel.
+ */
+export declare function checkSubscriptions(options: {
+    urls: readonly string[];
+    config: RssConfig;
+}): Promise<CheckResult>;
+/**
+ * Periodically clean seen records older than 7 days.
+ */
+export declare function cleanOldSeen(): Promise<void>;
+/**
+ * Poll all unique feed URLs across subscriptions.
+ */
+export declare function pollAllFeeds(config: RssConfig): Promise<CheckResult>;
+//# sourceMappingURL=poll.d.ts.map

package/lib/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAa,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAGrE,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAIpB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D;AAMD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY7F;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrF;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA4BD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,CAAC;CACnB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuCvB;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBlD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAO1E"}

package/lib/poll.js

@@ -0,0 +1,154 @@
+/**
+ * Feed poll helpers: detect new items; optional OutboundHost push to subscribers.
+ */
+import { fetchFeed } from './feed.js';
+import { getRssSeen, getRssSubs } from './db-store.js';
+let _outboundPush = null;
+export function setRssOutboundPush(push) {
+    _outboundPush = push;
+}
+export function getRssOutboundPush() {
+    return _outboundPush;
+}
+function ts() {
+    return new Date().toISOString();
+}
+export function formatNewItems(feedTitle, items, maxItems) {
+    const lines = [`${feedTitle} 有 ${items.length} 条新内容：`];
+    for (const item of items.slice(0, maxItems)) {
+        lines.push('');
+        lines.push(`${item.title}`);
+        if (item.summary)
+            lines.push(item.summary);
+        if (item.link)
+            lines.push(item.link);
+    }
+    if (items.length > maxItems) {
+        lines.push(`\n...还有 ${items.length - maxItems} 条，请查看源站`);
+    }
+    return lines.join('\n');
+}
+export async function markItemsSeen(feedUrl, items) {
+    const Seen = getRssSeen();
+    if (!Seen)
+        return;
+    for (const item of items) {
+        const dup = await Seen.select().where({ feed_url: feedUrl, item_guid: item.guid });
+        if (dup.length === 0) {
+            await Seen.insert({
+                feed_url: feedUrl,
+                item_guid: item.guid,
+                item_title: item.title,
+                seen_at: ts(),
+            });
+        }
+    }
+}
+async function pushToSubscribers(feedUrl, content) {
+    const push = _outboundPush;
+    const Subs = getRssSubs();
+    if (!push || !Subs)
+        return 0;
+    const subscribers = await Subs.select().where({ url: feedUrl });
+    let pushed = 0;
+    for (const sub of subscribers) {
+        const adapterName = String(sub.adapter_name ?? '');
+        const channelId = String(sub.channel_id ?? '');
+        if (!adapterName || !channelId)
+            continue;
+        try {
+            await push({
+                adapterName,
+                endpointKey: String(sub.endpoint_id ?? adapterName),
+                channelType: String(sub.channel_type ?? 'private'),
+                channelId,
+                content,
+            });
+            pushed += 1;
+        }
+        catch {
+            // OutboundHost already logs; continue other subscribers.
+        }
+    }
+    return pushed;
+}
+/**
+ * Check subscribed feeds for new items and mark them seen.
+ * When OutboundHost is wired, pushes formatted text to each subscriber channel.
+ */
+export async function checkSubscriptions(options) {
+    const Seen = getRssSeen();
+    const Subs = getRssSubs();
+    if (!Seen || !Subs) {
+        return { text: 'RSS 数据库尚未就绪', totalNew: 0, pushed: 0 };
+    }
+    const parts = [];
+    let totalNew = 0;
+    let pushed = 0;
+    for (const url of options.urls) {
+        try {
+            const { title, items } = await fetchFeed(url, options.config.timeout);
+            const seenRows = await Seen.select().where({ feed_url: url });
+            const seenGuids = new Set(seenRows.map((r) => String(r.item_guid ?? '')));
+            const newItems = items.filter((item) => item.guid && !seenGuids.has(item.guid));
+            if (newItems.length === 0) {
+                parts.push(`${title || url}: 无新内容`);
+                continue;
+            }
+            await markItemsSeen(url, newItems);
+            totalNew += newItems.length;
+            const body = formatNewItems(title || url, newItems, options.config.maxItems);
+            parts.push(body);
+            pushed += await pushToSubscribers(url, body);
+        }
+        catch (e) {
+            parts.push(`${url}: 检查失败 — ${e.message}`);
+        }
+    }
+    if (parts.length === 0)
+        return { text: '没有可检查的订阅', totalNew: 0, pushed: 0 };
+    const pushNote = _outboundPush
+        ? (pushed > 0 ? `，已推送 ${pushed} 个会话` : '，无出站推送')
+        : '（未装配 OutboundHost，仅本地标记）';
+    const header = totalNew > 0
+        ? `检查完成，共 ${totalNew} 条新内容${pushNote}`
+        : '检查完成，暂无新内容';
+    return { text: `${header}\n\n${parts.join('\n\n')}`, totalNew, pushed };
+}
+/**
+ * Periodically clean seen records older than 7 days.
+ */
+export async function cleanOldSeen() {
+    const Seen = getRssSeen();
+    if (!Seen)
+        return;
+    try {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - 7);
+        const cutoffStr = cutoff.toISOString();
+        const all = await Seen.select();
+        const expired = all.filter((r) => typeof r.seen_at === 'string' && r.seen_at < cutoffStr);
+        for (const row of expired) {
+            // 表结构没有 id 列，按业务键 (feed_url, item_guid) 删除。
+            await Seen.delete().where({ feed_url: row.feed_url, item_guid: row.item_guid });
+        }
+    }
+    catch (e) {
+        // Cleanup failure must not break the main flow, but it must be visible.
+        console.warn(`[rss] cleanOldSeen failed: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/**
+ * Poll all unique feed URLs across subscriptions.
+ */
+export async function pollAllFeeds(config) {
+    const Subs = getRssSubs();
+    if (!Subs)
+        return { text: 'RSS 数据库尚未就绪', totalNew: 0, pushed: 0 };
+    const all = await Subs.select();
+    const urls = [...new Set(all.map((s) => String(s.url ?? '')).filter(Boolean))];
+    if (urls.length === 0)
+        return { text: '暂无任何 RSS 订阅', totalNew: 0, pushed: 0 };
+    return checkSubscriptions({ urls, config });
+}
+//# sourceMappingURL=poll.js.map

package/lib/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"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"}

package/lib/rss-agent-deps.d.ts

@@ -0,0 +1,15 @@
+export interface RssAgentDeps {
+    getSubs: () => {
+        select: () => Promise<unknown[]>;
+    } | null;
+    fetchFeed: (url: string) => Promise<{
+        title: string;
+        items: Array<{
+            title: string;
+            link: string;
+        }>;
+    }>;
+}
+export declare function setRssAgentDeps(next: RssAgentDeps): void;
+export declare function getRssAgentDeps(): RssAgentDeps;
+//# sourceMappingURL=rss-agent-deps.d.ts.map

package/lib/rss-agent-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss-agent-deps.d.ts","sourceRoot":"","sources":["../src/rss-agent-deps.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM;QAAE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACvG;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAExD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAG9C"}

package/lib/rss-agent-deps.js

@@ -0,0 +1,10 @@
+let deps = null;
+export function setRssAgentDeps(next) {
+    deps = next;
+}
+export function getRssAgentDeps() {
+    if (!deps)
+        throw new Error('rss agent deps not initialized');
+    return deps;
+}
+//# sourceMappingURL=rss-agent-deps.js.map

package/lib/rss-agent-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss-agent-deps.js","sourceRoot":"","sources":["../src/rss-agent-deps.ts"],"names":[],"mappings":"AAKA,IAAI,IAAI,GAAwB,IAAI,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/plugin-rss",
-  "version": "1.0.1",
-  "description": "RSS/Atom feed subscription & push plugin for Zhin.js — subscribe feeds, auto-poll, push new items to groups",
+  "version": "1.1.0",
+  "description": "RSS/Atom feed subscription plugin for Zhin.js (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,11 +14,12 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.js",
+    "schema.json",
+    "commands",
     "src",
     "lib",
-    "client",
-    "dist",
-    "skills",
+    "agent",
     "README.md"
   ],
   "keywords": [
@@ -30,10 +31,7 @@
     "atom",
     "feed",
     "subscription",
-    "push",
-    "notify",
-    "chatbot",
-    "im"
+    "push"
   ],
   "author": {
     "name": "lc-cn",
@@ -46,10 +44,27 @@
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "zhin.js": "2.0.1"
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "@zhin.js/agent": "1.1.23",
+    "zhin.js": "1.1.0"
   },
   "peerDependencies": {
-    "zhin.js": "2.0.1"
+    "zod": "^4.0.0",
+    "@zhin.js/agent": "^1.1.23",
+    "@zhin.js/command": "^1.1.0",
+    "zhin.js": "^1.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   },
   "repository": {
     "type": "git",
@@ -60,8 +75,26 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "tsc --build",
-    "clean": "rimraf lib"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/rss/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,93 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin, databaseHostToken, outboundHostToken, scheduleHostToken, } from 'zhin.js';
+import { fetchFeed, resolveRssConfig } from "./lib/feed.js";
+import { ensureRssMemoryDb, getRssSubs, provideRssDb, RSS_SEEN_TABLE, RSS_SUBS_TABLE, } from "./lib/db-store.js";
+import { setRssAgentDeps } from "./lib/rss-agent-deps.js";
+import { cleanOldSeen, pollAllFeeds, setRssOutboundPush } from "./lib/poll.js";
+function defineRssTables(db) {
+    db.define(RSS_SUBS_TABLE, {
+        url: { type: 'text', nullable: false },
+        feed_title: { type: 'text', default: '' },
+        adapter_name: { type: 'text', nullable: false },
+        endpoint_id: { type: 'text', default: '' },
+        channel_type: { type: 'text', default: 'private' },
+        channel_id: { type: 'text', nullable: false },
+        creator_id: { type: 'text', default: '' },
+        creator_name: { type: 'text', default: '' },
+        created_at: { type: 'text', default: '' },
+    });
+    db.define(RSS_SEEN_TABLE, {
+        feed_url: { type: 'text', nullable: false },
+        item_guid: { type: 'text', nullable: false },
+        item_title: { type: 'text', default: '' },
+        seen_at: { type: 'text', default: '' },
+    });
+}
+/**
+ * Plugin Runtime:
+ * - Commands: add/list/remove/check.
+ * - DB: prefer `databaseHostToken`; else in-memory.
+ * - Outbound: `outboundHostToken` pushes new items to subscriber channels.
+ * - Cron: `scheduleHostToken` poll job when available.
+ */
+export default definePlugin({
+    name: 'rss',
+    metadata: {
+        displayName: 'RSS',
+    },
+    setup(context) {
+        const config = resolveRssConfig(context.config.get());
+        if (context.resources.has(databaseHostToken)) {
+            const host = context.resources.use(databaseHostToken);
+            defineRssTables(host);
+            // provide 自动挂 lifecycle：代际结束反注册，避免悬挂到上一代的 host
+            provideRssDb(context, host);
+        }
+        else {
+            ensureRssMemoryDb();
+        }
+        if (context.resources.has(outboundHostToken)) {
+            const outbound = context.resources.use(outboundHostToken);
+            setRssOutboundPush(async (input) => {
+                await outbound.send({
+                    adapter: input.adapterName,
+                    endpointKey: input.endpointKey,
+                    conversation: {
+                        kind: input.channelType,
+                        id: input.channelId,
+                    },
+                    content: input.content,
+                });
+            });
+            context.lifecycle.add(() => setRssOutboundPush(null));
+        }
+        setRssAgentDeps({
+            getSubs: () => getRssSubs(),
+            fetchFeed: (url) => fetchFeed(url, config.timeout).then((f) => ({
+                title: f.title,
+                items: f.items.map((i) => ({ title: i.title, link: i.link })),
+            })),
+        });
+        if (!context.resources.has(scheduleHostToken))
+            return;
+        const schedule = context.resources.use(scheduleHostToken);
+        const dispose = schedule.register({
+            id: 'rss/poll_feeds',
+            cron: config.pollCron,
+            description: 'Poll RSS subscriptions',
+            async execute() {
+                await pollAllFeeds(config);
+            },
+        });
+        const disposeClean = schedule.register({
+            id: 'rss/clean_old_seen',
+            cron: '0 0 4 * * *',
+            description: 'Clean seen records older than 7 days',
+            async execute() {
+                await cleanOldSeen();
+            },
+        });
+        context.lifecycle.add(dispose);
+        context.lifecycle.add(disposeClean);
+    },
+});

package/schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "pollCron": {
+      "type": "string",
+      "default": "0 */5 * * * *",
+      "description": "轮询频率 (6 段 Cron 表达式)"
+    },
+    "maxPerGroup": {
+      "type": "number",
+      "default": 30,
+      "minimum": 1,
+      "maximum": 200
+    },
+    "maxItems": {
+      "type": "number",
+      "default": 5,
+      "minimum": 1,
+      "maximum": 20
+    },
+    "timeout": {
+      "type": "number",
+      "default": 15000,
+      "minimum": 1000,
+      "maximum": 60000
+    }
+  }
+}

package/src/channel.ts

@@ -0,0 +1,69 @@
+/**
+ * Extract subscription channel keys from Runtime Message (`input`).
+ * Gaps vs legacy: no `$channel` / `$group` — use `conversation` / `metadata`.
+ */
+
+export interface ChannelInfo {
+  adapterName: string;
+  endpointKey: string;
+  channelType: string;
+  channelId: string;
+  senderId: string;
+  senderName: string;
+}
+
+/** Smoke / agent / execute()-without-dispatch fallback. */
+export const SMOKE_CHANNEL: ChannelInfo = {
+  adapterName: 'smoke',
+  endpointKey: 'local',
+  channelType: 'private',
+  channelId: 'global',
+  senderId: '',
+  senderName: '',
+};
+
+export function extractChannelInfo(input: unknown): ChannelInfo {
+  if (!input || typeof input !== 'object') return { ...SMOKE_CHANNEL };
+
+  const msg = input as {
+    conversation?: {
+      endpoint?: { id?: string; adapter?: string };
+      kind?: string;
+      id?: string;
+    };
+    sender?: string;
+    metadata?: Record<string, unknown>;
+  };
+  const meta = msg.metadata ?? {};
+  const conversation = msg.conversation;
+  const channelType = String(
+    meta.channelType ?? meta.type ?? meta.channel_type ?? conversation?.kind ?? 'private',
+  );
+  const channelId = String(
+    meta.channelId ?? meta.channel_id ?? conversation?.id ?? SMOKE_CHANNEL.channelId,
+  );
+  const endpointCapabilityId = typeof conversation?.endpoint?.id === 'string'
+    ? conversation.endpoint.id
+    : undefined;
+  const adapterName = String(
+    (endpointCapabilityId?.split('\0').pop() ?? endpointCapabilityId)?.split('~')[0]
+    ?? meta.adapter
+    ?? SMOKE_CHANNEL.adapterName,
+  );
+  const endpointKey = String(
+    meta.endpoint ?? meta.endpointKey ?? meta.endpoint_id ?? adapterName,
+  );
+  const senderId = String(msg.sender ?? meta.senderId ?? '');
+  const senderName = String(meta.senderName ?? meta.name ?? '');
+
+  if (!channelId) return { ...SMOKE_CHANNEL, adapterName, endpointKey, senderId, senderName };
+
+  return {
+    adapterName,
+    endpointKey,
+    channelType,
+    channelId,
+    senderId,
+    senderName,
+  };
+}