@carloswon/cairn-memory 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (222) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/LICENSE +21 -0
  3. package/README.md +158 -2
  4. package/dist/src/agents/adapters.d.ts +82 -0
  5. package/dist/src/agents/adapters.js +209 -0
  6. package/dist/src/agents/adapters.js.map +1 -0
  7. package/dist/src/agents/config.d.ts +82 -0
  8. package/dist/src/agents/config.js +603 -0
  9. package/dist/src/agents/config.js.map +1 -0
  10. package/dist/src/agents/cordisPatch.d.ts +89 -0
  11. package/dist/src/agents/cordisPatch.js +201 -0
  12. package/dist/src/agents/cordisPatch.js.map +1 -0
  13. package/dist/src/agents/index.d.ts +2 -0
  14. package/dist/src/agents/index.js +3 -0
  15. package/dist/src/agents/index.js.map +1 -0
  16. package/dist/src/core/errors.d.ts +36 -0
  17. package/dist/src/core/errors.js +74 -0
  18. package/dist/src/core/errors.js.map +1 -0
  19. package/dist/src/core/hash.d.ts +14 -0
  20. package/dist/src/core/hash.js +48 -0
  21. package/dist/src/core/hash.js.map +1 -0
  22. package/dist/src/core/ids.d.ts +10 -0
  23. package/dist/src/core/ids.js +41 -0
  24. package/dist/src/core/ids.js.map +1 -0
  25. package/dist/src/core/index.d.ts +6 -0
  26. package/dist/src/core/index.js +7 -0
  27. package/dist/src/core/index.js.map +1 -0
  28. package/dist/src/core/scope.d.ts +78 -0
  29. package/dist/src/core/scope.js +181 -0
  30. package/dist/src/core/scope.js.map +1 -0
  31. package/dist/src/core/secrets.d.ts +13 -0
  32. package/dist/src/core/secrets.js +122 -0
  33. package/dist/src/core/secrets.js.map +1 -0
  34. package/dist/src/core/time.d.ts +7 -0
  35. package/dist/src/core/time.js +18 -0
  36. package/dist/src/core/time.js.map +1 -0
  37. package/dist/src/core/types.d.ts +133 -0
  38. package/dist/src/core/types.js +30 -0
  39. package/dist/src/core/types.js.map +1 -0
  40. package/dist/src/governance/apply.d.ts +64 -0
  41. package/dist/src/governance/apply.js +160 -0
  42. package/dist/src/governance/apply.js.map +1 -0
  43. package/dist/src/governance/dedup.d.ts +21 -0
  44. package/dist/src/governance/dedup.js +23 -0
  45. package/dist/src/governance/dedup.js.map +1 -0
  46. package/dist/src/governance/index.d.ts +16 -0
  47. package/dist/src/governance/index.js +17 -0
  48. package/dist/src/governance/index.js.map +1 -0
  49. package/dist/src/governance/propose.d.ts +78 -0
  50. package/dist/src/governance/propose.js +150 -0
  51. package/dist/src/governance/propose.js.map +1 -0
  52. package/dist/src/index.d.ts +15 -0
  53. package/dist/src/index.js +24 -0
  54. package/dist/src/index.js.map +1 -0
  55. package/dist/src/interfaces/app-service.d.ts +242 -0
  56. package/dist/src/interfaces/app-service.js +614 -0
  57. package/dist/src/interfaces/app-service.js.map +1 -0
  58. package/dist/src/interfaces/cli/main.d.ts +2 -0
  59. package/dist/src/interfaces/cli/main.js +790 -0
  60. package/dist/src/interfaces/cli/main.js.map +1 -0
  61. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  62. package/dist/src/interfaces/console/assets/page.js +39 -0
  63. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  65. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  66. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  68. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  69. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  71. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  72. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  73. package/dist/src/interfaces/console/export.d.ts +46 -0
  74. package/dist/src/interfaces/console/export.js +84 -0
  75. package/dist/src/interfaces/console/export.js.map +1 -0
  76. package/dist/src/interfaces/console/model.d.ts +372 -0
  77. package/dist/src/interfaces/console/model.js +731 -0
  78. package/dist/src/interfaces/console/model.js.map +1 -0
  79. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  80. package/dist/src/interfaces/console/review-store.js +342 -0
  81. package/dist/src/interfaces/console/review-store.js.map +1 -0
  82. package/dist/src/interfaces/console/security.d.ts +76 -0
  83. package/dist/src/interfaces/console/security.js +105 -0
  84. package/dist/src/interfaces/console/security.js.map +1 -0
  85. package/dist/src/interfaces/console/server.d.ts +45 -0
  86. package/dist/src/interfaces/console/server.js +476 -0
  87. package/dist/src/interfaces/console/server.js.map +1 -0
  88. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  89. package/dist/src/interfaces/console/suggestions.js +511 -0
  90. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  91. package/dist/src/interfaces/console/text.d.ts +4 -0
  92. package/dist/src/interfaces/console/text.js +18 -0
  93. package/dist/src/interfaces/console/text.js.map +1 -0
  94. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  95. package/dist/src/interfaces/mcp/server.js +412 -0
  96. package/dist/src/interfaces/mcp/server.js.map +1 -0
  97. package/dist/src/jobs/index.d.ts +6 -0
  98. package/dist/src/jobs/index.js +7 -0
  99. package/dist/src/jobs/index.js.map +1 -0
  100. package/dist/src/jobs/remote.d.ts +42 -0
  101. package/dist/src/jobs/remote.js +34 -0
  102. package/dist/src/jobs/remote.js.map +1 -0
  103. package/dist/src/jobs/worker.d.ts +67 -0
  104. package/dist/src/jobs/worker.js +169 -0
  105. package/dist/src/jobs/worker.js.map +1 -0
  106. package/dist/src/onboarding/auto.d.ts +88 -0
  107. package/dist/src/onboarding/auto.js +399 -0
  108. package/dist/src/onboarding/auto.js.map +1 -0
  109. package/dist/src/onboarding/batches.d.ts +103 -0
  110. package/dist/src/onboarding/batches.js +219 -0
  111. package/dist/src/onboarding/batches.js.map +1 -0
  112. package/dist/src/onboarding/discover.d.ts +54 -0
  113. package/dist/src/onboarding/discover.js +369 -0
  114. package/dist/src/onboarding/discover.js.map +1 -0
  115. package/dist/src/onboarding/import.d.ts +69 -0
  116. package/dist/src/onboarding/import.js +279 -0
  117. package/dist/src/onboarding/import.js.map +1 -0
  118. package/dist/src/onboarding/index.d.ts +24 -0
  119. package/dist/src/onboarding/index.js +22 -0
  120. package/dist/src/onboarding/index.js.map +1 -0
  121. package/dist/src/onboarding/judgement.d.ts +50 -0
  122. package/dist/src/onboarding/judgement.js +121 -0
  123. package/dist/src/onboarding/judgement.js.map +1 -0
  124. package/dist/src/onboarding/policy.d.ts +86 -0
  125. package/dist/src/onboarding/policy.js +249 -0
  126. package/dist/src/onboarding/policy.js.map +1 -0
  127. package/dist/src/projection/brief.d.ts +77 -0
  128. package/dist/src/projection/brief.js +111 -0
  129. package/dist/src/projection/brief.js.map +1 -0
  130. package/dist/src/projection/index.d.ts +1 -0
  131. package/dist/src/projection/index.js +2 -0
  132. package/dist/src/projection/index.js.map +1 -0
  133. package/dist/src/projection/markdown.d.ts +82 -0
  134. package/dist/src/projection/markdown.js +313 -0
  135. package/dist/src/projection/markdown.js.map +1 -0
  136. package/dist/src/retrieval/export.d.ts +80 -0
  137. package/dist/src/retrieval/export.js +215 -0
  138. package/dist/src/retrieval/export.js.map +1 -0
  139. package/dist/src/retrieval/index.d.ts +5 -0
  140. package/dist/src/retrieval/index.js +6 -0
  141. package/dist/src/retrieval/index.js.map +1 -0
  142. package/dist/src/retrieval/search.d.ts +37 -0
  143. package/dist/src/retrieval/search.js +294 -0
  144. package/dist/src/retrieval/search.js.map +1 -0
  145. package/dist/src/store/archives.d.ts +94 -0
  146. package/dist/src/store/archives.js +135 -0
  147. package/dist/src/store/archives.js.map +1 -0
  148. package/dist/src/store/audit.d.ts +26 -0
  149. package/dist/src/store/audit.js +48 -0
  150. package/dist/src/store/audit.js.map +1 -0
  151. package/dist/src/store/backup.d.ts +36 -0
  152. package/dist/src/store/backup.js +90 -0
  153. package/dist/src/store/backup.js.map +1 -0
  154. package/dist/src/store/blocks.d.ts +64 -0
  155. package/dist/src/store/blocks.js +104 -0
  156. package/dist/src/store/blocks.js.map +1 -0
  157. package/dist/src/store/conflicts.d.ts +52 -0
  158. package/dist/src/store/conflicts.js +112 -0
  159. package/dist/src/store/conflicts.js.map +1 -0
  160. package/dist/src/store/db.d.ts +44 -0
  161. package/dist/src/store/db.js +162 -0
  162. package/dist/src/store/db.js.map +1 -0
  163. package/dist/src/store/device.d.ts +46 -0
  164. package/dist/src/store/device.js +111 -0
  165. package/dist/src/store/device.js.map +1 -0
  166. package/dist/src/store/index.d.ts +14 -0
  167. package/dist/src/store/index.js +15 -0
  168. package/dist/src/store/index.js.map +1 -0
  169. package/dist/src/store/memories.d.ts +101 -0
  170. package/dist/src/store/memories.js +378 -0
  171. package/dist/src/store/memories.js.map +1 -0
  172. package/dist/src/store/migrate.d.ts +32 -0
  173. package/dist/src/store/migrate.js +86 -0
  174. package/dist/src/store/migrate.js.map +1 -0
  175. package/dist/src/store/open.d.ts +53 -0
  176. package/dist/src/store/open.js +177 -0
  177. package/dist/src/store/open.js.map +1 -0
  178. package/dist/src/store/outbox.d.ts +65 -0
  179. package/dist/src/store/outbox.js +137 -0
  180. package/dist/src/store/outbox.js.map +1 -0
  181. package/dist/src/store/plans.d.ts +137 -0
  182. package/dist/src/store/plans.js +243 -0
  183. package/dist/src/store/plans.js.map +1 -0
  184. package/dist/src/store/schema.d.ts +34 -0
  185. package/dist/src/store/schema.js +527 -0
  186. package/dist/src/store/schema.js.map +1 -0
  187. package/dist/src/store/scopes.d.ts +44 -0
  188. package/dist/src/store/scopes.js +220 -0
  189. package/dist/src/store/scopes.js.map +1 -0
  190. package/dist/src/store/write-guard.d.ts +10 -0
  191. package/dist/src/store/write-guard.js +10 -0
  192. package/dist/src/store/write-guard.js.map +1 -0
  193. package/dist/src/sync/apply.d.ts +24 -0
  194. package/dist/src/sync/apply.js +130 -0
  195. package/dist/src/sync/apply.js.map +1 -0
  196. package/dist/src/sync/cryptoutil.d.ts +86 -0
  197. package/dist/src/sync/cryptoutil.js +339 -0
  198. package/dist/src/sync/cryptoutil.js.map +1 -0
  199. package/dist/src/sync/events.d.ts +69 -0
  200. package/dist/src/sync/events.js +78 -0
  201. package/dist/src/sync/events.js.map +1 -0
  202. package/dist/src/sync/obs-store.d.ts +41 -0
  203. package/dist/src/sync/obs-store.js +325 -0
  204. package/dist/src/sync/obs-store.js.map +1 -0
  205. package/dist/src/sync/orchestrate.d.ts +37 -0
  206. package/dist/src/sync/orchestrate.js +84 -0
  207. package/dist/src/sync/orchestrate.js.map +1 -0
  208. package/dist/src/sync/pull.d.ts +24 -0
  209. package/dist/src/sync/pull.js +150 -0
  210. package/dist/src/sync/pull.js.map +1 -0
  211. package/dist/src/sync/push.d.ts +19 -0
  212. package/dist/src/sync/push.js +227 -0
  213. package/dist/src/sync/push.js.map +1 -0
  214. package/dist/src/sync/syncd-store.d.ts +31 -0
  215. package/dist/src/sync/syncd-store.js +92 -0
  216. package/dist/src/sync/syncd-store.js.map +1 -0
  217. package/dist/src/sync/vault.d.ts +37 -0
  218. package/dist/src/sync/vault.js +53 -0
  219. package/dist/src/sync/vault.js.map +1 -0
  220. package/docs/cairn-security.md +254 -0
  221. package/docs/cairn-usage.md +821 -0
  222. package/package.json +71 -4
