# @happyvertical/smrt-reactions 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-reactions/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:53:57.821Z
中文译文更新时间：2026-11-17T10:45:34.286Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40happyvertical/smrt-reactions
原文对照：https://npmcn.com/package/%40happyvertical/smrt-reactions/?lang=original
项目主页：https://github.com/happyvertical/smrt#readme
源码仓库：https://github.com/happyvertical/smrt

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：216 kB，44 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：svelte ^5\.57\.0
- 首次发布：2026-10-23T21:18:23.042Z
- 最新版本发布：2026-11-17T07:53:57.649Z
- 近 30 天下载量：10513（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：62（近 12 个月 62 个）

## 中文简介

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

## 安装

```sh
npm install @happyvertical/smrt-reactions
```

也可以使用：`pnpm add @happyvertical/smrt-reactions`、`yarn add @happyvertical/smrt-reactions`、`bun add @happyvertical/smrt-reactions`

## README

# @happy垂直/smrt-反应

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

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

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

```ts
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 发射器). 见 [测试设计](https://npmcn.com/package/%40happyvertical/smrt-reactions/agents/test-design.md)。 。 。 .

## 常见问题

### @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 和提交记录判断。

