@godspideai/cognate-store-memory (英语)
一个可观测语义与
@godspeedai/cognate-store-sqlite数字 :
原子多部分承诺、乐观的货币、同能承诺、投影
检查点 内容处理器 以及有效载荷去除.
何时使用此软件包 : 测试,例子,和丢弃的原型。 万事俱备
进程内存 —— 没有东西能活过重启 —— 所以生产应用程序必须活过
进程需要 SQLite 存储。 两者执行相同
@godspeedai/cognate-events 存储
合同,所以一个应用软件可以在它们之间切换一行.
安装
bun add @godspeedai/cognate-store-memory
要求数 阿宝 >= 1.4.0.
快开始
import { createMemoryStore } from "@godspeedai/cognate-store-memory";
const store = createMemoryStore();
const outcome = await store.commit({
idempotency: { scope: "alice:order", key: "order-1", fingerprint: "fp-1" },
appends: [
{
streamId: "order-1",
expectedVersion: 0,
events: [
{
eventType: "order.placed",
schemaVersion: 1,
occurredAt: new Date().toISOString(),
tenant: "tenant-a",
correlationId: "corr-1",
causationId: null,
runId: null,
scopeId: "root",
payload: { sku: "widget", quantity: 2 },
},
],
},
],
result: { placed: true },
});
// { kind: "committed", events: [...], records: [], result: { placed: true } }
把店递给 createRuntime 从
@godspeedai/cognate-runtime-bun
ephemeral runtime——快速创建,每个测试隔离:
const runtime = await createRuntime({ store: { store: createMemoryStore() } /* agents, policy, ... */ });
(运行时间) store: ":memory:" 快捷键是一个不同的存储—— SQLite 执行
运行一个从未写入文件的数据库。 同样的短暂,但与SQLite的
后有耐用配置. )
商店的担保
- 原子决定. 串行附件、记录书、发箱意图和一能结果 共同行动;失败在任何地方都看不到.
- 乐观的货币. 向 Stale 流版本投掷
ConcurrencyError· ; 一个 stale 记录的掷出RecordConflictError几个赛车作家中就有一个赢了. - 引证无能. 重复键返回记录的结果而不写入第二个事实; a
用不同请求的指纹丢出重用密钥
IdempotencyMismatchError。 。 。 . - 决取之令. 读取以每个流序和全库位置返回,以及 key/id上市使用代码点顺序——与SQLite商店生产的顺序相同,所以重放 比较是存储独立的.
- 释迦.
erasePayload取消有效载荷,保存信封,并附上墓碑事件 页:1$erasures流线.
提交内容在内部序列化( 承诺队列), 因此并行 commit 要求解决一个问题
尽管API是Aync。 从商店返回的每个值都是深层副本
结果永远不会影响存储状态.
限制
- 不执着. 所有状态都活在进程内存中,并在进程退出时消失.
没有
reopen,没有耐久性,也没有备份故事——使用@godspeedai/cognate-store-sqlite数据必须存活. - 单一过程. 存储只存在于创建它的过程之内; 无法共享 跨过程或机器.
相关软件包
@godspeedai/cognate-events- 那个 存储合同,并装入该套件工具.@godspeedai/cognate-store-sqlite—— 说 长期执行同一合同.@godspeedai/cognate- SDK伞; 最容易获得运行时间的方法(这家商店回溯到它的发光模式).
许可证
阿帕奇 - 2.0