@@ -0,0 +1,325 @@
1
+ /**
2
+ * Huawei OBS(S3 兼容)RemoteStore 实现(design D1:ObsRemoteStore)。
3
+ *
4
+ * 鉴权:OBS v2 头签名
5
+ * Authorization: OBS <AK>:<base64(hmac-sha1(SK, StringToSign))>
6
+ * StringToSign = `Verb\nContent-MD5\nContent-Type\nDate\nCanonicalizedResource`
7
+ * 与官方 esdk-obs-nodejs 的 doAuth 行为对齐(已核对官方源码):
8
+ * - 虚拟主机风格:URL 路径不带桶名,但 CanonicalizedResource 必须带 `/<bucket>/` 前缀;
9
+ * - CanonicalizedResource 使用 URL 编码后的对象路径(用户实测:原始中文 key 会 SignatureDoesNotMatch);
10
+ * 列举(无对象 key)时 CanonicalizedResource = `/<bucket>/`;
11
+ * - 列举 query(list-type/prefix/max-keys/continuation-token)不属于 v2 子资源,不参与签名;
12
+ * 只有 `?acl`/`?location` 等子资源才计入(本实现不使用任何子资源);
13
+ * - key 的 URL 编码 = 按 `/` 分段逐段 encodeURIComponent 后再用 `/` 连接(与 SDK
14
+ * encodeURIWithSafe(key, '/') 输出一致)。
15
+ *
16
+ * 凭据纪律(design D6 / spec「凭据不入日志」):
17
+ * SK、AK、Authorization 头与签名串绝不进入任何错误的 message/details;
18
+ * OBS 403 响应体可能回显 StringToSign 与服务端计算的签名,因此错误一律不携带响应体;
19
+ * details 中仅允许 accessKeyIdMasked(前 4 后 2 打码)。
20
+ *
21
+ * key 语义:调用方传入的 key / list prefix / (space, device) 均相对配置的公共 prefix,
22
+ * 本类只做 `prefix + key` 拼接与 URL 编码;chunk/manifest 的协议语义由调用方适配
23
+ * (getManifest(space, device) = getObject(`${space}/devices/${device}/manifest.json`),putManifest 同理)。
24
+ * OBS 无条件写、无服务端 CAS:manifest 防代次回退由调用方先 GET 自检(design D2)。
25
+ */
26
+ import { createHash, createHmac } from 'node:crypto';
27
+ import { err } from '../core/errors.js';
28
+ import { sha256Hex } from '../core/hash.js';
29
+ /** 列举单页最大对象数(OBS 上限 1000)。 */
30
+ const LIST_MAX_KEYS = 1000;
31
+ /** RFC 3986 strict:encodeURIComponent 不编码的保留字符补齐为 %XX(与 SDK 逐字符编码一致)。 */
32
+ const STRICT_ENC_RE = /[!'()*]/g;
33
+ function encodeKeyPath(key) {
34
+ return key
35
+ .split('/')
36
+ .map((seg) => encodeURIComponent(seg).replace(STRICT_ENC_RE, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`))
37
+ .join('/');
38
+ }
39
+ function toBuffer(bytes) {
40
+ return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
41
+ }
42
+ function md5Hex(bytes) {
43
+ return createHash('md5').update(toBuffer(bytes)).digest('hex');
44
+ }
45
+ function md5Base64(bytes) {
46
+ return createHash('md5').update(toBuffer(bytes)).digest('base64');
47
+ }
48
+ /** AK 打码:前 4 后 2,中间 ****;过短则完全打码。 */
49
+ function maskAccessKeyId(ak) {
50
+ if (ak.length <= 6)
51
+ return '******';
52
+ return `${ak.slice(0, 4)}****${ak.slice(-2)}`;
53
+ }
54
+ function decodeXmlEntities(text) {
55
+ return text.replace(/&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([a-zA-Z]+));/g, (whole, hex, dec, name) => {
56
+ if (hex !== undefined && hex.length > 0) {
57
+ const cp = parseInt(hex, 16);
58
+ return cp > 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : whole;
59
+ }
60
+ if (dec !== undefined && dec.length > 0) {
61
+ const cp = parseInt(dec, 10);
62
+ return cp > 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : whole;
63
+ }
64
+ switch (name) {
65
+ case 'amp': return '&';
66
+ case 'lt': return '<';
67
+ case 'gt': return '>';
68
+ case 'quot': return '"';
69
+ case 'apos': return "'";
70
+ default: return whole;
71
+ }
72
+ });
73
+ }
74
+ /** 简单正则解析列举 XML:提取 <Key>、<IsTruncated>、<NextContinuationToken>(不引 XML 库)。 */
75
+ function parseListXml(xml) {
76
+ const keys = [];
77
+ for (const m of xml.matchAll(/<Key>([\s\S]*?)<\/Key>/g)) {
78
+ keys.push(decodeXmlEntities(m[1] ?? ''));
79
+ }
80
+ const truncMatch = /<IsTruncated>\s*([a-zA-Z]+)\s*<\/IsTruncated>/.exec(xml);
81
+ const isTruncated = truncMatch !== null && (truncMatch[1]?.toLowerCase() === 'true');
82
+ let nextToken;
83
+ const tokenMatch = /<NextContinuationToken>([\s\S]*?)<\/NextContinuationToken>/.exec(xml);
84
+ if (tokenMatch !== null && tokenMatch[1] !== undefined) {
85
+ nextToken = decodeXmlEntities(tokenMatch[1]);
86
+ }
87
+ return { keys, isTruncated, nextToken };
88
+ }
89
+ export class ObsRemoteStore {
90
+ configured = true;
91
+ #cfg;
92
+ #origin;
93
+ #fetchImpl;
94
+ #now;
95
+ constructor(cfg, opts) {
96
+ if (typeof cfg?.endpoint !== 'string' || cfg.endpoint.length === 0) {
97
+ throw err('E_CONFIG_IO', 'obs_endpoint_invalid', { field: 'endpoint' });
98
+ }
99
+ let base;
100
+ try {
101
+ base = new URL(cfg.endpoint);
102
+ }
103
+ catch {
104
+ throw err('E_CONFIG_IO', 'obs_endpoint_invalid', { field: 'endpoint' });
105
+ }
106
+ if (base.protocol !== 'https:' && base.protocol !== 'http:') {
107
+ throw err('E_CONFIG_IO', 'obs_endpoint_invalid', { field: 'endpoint' });
108
+ }
109
+ if (typeof cfg.bucket !== 'string' || cfg.bucket.length === 0) {
110
+ throw err('E_CONFIG_IO', 'obs_config_invalid', { field: 'bucket' });
111
+ }
112
+ if (typeof cfg.accessKeyId !== 'string' || cfg.accessKeyId.length === 0) {
113
+ throw err('E_CONFIG_IO', 'obs_config_invalid', { field: 'accessKeyId' });
114
+ }
115
+ if (typeof cfg.secretAccessKey !== 'string' || cfg.secretAccessKey.length === 0) {
116
+ throw err('E_CONFIG_IO', 'obs_config_invalid', { field: 'secretAccessKey' });
117
+ }
118
+ if (typeof cfg.prefix !== 'string') {
119
+ throw err('E_CONFIG_IO', 'obs_config_invalid', { field: 'prefix' });
120
+ }
121
+ this.#cfg = cfg;
122
+ // 虚拟主机风格:host 前拼桶名;endpoint 已带桶名形态则不重复拼。
123
+ let host = base.host;
124
+ if (!host.startsWith(`${cfg.bucket}.`)) {
125
+ host = `${cfg.bucket}.${host}`;
126
+ }
127
+ this.#origin = `${base.protocol}//${host}`;
128
+ const fetchImpl = opts?.fetchImpl;
129
+ this.#fetchImpl = fetchImpl ?? fetch.bind(globalThis);
130
+ const now = opts?.now;
131
+ this.#now = now ?? (() => new Date());
132
+ }
133
+ /** prefix + 相对 key;拒绝空 key 与以 / 开头的 key(拼接语义会被破坏)。 */
134
+ #fullKey(key) {
135
+ if (typeof key !== 'string' || key.length === 0 || key.startsWith('/')) {
136
+ throw err('E_VALIDATION', 'obs_key_invalid', { key: String(key) });
137
+ }
138
+ return this.#cfg.prefix + key;
139
+ }
140
+ #assertSegment(value, field) {
141
+ if (typeof value !== 'string' || value.length === 0 || value.includes('/')) {
142
+ throw err('E_VALIDATION', 'obs_segment_invalid', { field });
143
+ }
144
+ }
145
+ /**
146
+ * 统一发送:计算 v2 头签名并经注入的 fetch 发出。
147
+ * fullKey = null 表示桶根列举(resource = /<bucket>/,query 不参与签名)。
148
+ */
149
+ async #send(method, fullKey, sendOpts = {}) {
150
+ const dateHeader = this.#now().toUTCString();
151
+ const contentMd5 = sendOpts.body !== undefined ? md5Base64(sendOpts.body) : '';
152
+ const contentType = sendOpts.contentType ?? '';
153
+ const path = fullKey === null ? '/' : `/${encodeKeyPath(fullKey)}`;
154
+ const resource = `/${this.#cfg.bucket}${path}`;
155
+ const stringToSign = [method, contentMd5, contentType, dateHeader, resource].join('\n');
156
+ const signature = createHmac('sha1', this.#cfg.secretAccessKey).update(stringToSign, 'utf8').digest('base64');
157
+ const headers = {
158
+ date: dateHeader,
159
+ authorization: `OBS ${this.#cfg.accessKeyId}:${signature}`,
160
+ };
161
+ if (contentMd5 !== '')
162
+ headers['content-md5'] = contentMd5;
163
+ if (contentType !== '')
164
+ headers['content-type'] = contentType;
165
+ const url = `${this.#origin}${path}${sendOpts.query ?? ''}`;
166
+ const init = { method, headers };
167
+ if (sendOpts.body !== undefined) {
168
+ // 运行时 fetch 接受任何 TypedArray;仅因类型泛型差异收窄(全局不暴露 BodyInit 名)
169
+ init.body = sendOpts.body;
170
+ }
171
+ try {
172
+ return await this.#fetchImpl(url, init);
173
+ }
174
+ catch (e) {
175
+ // fetch 失败信息不含头与凭据;不回显响应体
176
+ throw err('E_IO', 'obs_network_error', { method, cause: e instanceof Error ? e.message : String(e) });
177
+ }
178
+ }
179
+ /** 非 2xx 的统一错误映射。绝不携带响应体(403 body 可能含 StringToSign/签名)。 */
180
+ #statusError(res) {
181
+ if (res.status === 403) {
182
+ return err('E_FORBIDDEN', 'obs_access_denied', {
183
+ accessKeyIdMasked: maskAccessKeyId(this.#cfg.accessKeyId),
184
+ });
185
+ }
186
+ return err('E_IO', 'obs_remote_error', { status: res.status });
187
+ }
188
+ async getObject(key) {
189
+ const fullKey = this.#fullKey(key);
190
+ const res = await this.#send('GET', fullKey);
191
+ if (res.status === 200) {
192
+ try {
193
+ return new Uint8Array(await res.arrayBuffer());
194
+ }
195
+ catch (e) {
196
+ throw err('E_IO', 'obs_network_error', { method: 'GET', cause: e instanceof Error ? e.message : String(e) });
197
+ }
198
+ }
199
+ if (res.status === 404)
200
+ return null;
201
+ throw this.#statusError(res);
202
+ }
203
+ async putImmutable(key, bytes, hash) {
204
+ const fullKey = this.#fullKey(key);
205
+ if (typeof hash !== 'string' || !/^[0-9a-fA-F]{64}$/.test(hash)) {
206
+ // Cairn 全局 hash 形态为小写 sha256 hex(core/hash.ts),上传前先挡住非 sha256 输入
207
+ throw err('E_VALIDATION', 'obs_hash_invalid', { key, hashLength: typeof hash === 'string' ? hash.length : -1 });
208
+ }
209
+ const expectedHash = hash.toLowerCase();
210
+ const res = await this.#send('PUT', fullKey, { body: bytes, contentType: 'application/octet-stream' });
211
+ if (res.status < 200 || res.status >= 300) {
212
+ throw this.#statusError(res);
213
+ }
214
+ const etagRaw = res.headers.get('etag');
215
+ if (etagRaw !== null && etagRaw.length > 0) {
216
+ const etag = etagRaw.replace(/^"+|"+$/g, '').toLowerCase();
217
+ // OBS 标准 ETag = 内容 MD5(32 位 hex),与调用方 sha256 hash 不可能直接相等;
218
+ // 两者任一命中即完整:ETag==hash(通用 S3 兼容语义 / 假件测试),或
219
+ // ETag==md5(bytes)(真实 OBS 传输完整性校验)。都不满足才判不一致。
220
+ const etagIsMd5OfBody = etag.length === 32 && /^[0-9a-f]{32}$/.test(etag) && etag === md5Hex(bytes);
221
+ if (etag !== expectedHash && !etagIsMd5OfBody) {
222
+ throw err('E_IO', 'obs_integrity_mismatch', { key });
223
+ }
224
+ }
225
+ // 无 ETag 头(少数兼容实现):无法比对,按 2xx 接受
226
+ }
227
+ async list(prefix, cursor) {
228
+ if (typeof prefix !== 'string' || prefix.startsWith('/')) {
229
+ throw err('E_VALIDATION', 'obs_key_invalid', { prefix: String(prefix) });
230
+ }
231
+ if (cursor !== undefined && (typeof cursor !== 'string' || cursor.length === 0)) {
232
+ throw err('E_VALIDATION', 'obs_cursor_invalid', {});
233
+ }
234
+ const fullPrefix = this.#cfg.prefix + prefix;
235
+ const keys = [];
236
+ let nextCursor;
237
+ let token = cursor;
238
+ // 无 cursor:自动翻页直到 IsTruncated=false;传入 cursor:仅取一页(调用方控制节奏)。
239
+ do {
240
+ const query = `?list-type=2&prefix=${encodeURIComponent(fullPrefix)}&max-keys=${LIST_MAX_KEYS}` +
241
+ (token !== undefined ? `&continuation-token=${encodeURIComponent(token)}` : '');
242
+ const res = await this.#send('GET', null, { query });
243
+ if (res.status < 200 || res.status >= 300) {
244
+ throw this.#statusError(res);
245
+ }
246
+ let xml;
247
+ try {
248
+ xml = await res.text();
249
+ }
250
+ catch (e) {
251
+ throw err('E_IO', 'obs_network_error', { method: 'GET', cause: e instanceof Error ? e.message : String(e) });
252
+ }
253
+ const page = parseListXml(xml);
254
+ for (const k of page.keys) {
255
+ // 只剥掉 store prefix:返回 keys 与 getObject 的相对 key 域一致(含 list 参数前缀部分),
256
+ // 调用方可直接把列出的 key 回填 getObject
257
+ if (k.startsWith(this.#cfg.prefix)) {
258
+ keys.push(k.slice(this.#cfg.prefix.length));
259
+ }
260
+ }
261
+ if (page.isTruncated) {
262
+ if (page.nextToken === undefined) {
263
+ throw err('E_IO', 'obs_list_token_missing', { status: res.status });
264
+ }
265
+ nextCursor = page.nextToken;
266
+ }
267
+ else {
268
+ nextCursor = undefined;
269
+ }
270
+ if (cursor !== undefined)
271
+ break;
272
+ token = nextCursor;
273
+ } while (token !== undefined);
274
+ return nextCursor === undefined ? { keys } : { keys, nextCursor };
275
+ }
276
+ async getManifest(space, device) {
277
+ this.#assertSegment(space, 'space');
278
+ this.#assertSegment(device, 'device');
279
+ // manifest 在调用方(sync 层)是【加密字节】——本层只做字节存取,不做 JSON 解析
280
+ const manifestKey = `${space}/devices/${device}/manifest.json`;
281
+ return this.getObject(manifestKey);
282
+ }
283
+ async putManifest(space, device, manifest, expectedGeneration) {
284
+ this.#assertSegment(space, 'space');
285
+ this.#assertSegment(device, 'device');
286
+ if (typeof expectedGeneration !== 'number' || !Number.isInteger(expectedGeneration) || expectedGeneration < 0) {
287
+ throw err('E_VALIDATION', 'obs_manifest_generation_invalid', { expectedGeneration: String(expectedGeneration) });
288
+ }
289
+ // OBS 无条件写、无服务端 CAS:expectedGeneration 仅作契约校验,
290
+ // 防代次回退由调用方先 GET 自检后调用(design D2「自防回退」)。
291
+ const bytes = manifest instanceof Uint8Array ? manifest : new TextEncoder().encode(JSON.stringify(manifest));
292
+ await this.putImmutable(`${space}/devices/${device}/manifest.json`, bytes, sha256Hex(toBuffer(bytes)));
293
+ }
294
+ /**
295
+ * 删除对象(内部维护能力,供后续 purge 使用;不放入 RemoteStore 接口)。
296
+ * 404 视为已删除(幂等)。
297
+ */
298
+ async deleteObject(key) {
299
+ const fullKey = this.#fullKey(key);
300
+ const res = await this.#send('DELETE', fullKey);
301
+ if (res.status === 404)
302
+ return;
303
+ if (res.status < 200 || res.status >= 300) {
304
+ throw this.#statusError(res);
305
+ }
306
+ }
307
+ }
308
+ /**
309
+ * 从环境变量构造 ObsRemoteStore:OBS_ENDPOINT / OBS_BUCKET / OBS_PREFIX /
310
+ * OBS_ACCESS_KEY_ID / OBS_SECRET_ACCESS_KEY。任一缺失或为空返回 null(诚实降级,
311
+ * 由调用方落到 NotConfiguredRemote 语义);endpoint 形态非法则抛 E_CONFIG_IO(错误配置应显式暴露)。
312
+ */
313
+ export function obsRemoteFromEnv(env) {
314
+ const source = env ?? process.env;
315
+ const endpoint = source['OBS_ENDPOINT'];
316
+ const bucket = source['OBS_BUCKET'];
317
+ const prefix = source['OBS_PREFIX'];
318
+ const accessKeyId = source['OBS_ACCESS_KEY_ID'];
319
+ const secretAccessKey = source['OBS_SECRET_ACCESS_KEY'];
320
+ if (!endpoint || !bucket || !prefix || !accessKeyId || !secretAccessKey) {
321
+ return null;
322
+ }
323
+ return new ObsRemoteStore({ endpoint, bucket, prefix, accessKeyId, secretAccessKey });
324
+ }
325
+ //# sourceMappingURL=obs-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"obs-store.js","sourceRoot":"","sources":["../../../src/sync/obs-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import { CairnStore } from '../store/open.js';
2
+ import { RemoteStore } from '../jobs/remote.js';
3
+ import { VaultConfig } from './vault.js';
4
+ import { exportRecoveryMaterial } from './cryptoutil.js';
5
+ import { syncPush } from './push.js';
6
+ import { syncPull } from './pull.js';
7
+ import { PERSONAL_SPACE_KEY } from './vault.js';
8
+ /**
9
+ * vault 编排:配置 → RemoteStore 构造 → worker 注册 → CLI 动作。
10
+ * 未配置(vault.json 不存在)时一切同步动作以 E_VALIDATION 明确报错,
11
+ * 本地行为与 MVP 完全一致。
12
+ */
13
+ export declare function buildRemoteStore(vault: VaultConfig): RemoteStore;
14
+ export interface SyncContext {
15
+ vault: VaultConfig;
16
+ remote: RemoteStore;
17
+ }
18
+ /** vault 就绪检查:未配置 → null;配置了但环境变量缺失 → 抛错(诚实失败)。 */
19
+ export declare function syncContext(store: CairnStore): SyncContext | null;
20
+ /** 注册 worker 的真实上行 handler(configured 时调用;未配置保持诚实失败 handler)。 */
21
+ export declare function registerSyncWorker(store: CairnStore, remote: RemoteStore, vault: VaultConfig): void;
22
+ /** 初始化远端:生成/复用密钥 + 写 vault.json + 确保 personal-global 为 encrypted。 */
23
+ export declare function initRemote(store: CairnStore, input: {
24
+ provider: 'obs' | 'syncd';
25
+ obs?: {
26
+ endpoint: string;
27
+ bucket: string;
28
+ prefix: string;
29
+ };
30
+ syncd?: {
31
+ baseUrl: string;
32
+ };
33
+ }): {
34
+ vault: VaultConfig;
35
+ recovery: string;
36
+ };
37
+ export { syncPush, syncPull, exportRecoveryMaterial, PERSONAL_SPACE_KEY };
@@ -0,0 +1,84 @@
1
+ import { err } from '../core/errors.js';
2
+ import { loadVaultConfig, saveVaultConfig, ENV } from './vault.js';
3
+ import { generateVaultKeys, saveKeys, loadKeys, exportRecoveryMaterial } from './cryptoutil.js';
4
+ import { registerHandler } from '../jobs/worker.js';
5
+ import { syncPush } from './push.js';
6
+ import { syncPull } from './pull.js';
7
+ import { PERSONAL_SPACE_KEY } from './vault.js';
8
+ /**
9
+ * vault 编排:配置 → RemoteStore 构造 → worker 注册 → CLI 动作。
10
+ * 未配置(vault.json 不存在)时一切同步动作以 E_VALIDATION 明确报错,
11
+ * 本地行为与 MVP 完全一致。
12
+ */
13
+ export function buildRemoteStore(vault) {
14
+ const env = process.env;
15
+ if (vault.provider === 'obs') {
16
+ const ak = env[ENV.obsAk];
17
+ const sk = env[ENV.obsSk];
18
+ if (!vault.obs)
19
+ throw err('E_VALIDATION', 'vault.json 缺少 obs 配置');
20
+ if (!ak || !sk) {
21
+ throw err('E_FORBIDDEN', `缺少环境变量 ${ENV.obsAk} / ${ENV.obsSk};凭据只经环境变量注入,不落盘`);
22
+ }
23
+ // 延迟导入:obs-store 由并行模块提供
24
+ return newObsStore({ endpoint: vault.obs.endpoint, bucket: vault.obs.bucket, prefix: vault.obs.prefix, accessKeyId: ak, secretAccessKey: sk });
25
+ }
26
+ if (vault.provider === 'syncd') {
27
+ if (!vault.syncd)
28
+ throw err('E_VALIDATION', 'vault.json 缺少 syncd 配置');
29
+ const token = env[ENV.syncdToken];
30
+ if (!token)
31
+ throw err('E_FORBIDDEN', `缺少环境变量 ${ENV.syncdToken}`);
32
+ // vault 段并入键空间(与 OBS 布局对齐):同一 syncd 多 vault 互不可见
33
+ return newSyncdStore({ baseUrl: vault.syncd.baseUrl, token, prefix: `vaults/${vault.vaultId}/` });
34
+ }
35
+ throw err('E_VALIDATION', `未知 provider: ${String(vault.provider)}`);
36
+ }
37
+ // 延迟绑定(模块由并行实现提供)
38
+ import { ObsRemoteStore } from './obs-store.js';
39
+ import { SyncdRemoteStore } from './syncd-store.js';
40
+ function newObsStore(cfg) {
41
+ return new ObsRemoteStore(cfg);
42
+ }
43
+ function newSyncdStore(cfg) {
44
+ return new SyncdRemoteStore(cfg);
45
+ }
46
+ /** vault 就绪检查:未配置 → null;配置了但环境变量缺失 → 抛错(诚实失败)。 */
47
+ export function syncContext(store) {
48
+ const vault = loadVaultConfig(store.paths.dataDir);
49
+ if (!vault)
50
+ return null;
51
+ return { vault, remote: buildRemoteStore(vault) };
52
+ }
53
+ /** 注册 worker 的真实上行 handler(configured 时调用;未配置保持诚实失败 handler)。 */
54
+ export function registerSyncWorker(store, remote, vault) {
55
+ registerHandler('sync_upstream', (job) => {
56
+ // worker 已 claim 单个任务;push 以该任务触发批量发布(幂等:已推送修订跳过)
57
+ void syncPush(store, remote, vault, { preclaimedJobs: [{ id: job.id, entityId: job.entityId }] });
58
+ });
59
+ }
60
+ /** 初始化远端:生成/复用密钥 + 写 vault.json + 确保 personal-global 为 encrypted。 */
61
+ export function initRemote(store, input) {
62
+ store.assertWritable();
63
+ // 同步前提:personal-global 必须是 encrypted(默认预设即如此;被改过则明确失败)
64
+ const scope = store.scopes.resolvePreset('personal-global');
65
+ if (scope.syncPolicy !== 'encrypted') {
66
+ throw err('E_VALIDATION', 'personal-global 作用域不是 encrypted,无法启用云同步');
67
+ }
68
+ const existingKeys = loadKeys(store.paths.dataDir);
69
+ let keys;
70
+ if (existingKeys) {
71
+ keys = existingKeys;
72
+ }
73
+ else {
74
+ keys = generateVaultKeys();
75
+ saveKeys(store.paths.dataDir, keys);
76
+ }
77
+ // vault 前缀并入 store prefix(OBS store 的 space/device 必须是单路径段)
78
+ const obs = input.obs ? { endpoint: input.obs.endpoint, bucket: input.obs.bucket, prefix: `${input.obs.prefix}vaults/${keys.vaultId}/` } : undefined;
79
+ const vault = saveVaultConfig(store.paths.dataDir, { provider: input.provider, obs, syncd: input.syncd, vaultId: keys.vaultId });
80
+ store.audit.record('sync', 'remote_initialized', { type: 'system', id: vault.vaultId }, { provider: vault.provider });
81
+ return { vault, recovery: exportRecoveryMaterial(keys) };
82
+ }
83
+ export { syncPush, syncPull, exportRecoveryMaterial, PERSONAL_SPACE_KEY };
84
+ //# sourceMappingURL=orchestrate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orchestrate.js","sourceRoot":"","sources":["../../../src/sync/orchestrate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { CairnStore } from '../store/open.js';
2
+ import { RemoteStore } from '../jobs/remote.js';
3
+ import { VaultConfig } from './vault.js';
4
+ import { ApplyOutcome } from './apply.js';
5
+ /**
6
+ * 同步拉取(design D4):列举其他设备 → 读 manifest(密文)→ 按 headSeq 对
7
+ * 本地游标取差量 chunk → 解密 → 按事件序幂等应用 → 推进游标(单事务)。
8
+ * 中断可重入:游标只在一个 chunk 全部事件应用成功后推进。
9
+ */
10
+ export interface PullDeviceResult {
11
+ deviceId: string;
12
+ headSeq: number;
13
+ appliedBefore: number;
14
+ outcome: ApplyOutcome | null;
15
+ waited: number;
16
+ /** 该设备被跳过的原因(外来 vault / 密文不可解密),不致命。 */
17
+ skippedReason?: string;
18
+ }
19
+ export interface PullResult {
20
+ devices: PullDeviceResult[];
21
+ totalApplied: number;
22
+ }
23
+ export declare function pullCursorKey(spaceKey: string, remoteDevice: string): string;
24
+ export declare function syncPull(store: CairnStore, remote: RemoteStore, vault: VaultConfig): Promise<PullResult>;
@@ -0,0 +1,150 @@
1
+ import { err } from '../core/errors.js';
2
+ import { manifestKey, unpackChunk, } from './events.js';
3
+ import { deriveSpaceKey, loadKeys, decryptObject } from './cryptoutil.js';
4
+ import { PERSONAL_SPACE_KEY } from './vault.js';
5
+ import { applyEvents } from './apply.js';
6
+ export function pullCursorKey(spaceKey, remoteDevice) {
7
+ return `sync_pull:${spaceKey}:${remoteDevice}`;
8
+ }
9
+ function getCursor(store, spaceKey, remoteDevice) {
10
+ const row = store.db.get('SELECT value FROM meta WHERE key = ?', pullCursorKey(spaceKey, remoteDevice));
11
+ return Number(row?.value ?? 0);
12
+ }
13
+ function setCursor(store, spaceKey, remoteDevice, seq) {
14
+ const key = pullCursorKey(spaceKey, remoteDevice);
15
+ const existing = store.db.get('SELECT value FROM meta WHERE key = ?', key);
16
+ if (existing) {
17
+ store.db.run('UPDATE meta SET value = ? WHERE key = ?', String(seq), key);
18
+ }
19
+ else {
20
+ store.db.run('INSERT INTO meta (key, value) VALUES (?, ?)', key, String(seq));
21
+ }
22
+ }
23
+ function decryptManifestDoc(sealed, vaultKey, vaultId, spaceKey, device) {
24
+ const plain = decryptObject(sealed, deriveSpaceKey(vaultKey, spaceKey), {
25
+ vaultId,
26
+ spaceId: spaceKey,
27
+ kind: 'manifest',
28
+ objectId: `manifest.json|${device}`,
29
+ });
30
+ const doc = JSON.parse(Buffer.from(plain).toString('utf8'));
31
+ if (doc.vaultId !== vaultId || doc.spaceKey !== spaceKey || doc.deviceId !== device) {
32
+ throw err('E_VALIDATION', 'manifest 身份字段与寻址不一致');
33
+ }
34
+ return doc;
35
+ }
36
+ /** 解密单个 chunk 并还原事件(含完整性校验)。 */
37
+ function decryptChunk(sealed, vaultKey, vaultId, spaceKey, meta, deviceId) {
38
+ const plain = decryptObject(sealed, deriveSpaceKey(vaultKey, spaceKey), {
39
+ vaultId,
40
+ spaceId: spaceKey,
41
+ kind: 'chunk',
42
+ objectId: meta.key,
43
+ });
44
+ return unpackChunk(plain, deviceId, meta);
45
+ }
46
+ export async function syncPull(store, remote, vault) {
47
+ store.assertWritable();
48
+ const spaceKey = PERSONAL_SPACE_KEY;
49
+ const keys = loadKeys(store.paths.dataDir);
50
+ if (!keys)
51
+ throw err('E_VALIDATION', '未找到 vault 密钥(keys.json);请先 cairn vault init-remote 或导入恢复材料');
52
+ const myDevice = store.identity.deviceId;
53
+ // 发现远端设备:列举 <spaceKey>/devices/<id>/manifest.json
54
+ const listing = await remote.list(`${spaceKey}/devices/`);
55
+ const manifestSuffix = '/manifest.json';
56
+ const deviceIds = new Set();
57
+ for (const k of listing.keys) {
58
+ if (!k.endsWith(manifestSuffix))
59
+ continue;
60
+ const rel = k.slice(`${spaceKey}/devices/`.length);
61
+ const d = rel.slice(0, rel.indexOf('/'));
62
+ if (d && d !== myDevice)
63
+ deviceIds.add(d);
64
+ }
65
+ const results = [];
66
+ let totalApplied = 0;
67
+ for (const deviceId of deviceIds) {
68
+ const sealed = await remote.getManifest(spaceKey, deviceId);
69
+ if (!sealed)
70
+ continue;
71
+ if (!(sealed instanceof Uint8Array))
72
+ throw err('E_VALIDATION', '远端 manifest 不是字节对象');
73
+ // 第三轮验证 P1:外来 vault / 密钥不匹配的 manifest 解密必然失败——
74
+ // 降级为跳过 + 审计(不是密钥损坏,不能让本 vault 的同步停摆)
75
+ let manifest;
76
+ try {
77
+ manifest = decryptManifestDoc(sealed, keys.vaultKey, vault.vaultId, spaceKey, deviceId);
78
+ }
79
+ catch (e) {
80
+ const code = e.code;
81
+ if (code === 'E_VALIDATION') {
82
+ store.audit.record('sync', 'manifest_skipped', { type: 'system', id: deviceId }, { reason: 'foreign_vault_or_undecryptable' });
83
+ results.push({ deviceId, headSeq: 0, appliedBefore: 0, outcome: null, waited: 0, skippedReason: 'foreign_vault_or_undecryptable' });
84
+ continue;
85
+ }
86
+ throw e;
87
+ }
88
+ const cursor = getCursor(store, spaceKey, deviceId);
89
+ if (manifest.headSeq <= cursor) {
90
+ results.push({ deviceId, headSeq: manifest.headSeq, appliedBefore: 0, outcome: null, waited: 0 });
91
+ continue;
92
+ }
93
+ // 取 (cursor, headSeq] 覆盖的 chunk
94
+ const chunks = manifest.chunks.filter((c) => c.seqTo > cursor && c.seqFrom <= manifest.headSeq).sort((a, b) => a.seqFrom - b.seqFrom);
95
+ const events = [];
96
+ let chunkSkip = false;
97
+ for (const meta of chunks) {
98
+ const sealedChunk = await remote.getObject(chunkObjectKey(spaceKey, meta));
99
+ if (!sealedChunk) {
100
+ // chunk 缺失(上传中断于 manifest 之前的孤儿引用):跳过该 chunk,游标不越过它
101
+ store.audit.record('sync', 'chunk_missing', { type: 'system', id: meta.key }, { device: deviceId });
102
+ break;
103
+ }
104
+ try {
105
+ events.push(...decryptChunk(sealedChunk, keys.vaultKey, vault.vaultId, spaceKey, meta, deviceId));
106
+ }
107
+ catch (e) {
108
+ const code = e.code;
109
+ if (code === 'E_VALIDATION') {
110
+ // 单个 chunk 不可解密(外来/损坏):跳过该设备本轮,不拖垮整链
111
+ store.audit.record('sync', 'chunk_skipped', { type: 'system', id: meta.key }, { device: deviceId, reason: 'undecryptable' });
112
+ chunkSkip = true;
113
+ break;
114
+ }
115
+ throw e;
116
+ }
117
+ }
118
+ if (chunkSkip) {
119
+ results.push({ deviceId, headSeq: manifest.headSeq, appliedBefore: 0, outcome: null, waited: 0, skippedReason: 'undecryptable_chunk' });
120
+ continue;
121
+ }
122
+ // 按序应用
123
+ events.sort((a, b) => a.seq - b.seq);
124
+ const { outcome, waitEvents } = applyEvents(store, events, spaceKey);
125
+ // 游标推进到最后一个成功应用的事件序(等待依赖的事件不推进——下次重试)
126
+ let appliedThrough = cursor;
127
+ for (const ev of events) {
128
+ if (waitEvents.some((w) => w.seq === ev.seq && w.memoryId === ev.memoryId))
129
+ break;
130
+ appliedThrough = ev.seq;
131
+ }
132
+ if (appliedThrough > cursor)
133
+ setCursor(store, spaceKey, deviceId, appliedThrough);
134
+ const applied = (outcome?.applied ?? 0) + (outcome?.tombstoned ?? 0) + (outcome?.conflicted ?? 0);
135
+ totalApplied += applied;
136
+ results.push({
137
+ deviceId,
138
+ headSeq: manifest.headSeq,
139
+ appliedBefore: applied,
140
+ outcome,
141
+ waited: waitEvents.length,
142
+ });
143
+ }
144
+ void manifestKey;
145
+ return { devices: results, totalApplied };
146
+ }
147
+ function chunkObjectKey(spaceKey, meta) {
148
+ return `${spaceKey}/${meta.key}`;
149
+ }
150
+ //# sourceMappingURL=pull.js.map