@hanwenbo/page-client
v0.1.2
Published
Injectable client for page document services
Readme
@hanwenbo/page-client
装修模块的 client 包。版本 0.1.1 是本地发布候选,正式发布状态见仓库 docs/release-readiness.md。
通过 createPageClient(base, request) 注入宿主接口前缀与请求器;身份、权限、菜品和媒体能力由宿主提供。此包只依赖公共契约,不依赖 React 或 X UI,不提供 CSS。完整接入示例与兼容合同见 https://github.com/hanwenbo/page 。
list(signal?) 为工作台读取完整页面选择列表,每次请求最多 100 条,按服务端总数继续读取后续分页;所有请求共用宿主传入的 AbortSignal。读取期间总数变化或重复/缺失记录导致结果不完整时,返回 PageError 的冲突码 42003,避免把截断列表当成成功。
大目录或宿主自有分页界面可以使用 listPage(page, signal?),每次只读取指定页;page 从 1 开始,返回 { list, total }。分页不是一致性快照,不保证读取期间发生的同数量替换能够被检测;有这类需求的宿主应提供游标或快照列表服务。
