@basenative /持续
带有TTL的信号驱动的本地持久性、冲突解决和一个 server-rehydrate钩。实际上是为BaseNative应用构建的 需要:
- 恢复飞行中的会话 跨重载、标签和设备。
- 保存表格草稿 没有定制
useEffect管道。 - 记得上次的选择吗？ （有源滤波器，排序顺序，主题）与TTL 所以它不会永远卡住。
三层，每一层都可以独立组合。
安装
pnpm add @basenative/persist
# Optional — get reactive bindings via signals
pnpm add @basenative/runtime
第1层-带TTL的扁平KV
import { loadPersisted, savePersisted, clearPersisted } from '@basenative/persist';
await savePersisted('theme', 'dark'); // forever
await savePersisted('cart', cart, 60 * 60 * 24); // 24h TTL
await loadPersisted('cart'); // null if expired
await clearPersisted('cart');
磁盘上信封是 { v, t, e } - value, savedAt-ms，
expiresAt-ms-or-null。过期的条目在读时被清除。
遗产 {...state, savedAt} 读取形状（t4bs约定）
透明的默认12小时到期-不需要迁移。
第2层-信号绑定
import { signal } from '@basenative/runtime';
import { persisted } from '@basenative/persist';
const draft = signal('');
const dispose = persisted('compose:draft', draft, {
ttlSeconds: 7 * 24 * 3600,
debounceMs: 300,
});
信号从mount上的存储中被水化，然后写入到每一个
改变。通过 resolve(local, current) 合并而不是覆盖。
适用于任何信号形状的对象 @basenative/runtime，生礁石，或
您自己的原始-任何暴露某些组合的东西 .value，
.get/.set, .subscribe.
第3层-服务器补水
来自t4bs的“会话恢复”模式 App.jsx：
import { hydrateFromServer } from '@basenative/persist';
await hydrateFromServer({
key: 't4bs:session',
ttlSeconds: 12 * 3600,
fetch: () => api.getSession(),
reconcile: (local, server) => server ?? local, // server is authoritative
onResolve: (state, { source }) => {
if (state) setSession(state);
if (source === 'server') setLoading(false);
},
onError: (e) => console.warn('session refresh failed:', e),
});
操作顺序：
- 本地缓存命中→立即发出(
source: 'local')所以UI 无需等待网络即可绘制。 fetch()运行→再发出权威结果 （source: 'server'）。- 保持权威状态。
如果获取错误，local保持不变。
存储适配器
import { setStorageAdapter, indexedDbAdapter } from '@basenative/persist';
setStorageAdapter(indexedDbAdapter()); // for big payloads
localStorageAdapter()——默认;~ 5 mb的帽子。indexedDbAdapter({ dbName, store })-选择更大的斑点。memoryAdapter()- SSR /测试/工人。
示例
游戏环节恢复
const session = signal(null);
persisted('t4bs:session', session, { ttlSeconds: 12 * 3600 });
表单草案
const draft = signal({ title: '', body: '' });
persisted('compose:draft', draft, { debounceMs: 500, ttlSeconds: 7 * 24 * 3600 });
最后的选择
const filter = signal('all');
persisted('inbox:filter', filter); // no expiry
链接
- 碱性单氧- https://github.com/DuganLabs/basenative
- 问题- - - - - - https://github.com/DuganLabs/basenative/issues
- 文档- https://github.com/DuganLabs/basenative#readme
许可证
apache - 2.0。