@zhin.js/plugin-rss 1.1.8 → 1.1.9

package/README.md

@@ -158,3 +158,7 @@ rss:
 ## 许可
 
 MIT
+
+### 事务化任务存储
+
+提醒与管理员 RSS 的任务、认领、操作回执和文章明细使用独立数据表，在一个事务中提交；原 CAS JSON 只用于首次迁移。支持 SQLite、MySQL、PostgreSQL，升级须完整重启，不能与旧版本进程混写。`unknown` 投递仍不会自动重试。迁移和字段说明见[结构化存储](../../../docs/operations/structured-storage.md)。

package/lib/storage.d.ts

@@ -0,0 +1,3 @@
+import { type PluginDatabaseHost } from 'zhin.js/plugin-runtime';
+export declare function createAdministratorRssState(database: PluginDatabaseHost): import("zhin.js").PluginStateStore;
+//# sourceMappingURL=storage.d.ts.map

package/lib/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EACiF,KAAK,kBAAkB,EAA6B,MAAM,wBAAwB,CAAC;AAsD3K,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,kBAAkB,sCAEvE"}

package/lib/storage.js

@@ -0,0 +1,56 @@
+import { createRelationalStateStore, TASK_TARGET_COLUMNS, TASK_RECEIPT_COLUMNS, encodeTaskTarget, decodeTaskTarget, encodeTaskReceipts, decodeTaskReceipts, encodeStorageIdentity, decodeStorageIdentity } from 'zhin.js/plugin-runtime';
+import { ADMIN_RSS_STATE_KEY } from './admin-tasks.js';
+const tasks = 'admin_rss_tasks', seen = 'admin_rss_seen', items = 'admin_rss_pending_items', receipts = 'admin_rss_receipts';
+const text = { type: 'text', nullable: true };
+const time = { type: 'bigint', nullable: true };
+const child = { id: { type: 'text', length: 80, primary: true }, task_id: { type: 'text', length: 36, nullable: false }, position: { type: 'integer', nullable: false } };
+const codec = {
+    key: ADMIN_RSS_STATE_KEY,
+    header: { table: 'admin_rss_book', definition: { version: { type: 'integer', nullable: true }, revision: text } },
+    tables: {
+        [tasks]: { id: { type: 'text', length: 36, primary: true }, position: { type: 'integer', nullable: false }, ...TASK_TARGET_COLUMNS,
+            creation: text, version: text, url: text, state: text, created_at: time, claim_id: text, last_check_at: time, last_run_at: time, detail: text,
+            seen_known: { type: 'boolean', nullable: false }, quiet_timezone: text, quiet_start: text, quiet_end: text,
+            pending_kind: text, pending_from: time, pending_to: time, pending_count: { type: 'integer', nullable: true },
+            pending_capped: { type: 'boolean', nullable: true } },
+        [seen]: { ...child, item_key: { type: 'text', nullable: false } },
+        [items]: { ...child, item_key: text, title: text, link: text },
+        [receipts]: TASK_RECEIPT_COLUMNS,
+    },
+    encode(value) {
+        const book = value;
+        if (![1, 2].includes(book.version) || !Array.isArray(book.tasks) || !Array.isArray(book.receipts))
+            throw new Error('Unsupported RSS book; original state was preserved');
+        return { header: { version: book.version, revision: book.revision }, rows: {
+                [tasks]: book.tasks.map((task, position) => ({ id: task.id, position, ...encodeTaskTarget(task.target),
+                    creation: task.creation, version: task.version, url: encodeStorageIdentity(task.url), state: task.state, created_at: task.createdAt,
+                    claim_id: task.claimId, last_check_at: task.lastCheckAt, last_run_at: task.lastRunAt, detail: encodeStorageIdentity(task.detail),
+                    seen_known: task.seen !== null, quiet_timezone: task.quiet?.timezone ?? null, quiet_start: task.quiet?.start ?? null, quiet_end: task.quiet?.end ?? null,
+                    pending_kind: task.pending === undefined ? 'absent' : task.pending === null ? 'null' : 'value',
+                    pending_from: task.pending?.from ?? null, pending_to: task.pending?.to ?? null,
+                    pending_count: task.pending?.count ?? null, pending_capped: task.pending?.countCapped ?? null,
+                })),
+                [seen]: book.tasks.flatMap((task) => (task.seen ?? []).map((key, position) => ({ id: `${task.id}:${position}`, task_id: task.id, position, item_key: encodeStorageIdentity(key) }))),
+                [items]: book.tasks.flatMap((task) => (task.pending?.items ?? []).map((item, position) => ({ id: `${task.id}:${position}`, task_id: task.id, position, item_key: encodeStorageIdentity(item.key), title: encodeStorageIdentity(item.title), link: encodeStorageIdentity(item.link) }))),
+                [receipts]: encodeTaskReceipts(book.receipts),
+            } };
+    },
+    decode(header, rows) {
+        return { version: Number(header.version), revision: String(header.revision), receipts: decodeTaskReceipts(rows[receipts]),
+            tasks: rows[tasks].map(row => ({ id: String(row.id), target: decodeTaskTarget(row), creation: String(row.creation), version: String(row.version),
+                url: decodeStorageIdentity(row.url), state: String(row.state), createdAt: Number(row.created_at), claimId: row.claim_id == null ? null : String(row.claim_id),
+                lastCheckAt: row.last_check_at == null ? null : Number(row.last_check_at), lastRunAt: row.last_run_at == null ? null : Number(row.last_run_at), detail: decodeStorageIdentity(row.detail),
+                seen: row.seen_known ? rows[seen].filter(item => item.task_id === row.id).map(item => decodeStorageIdentity(item.item_key)) : null,
+                ...(row.quiet_timezone == null ? {} : { quiet: { timezone: String(row.quiet_timezone), start: String(row.quiet_start), end: String(row.quiet_end) } }),
+                ...(row.pending_kind === 'absent' ? {} : { pending: row.pending_kind === 'null' ? null : {
+                        from: Number(row.pending_from), to: Number(row.pending_to), count: Number(row.pending_count), countCapped: Boolean(row.pending_capped),
+                        items: rows[items].filter(item => item.task_id === row.id).map(item => ({ key: decodeStorageIdentity(item.item_key), title: decodeStorageIdentity(item.title), link: decodeStorageIdentity(item.link) })),
+                    } }),
+            })),
+        };
+    },
+};
+export function createAdministratorRssState(database) {
+    return createRelationalStateStore(database, [codec]);
+}
+//# sourceMappingURL=storage.js.map

