@happyvertical/smrt-reactions

中文文档
0.62.1发布于 2026/11/17MITTypeScriptES Module近 30 天下载 1.1万

租户范围的反应和有共同参与执行的轻量级投票

中文使用文档

@happy垂直/smrt-反应

对任意租户拥有的记录采取一般反应和轻量级多选择投票。 包根导出模式、收藏和类型没有此包的节点运行时间;节点自有运行时间为 /server这不是治理投票、秘密选举、法定人数或法律审计制度.

Reaction, (中文(简体) ), Poll, (中文(简体) ), PollVote 和他们的收藏 发布s -m -r -t 清单.

这个发布是 SQLite/PostgreSQL 里程碑DuckDB 在任何连接或突变之前被拒绝,等待 SDK #1452 (英语): 独立的公共 DuckDB 适配器不分享承诺的能见度. PGlite,JSON和未知后端也遭到拒绝. 在DuckDB担保得到落实和上游核查之前,第3837号全期仍然开放。 在使用服务前应用主机正常的显示的迁移. 工厂总是打开一个无缝的自有适配器(cache: false(三); cache: true 并拒绝任意执行者形状的配置。 生成的API/CLI/MCP变异被禁用;服务执行授权和交易边界.

import { ParticipationRuntime } from '@happyvertical/smrt-reactions/server';
const options = {
  database: { type: 'postgres' as const, url: databaseUrl },
  actor: { tenantId, userId, profileId },
  authorizeRecord: async (access) => hostRecordAccess(access),
  participation: { authorize: async (request) => hostParticipation(request) },
};
const runtime = await ParticipationRuntime.create(options);
// Apply manifest migrations to runtime.database before use.
const { reactions, polls } = runtime;
await reactions.setReaction('app:Article', articleId, 'like', true);
await reactions.retract('app:Article', articleId, 'like');
const poll = await polls.create({
  recordType: 'app:Article', recordId: articleId, question: 'Next topic?',
  options: [{ id: 'parks', label: 'Parks' }, { id: 'roads', label: 'Roads' }],
  visibility: 'after_vote', anonymousTally: true,
});
await polls.vote(poll.id!, 'parks');
const projection = await polls.results(poll.id!);

主办方对演员进行认证,并验证配置属于该用户和租户. authorizeRecord 必须检查行为者的积极背景、目标所有权和要求采取的行动(read, (中文(简体) ), react, (中文(简体) ), vote, (中文(简体) ), manage) (中文(简体) ). 缺少回调/代理ID,拒绝或扔回调失败关闭. 永远不要从不信任的请求演员字段构建这些选项 。 主机通过用户连接订阅/身份和记录日期的资格 准确 ParticipationAuthorizer 从 @happyvertical/smrt-comments/participation投票需要非空的 JSON 连续决定 snapshot,例如 { planKey, eligibilityRecordDate }; 服务在初始写入时将它序列化. 这里不重复任何身份、订阅、任何城镇或会员政策.

共享 ParticipationService 拥有政策、禁令和固定窗口配额。 配置使用评论包的公开收藏 。 在同一交易中,新的反应/表决保留配额与持久性相同;失败两者都倒退。 重新检查许可和禁令,但保留现有的投票证据并避免征收新的配额。 报复不消耗配额。 反应独有性在保留配额之前在交易中进行仲裁:同时进行相同的重复收费一次,被否决的候选人插入回滚. 期望的反应状态为一等元 (tenant, target type, target ID, profile, kind) 这是独一无二的。 支持的种类导出为 REACTION_KINDS。并行写作通过数据库独有性进行仲裁;交易冲突可能由主机重审。 SQLite 报告后连接无效 SQLITE_BUSY,获取新的运行时间并重试整个操作. 没有使用进程本地锁定 .

发售选项在创建时固定(2-50个独特的ID). 一个剖析可以每次民调投票一次:相同的重试成功,不同的选择失败,通过服务证据永远不会改变. 投票排行写连环投票 行政关闭/重新开放. 开放是包容性的,关闭独家。 重新打开只清除手动关闭,绝不绕过所配置的时间窗口。 在结束表决后,保留相同的表决可以重新进行. visibility 实值 always, (中文(简体) ), after_vote,或 after_close; 隐藏结果同时省略计数和总计. 每一次投影都省去选民身份证和快照; anonymousTally 记录主机的显示意向,而这个软件包即使假的也总是返回集合. 直接的模型/收集创建,保存和删除在包服务书写范围之外被拒绝. 权威与确切的独有交易执行器相接,并在操作结束时被移除;共享根适配器从未被授权. 导出只读 runtime.database 曝光主机迁移和行政数据库访问的自有适配器. 服务本身的交易;任意的适配器注射和呼叫者拥有的交易构成在SQL合同能够证明所支持的执行者身份之前是有意的.

ReactionBar 财务报告和审定财务报表 PollCard 从 /svelte 使用授权的计数/投影道具和自动回调。 突变后刷新道具并重挂在演员/租户/记录更改上. 部件不进行获取或授权。 待定和已禁用的行动不能提交; 回调失败显示可读错误 .

验证 : pnpm --filter @happyvertical/smrt-reactions test, (中文(简体) ), typecheck, (中文(简体) ), check, (中文(简体) ), build。测试练习 SQLite 和 PostgreSQL 当 SMRT_TEST_POSTGRES_URL 提供(test:postgres 使用寄存器 CI 发射器). 见 测试设计。 。 。 .

版本与发布记录

@happyvertical/smrt-reactions 共发布 62 个版本,首次发布于 2026/10/24;过去 12 个月发布了 62 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-reactions 的常见问题

@happyvertical/smrt-reactions 是什么?

租户范围的反应和有共同参与执行的轻量级投票

如何安装 @happyvertical/smrt-reactions?

在项目目录运行 npm install @happyvertical/smrt-reactions,或使用 pnpm add / yarn add / bun add。

@happyvertical/smrt-reactions 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@happyvertical/smrt-reactions 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@happyvertical/smrt-reactions 可以商用吗?

@happyvertical/smrt-reactions 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@happyvertical/smrt-reactions 的下载量有多少?

根据 npm 官方下载统计,@happyvertical/smrt-reactions 在 2026/10/17 – 2026/11/15 这 30 天内被下载 10,513 次,日均约 350 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@happyvertical/smrt-reactions 还在维护吗?

最新版本 0.62.1 发布于 2026/11/17(今天);至今共发布 62 个版本,其中过去 12 个月发布了 62 个;首次发布于 2026/10/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。