package/lib/storage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-rss",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "description": "RSS/Atom feed subscription plugin for Zhin.js (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -41,20 +41,20 @@
   "license": "MIT",
   "dependencies": {
     "rss-parser": "^3.13.0",
-    "@zhin.js/tool": "1.1.8",
-    "@zhin.js/im-contract": "1.1.5",
-    "@zhin.js/skill": "1.1.8"
+    "@zhin.js/im-contract": "1.1.6",
+    "@zhin.js/tool": "1.1.9",
+    "@zhin.js/skill": "1.1.9"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "1.1.13"
+    "zhin.js": "1.1.15"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/command": "^1.1.9",
-    "zhin.js": "^1.1.13"
+    "@zhin.js/command": "^1.1.10",
+    "zhin.js": "^1.1.15"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {

package/plugin.js

@@ -1,6 +1,7 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { definePlugin, databaseHostToken, outboundHostToken, scheduleHostToken, } from 'zhin.js';
+import { definePlugin, logger, databaseHostToken, outboundHostToken, scheduleHostToken, } from 'zhin.js';
 import { pluginTaskProviderToken } from 'zhin.js/plugin-runtime';
+import { createAdministratorRssState } from "./lib/storage.js";
 import { AdministratorRssTasks } from "./lib/admin-tasks.js";
 import { resolveRssConfig } from "./lib/feed.js";
 import { createInMemoryRssDb, RSS_SEEN_TABLE, RSS_SUBS_TABLE, } from "./lib/db-store.js";
@@ -69,14 +70,17 @@ export default definePlugin({
         // Keep optional in-memory/chat-only installations working. Administrator tasks
         // must have the real durable state port, exact outbound and an active scheduler.
         let administrator;
-        if (database && outbound?.sendTarget && context.resources.has(scheduleHostToken)) {
+        const structuredTasks = database && ['sqlite', 'mysql', 'pg'].includes(database.dialect);
+        if (database && !structuredTasks)
+            logger.warn('RSS 管理员任务持久化仅支持 SQLite、MySQL、PostgreSQL；聊天订阅保留现有存储方式');
+        if (structuredTasks && database && outbound?.sendTarget && context.resources.has(scheduleHostToken)) {
             let state;
             try {
                 state = database.state;
             }
             catch { /* No persistent state port: no administrator provider. */ }
             if (state) {
-                administrator = new AdministratorRssTasks(state, outbound, config);
+                administrator = new AdministratorRssTasks(createAdministratorRssState(database), outbound, config);
                 context.resources.provide(pluginTaskProviderToken, administrator);
                 context.lifecycle.add(() => administrator?.stop());
             }

package/src/storage.ts

@@ -0,0 +1,58 @@
+import { createRelationalStateStore, TASK_TARGET_COLUMNS, TASK_RECEIPT_COLUMNS, encodeTaskTarget, decodeTaskTarget,
+  encodeTaskReceipts, decodeTaskReceipts, encodeStorageIdentity, decodeStorageIdentity, type PluginDatabaseHost, type RelationalStateCodec } from 'zhin.js/plugin-runtime';
+import { ADMIN_RSS_STATE_KEY, type AdministratorRssBook } from './admin-tasks.js';
+
+const tasks = 'admin_rss_tasks', seen = 'admin_rss_seen', items = 'admin_rss_pending_items', receipts = 'admin_rss_receipts';
+const text = { type: 'text', nullable: true } as const;
+const time = { type: 'bigint', nullable: true } as const;
+const child = { id: { type: 'text', length: 80, primary: true }, task_id: { type: 'text', length: 36, nullable: false }, position: { type: 'integer', nullable: false } };
+
+const codec: RelationalStateCodec = {
+  key: ADMIN_RSS_STATE_KEY,
+  header: { table: 'admin_rss_book', definition: { version: { type: 'integer', nullable: true }, revision: text } },
+  tables: {
+    [tasks]: { id: { type: 'text', length: 36, primary: true }, position: { type: 'integer', nullable: false }, ...TASK_TARGET_COLUMNS,
+      creation: text, version: text, url: text, state: text, created_at: time, claim_id: text, last_check_at: time, last_run_at: time, detail: text,
+      seen_known: { type: 'boolean', nullable: false }, quiet_timezone: text, quiet_start: text, quiet_end: text,
+      pending_kind: text, pending_from: time, pending_to: time, pending_count: { type: 'integer', nullable: true },
+      pending_capped: { type: 'boolean', nullable: true } },
+    [seen]: { ...child, item_key: { type: 'text', nullable: false } },
+    [items]: { ...child, item_key: text, title: text, link: text },
+    [receipts]: TASK_RECEIPT_COLUMNS,
+  },
+  encode(value) {
+    const book = value as AdministratorRssBook;
+    if (![1, 2].includes(book.version) || !Array.isArray(book.tasks) || !Array.isArray(book.receipts)) throw new Error('Unsupported RSS book; original state was preserved');
+    return { header: { version: book.version, revision: book.revision }, rows: {
+      [tasks]: book.tasks.map((task, position) => ({ id: task.id, position, ...encodeTaskTarget(task.target),
+        creation: task.creation, version: task.version, url: encodeStorageIdentity(task.url), state: task.state, created_at: task.createdAt,
+        claim_id: task.claimId, last_check_at: task.lastCheckAt, last_run_at: task.lastRunAt, detail: encodeStorageIdentity(task.detail),
+        seen_known: task.seen !== null, quiet_timezone: task.quiet?.timezone ?? null, quiet_start: task.quiet?.start ?? null, quiet_end: task.quiet?.end ?? null,
+        pending_kind: task.pending === undefined ? 'absent' : task.pending === null ? 'null' : 'value',
+        pending_from: task.pending?.from ?? null, pending_to: task.pending?.to ?? null,
+        pending_count: task.pending?.count ?? null, pending_capped: task.pending?.countCapped ?? null,
+      })),
+      [seen]: book.tasks.flatMap((task: AdministratorRssBook['tasks'][number]) => (task.seen ?? []).map((key, position) => ({ id: `${task.id}:${position}`, task_id: task.id, position, item_key: encodeStorageIdentity(key) }))),
+      [items]: book.tasks.flatMap((task: AdministratorRssBook['tasks'][number]) => (task.pending?.items ?? []).map((item, position) => ({ id: `${task.id}:${position}`, task_id: task.id, position, item_key: encodeStorageIdentity(item.key), title: encodeStorageIdentity(item.title), link: encodeStorageIdentity(item.link) }))),
+      [receipts]: encodeTaskReceipts(book.receipts),
+    } };
+  },
+  decode(header, rows) {
+    return { version: Number(header.version), revision: String(header.revision), receipts: decodeTaskReceipts(rows[receipts]!),
+      tasks: rows[tasks]!.map(row => ({ id: String(row.id), target: decodeTaskTarget(row), creation: String(row.creation), version: String(row.version),
+        url: decodeStorageIdentity(row.url), state: String(row.state), createdAt: Number(row.created_at), claimId: row.claim_id == null ? null : String(row.claim_id),
+        lastCheckAt: row.last_check_at == null ? null : Number(row.last_check_at), lastRunAt: row.last_run_at == null ? null : Number(row.last_run_at), detail: decodeStorageIdentity(row.detail),
+        seen: row.seen_known ? rows[seen]!.filter(item => item.task_id === row.id).map(item => decodeStorageIdentity(item.item_key)) : null,
+        ...(row.quiet_timezone == null ? {} : { quiet: { timezone: String(row.quiet_timezone), start: String(row.quiet_start), end: String(row.quiet_end) } }),
+        ...(row.pending_kind === 'absent' ? {} : { pending: row.pending_kind === 'null' ? null : {
+          from: Number(row.pending_from), to: Number(row.pending_to), count: Number(row.pending_count), countCapped: Boolean(row.pending_capped),
+          items: rows[items]!.filter(item => item.task_id === row.id).map(item => ({ key: decodeStorageIdentity(item.item_key), title: decodeStorageIdentity(item.title), link: decodeStorageIdentity(item.link) })),
+        } }),
+      })),
+    };
+  },
+};
+
+export function createAdministratorRssState(database: PluginDatabaseHost) {
+  return createRelationalStateStore(database, [codec]);
+}