@openclaw/openshell-sandbox 2026.9.4 → 2026.9.6

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 (1292) hide show
  1. package/assets/activity.svg +3 -0
  2. package/assets/icon.png +0 -0
  3. package/dist/index.js +49 -75
  4. package/node_modules/@openclaw/fs-safe/CHANGELOG.md +487 -0
  5. package/node_modules/@openclaw/fs-safe/LICENSE +1 -0
  6. package/node_modules/@openclaw/fs-safe/README.md +106 -16
  7. package/node_modules/@openclaw/fs-safe/dist/absolute-path.d.ts +0 -1
  8. package/node_modules/@openclaw/fs-safe/dist/absolute-path.js +30 -14
  9. package/node_modules/@openclaw/fs-safe/dist/advanced.d.ts +13 -3
  10. package/node_modules/@openclaw/fs-safe/dist/advanced.js +11 -1
  11. package/node_modules/@openclaw/fs-safe/dist/archive-crc32.d.ts +0 -1
  12. package/node_modules/@openclaw/fs-safe/dist/archive-crc32.js +6 -1
  13. package/node_modules/@openclaw/fs-safe/dist/archive-deadline.d.ts +0 -1
  14. package/node_modules/@openclaw/fs-safe/dist/archive-deadline.js +23 -25
  15. package/node_modules/@openclaw/fs-safe/dist/archive-durability.d.ts +23 -0
  16. package/node_modules/@openclaw/fs-safe/dist/archive-durability.js +180 -0
  17. package/node_modules/@openclaw/fs-safe/dist/archive-entry.d.ts +0 -1
  18. package/node_modules/@openclaw/fs-safe/dist/archive-entry.js +8 -8
  19. package/node_modules/@openclaw/fs-safe/dist/archive-errors.d.ts +0 -1
  20. package/node_modules/@openclaw/fs-safe/dist/archive-gzip-tail.d.ts +3 -1
  21. package/node_modules/@openclaw/fs-safe/dist/archive-gzip-tail.js +33 -8
  22. package/node_modules/@openclaw/fs-safe/dist/archive-input.d.ts +0 -1
  23. package/node_modules/@openclaw/fs-safe/dist/archive-input.js +14 -8
  24. package/node_modules/@openclaw/fs-safe/dist/archive-kind.d.ts +0 -2
  25. package/node_modules/@openclaw/fs-safe/dist/archive-kind.js +8 -19
  26. package/node_modules/@openclaw/fs-safe/dist/archive-limits.d.ts +0 -1
  27. package/node_modules/@openclaw/fs-safe/dist/archive-merge.d.ts +8 -4
  28. package/node_modules/@openclaw/fs-safe/dist/archive-merge.js +185 -59
  29. package/node_modules/@openclaw/fs-safe/dist/archive-parser-errors.d.ts +0 -1
  30. package/node_modules/@openclaw/fs-safe/dist/archive-parser.wasm +0 -0
  31. package/node_modules/@openclaw/fs-safe/dist/archive-plan.d.ts +72 -2
  32. package/node_modules/@openclaw/fs-safe/dist/archive-plan.js +86 -22
  33. package/node_modules/@openclaw/fs-safe/dist/archive-read.d.ts +0 -1
  34. package/node_modules/@openclaw/fs-safe/dist/archive-read.js +132 -114
  35. package/node_modules/@openclaw/fs-safe/dist/archive-staging.d.ts +6 -4
  36. package/node_modules/@openclaw/fs-safe/dist/archive-staging.js +100 -42
  37. package/node_modules/@openclaw/fs-safe/dist/archive-tar-stream.d.ts +14 -5
  38. package/node_modules/@openclaw/fs-safe/dist/archive-tar-stream.js +68 -36
  39. package/node_modules/@openclaw/fs-safe/dist/archive-tar-wasm.d.ts +17 -6
  40. package/node_modules/@openclaw/fs-safe/dist/archive-tar-wasm.js +129 -25
  41. package/node_modules/@openclaw/fs-safe/dist/archive-zip-admission.d.ts +2 -3
  42. package/node_modules/@openclaw/fs-safe/dist/archive-zip-admission.js +50 -14
  43. package/node_modules/@openclaw/fs-safe/dist/archive-zip-count.d.ts +0 -1
  44. package/node_modules/@openclaw/fs-safe/dist/archive-zip-count.js +21 -1
  45. package/node_modules/@openclaw/fs-safe/dist/archive-zip-directory.d.ts +7 -1
  46. package/node_modules/@openclaw/fs-safe/dist/archive-zip-directory.js +38 -3
  47. package/node_modules/@openclaw/fs-safe/dist/archive-zip-entry.d.ts +6 -3
  48. package/node_modules/@openclaw/fs-safe/dist/archive-zip-entry.js +24 -9
  49. package/node_modules/@openclaw/fs-safe/dist/archive-zip-integrity.d.ts +0 -1
  50. package/node_modules/@openclaw/fs-safe/dist/archive-zip-integrity.js +3 -4
  51. package/node_modules/@openclaw/fs-safe/dist/archive-zip-loader.d.ts +8 -0
  52. package/node_modules/@openclaw/fs-safe/dist/archive-zip-loader.js +147 -0
  53. package/node_modules/@openclaw/fs-safe/dist/archive-zip-manifest.d.ts +4 -0
  54. package/node_modules/@openclaw/fs-safe/dist/archive-zip-manifest.js +22 -0
  55. package/node_modules/@openclaw/fs-safe/dist/archive-zip-names.d.ts +7 -2
  56. package/node_modules/@openclaw/fs-safe/dist/archive-zip-names.js +67 -18
  57. package/node_modules/@openclaw/fs-safe/dist/archive-zip-preflight.d.ts +2 -4
  58. package/node_modules/@openclaw/fs-safe/dist/archive-zip-preflight.js +4 -35
  59. package/node_modules/@openclaw/fs-safe/dist/archive.d.ts +8 -6
  60. package/node_modules/@openclaw/fs-safe/dist/archive.js +225 -171
  61. package/node_modules/@openclaw/fs-safe/dist/async-lock.d.ts +0 -1
  62. package/node_modules/@openclaw/fs-safe/dist/atomic.d.ts +3 -2
  63. package/node_modules/@openclaw/fs-safe/dist/bounded-read-stream.d.ts +0 -2
  64. package/node_modules/@openclaw/fs-safe/dist/bounded-read-stream.js +0 -6
  65. package/node_modules/@openclaw/fs-safe/dist/bounded-read.d.ts +12 -1
  66. package/node_modules/@openclaw/fs-safe/dist/bounded-read.js +83 -46
  67. package/node_modules/@openclaw/fs-safe/dist/byte-budget.d.ts +0 -1
  68. package/node_modules/@openclaw/fs-safe/dist/byte-view.d.ts +2 -0
  69. package/node_modules/@openclaw/fs-safe/dist/byte-view.js +13 -0
  70. package/node_modules/@openclaw/fs-safe/dist/clone-metadata.d.ts +19 -0
  71. package/node_modules/@openclaw/fs-safe/dist/clone-metadata.js +36 -0
  72. package/node_modules/@openclaw/fs-safe/dist/config.d.ts +0 -1
  73. package/node_modules/@openclaw/fs-safe/dist/containment.d.ts +0 -1
  74. package/node_modules/@openclaw/fs-safe/dist/copy-file-input.d.ts +21 -0
  75. package/node_modules/@openclaw/fs-safe/dist/copy-file-input.js +71 -0
  76. package/node_modules/@openclaw/fs-safe/dist/copy-policy.d.ts +2 -0
  77. package/node_modules/@openclaw/fs-safe/dist/copy-policy.js +8 -0
  78. package/node_modules/@openclaw/fs-safe/dist/copy-publication.d.ts +20 -0
  79. package/node_modules/@openclaw/fs-safe/dist/copy-publication.js +33 -0
  80. package/node_modules/@openclaw/fs-safe/dist/copy-tree-portable.d.ts +8 -0
  81. package/node_modules/@openclaw/fs-safe/dist/copy-tree-portable.js +245 -0
  82. package/node_modules/@openclaw/fs-safe/dist/copy.d.ts +15 -0
  83. package/node_modules/@openclaw/fs-safe/dist/copy.js +143 -0
  84. package/node_modules/@openclaw/fs-safe/dist/create-owned-file.d.ts +7 -0
  85. package/node_modules/@openclaw/fs-safe/dist/create-owned-file.js +16 -0
  86. package/node_modules/@openclaw/fs-safe/dist/create.d.ts +17 -0
  87. package/node_modules/@openclaw/fs-safe/dist/create.js +388 -0
  88. package/node_modules/@openclaw/fs-safe/dist/creation-boundary.d.ts +60 -0
  89. package/node_modules/@openclaw/fs-safe/dist/creation-boundary.js +371 -0
  90. package/node_modules/@openclaw/fs-safe/dist/deny-mutations.d.ts +2 -3
  91. package/node_modules/@openclaw/fs-safe/dist/deny-mutations.js +61 -35
  92. package/node_modules/@openclaw/fs-safe/dist/device-path.d.ts +0 -1
  93. package/node_modules/@openclaw/fs-safe/dist/device-path.js +5 -3
  94. package/node_modules/@openclaw/fs-safe/dist/directory-durability.d.ts +7 -8
  95. package/node_modules/@openclaw/fs-safe/dist/directory-durability.js +48 -61
  96. package/node_modules/@openclaw/fs-safe/dist/directory-entry-path.d.ts +2 -0
  97. package/node_modules/@openclaw/fs-safe/dist/directory-entry-path.js +21 -0
  98. package/node_modules/@openclaw/fs-safe/dist/directory-guard.d.ts +31 -7
  99. package/node_modules/@openclaw/fs-safe/dist/directory-guard.js +136 -39
  100. package/node_modules/@openclaw/fs-safe/dist/directory-mode-node.d.ts +14 -1
  101. package/node_modules/@openclaw/fs-safe/dist/directory-mode-node.js +125 -9
  102. package/node_modules/@openclaw/fs-safe/dist/directory-mode-owner.d.ts +0 -1
  103. package/node_modules/@openclaw/fs-safe/dist/directory-mode-owner.js +5 -5
  104. package/node_modules/@openclaw/fs-safe/dist/directory-receipt.d.ts +23 -0
  105. package/node_modules/@openclaw/fs-safe/dist/directory-receipt.js +123 -0
  106. package/node_modules/@openclaw/fs-safe/dist/durability.d.ts +3 -3
  107. package/node_modules/@openclaw/fs-safe/dist/durability.js +1 -1
  108. package/node_modules/@openclaw/fs-safe/dist/effective-uid.d.ts +1 -0
  109. package/node_modules/@openclaw/fs-safe/dist/effective-uid.js +25 -0
  110. package/node_modules/@openclaw/fs-safe/dist/error-detail.d.ts +0 -1
  111. package/node_modules/@openclaw/fs-safe/dist/error-detail.js +4 -1
  112. package/node_modules/@openclaw/fs-safe/dist/errors.d.ts +0 -1
  113. package/node_modules/@openclaw/fs-safe/dist/file-cleanup.d.ts +19 -0
  114. package/node_modules/@openclaw/fs-safe/dist/file-cleanup.js +81 -0
  115. package/node_modules/@openclaw/fs-safe/dist/file-contents.d.ts +5 -0
  116. package/node_modules/@openclaw/fs-safe/dist/file-contents.js +40 -0
  117. package/node_modules/@openclaw/fs-safe/dist/file-handle-transfer.d.ts +15 -0
  118. package/node_modules/@openclaw/fs-safe/dist/file-handle-transfer.js +190 -0
  119. package/node_modules/@openclaw/fs-safe/dist/file-hash.d.ts +9 -3
  120. package/node_modules/@openclaw/fs-safe/dist/file-hash.js +273 -50
  121. package/node_modules/@openclaw/fs-safe/dist/file-identity.d.ts +0 -1
  122. package/node_modules/@openclaw/fs-safe/dist/file-identity.js +18 -4
  123. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-acquisition.d.ts +22 -0
  124. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-acquisition.js +98 -0
  125. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-admission.d.ts +17 -0
  126. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-admission.js +54 -0
  127. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-acquire.d.ts +3 -0
  128. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-acquire.js +303 -0
  129. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-arbitration.d.ts +17 -0
  130. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-arbitration.js +66 -0
  131. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-held.d.ts +32 -0
  132. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-held.js +395 -0
  133. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-io.d.ts +43 -0
  134. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-io.js +209 -0
  135. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-mutation.d.ts +16 -0
  136. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-mutation.js +275 -0
  137. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-options.d.ts +19 -0
  138. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-options.js +58 -0
  139. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-registration.d.ts +1 -0
  140. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root-registration.js +90 -0
  141. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root.d.ts +36 -0
  142. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-root.js +288 -0
  143. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-stale-admission.d.ts +19 -0
  144. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync-stale-admission.js +199 -0
  145. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync.d.ts +4 -22
  146. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync.js +226 -234
  147. package/node_modules/@openclaw/fs-safe/dist/file-lock.d.ts +0 -1
  148. package/node_modules/@openclaw/fs-safe/dist/file-lock.js +29 -9
  149. package/node_modules/@openclaw/fs-safe/dist/file-observation.d.ts +1 -2
  150. package/node_modules/@openclaw/fs-safe/dist/file-store-boundary.d.ts +9 -4
  151. package/node_modules/@openclaw/fs-safe/dist/file-store-boundary.js +69 -81
  152. package/node_modules/@openclaw/fs-safe/dist/file-store-prune.d.ts +0 -1
  153. package/node_modules/@openclaw/fs-safe/dist/file-store-prune.js +20 -6
  154. package/node_modules/@openclaw/fs-safe/dist/file-store-sync-directory.d.ts +15 -0
  155. package/node_modules/@openclaw/fs-safe/dist/file-store-sync-directory.js +319 -0
  156. package/node_modules/@openclaw/fs-safe/dist/file-store-sync-write.d.ts +1 -1
  157. package/node_modules/@openclaw/fs-safe/dist/file-store-sync-write.js +74 -73
  158. package/node_modules/@openclaw/fs-safe/dist/file-store.d.ts +4 -1
  159. package/node_modules/@openclaw/fs-safe/dist/file-store.js +71 -66
  160. package/node_modules/@openclaw/fs-safe/dist/file-sync.d.ts +0 -1
  161. package/node_modules/@openclaw/fs-safe/dist/filename.d.ts +1 -1
  162. package/node_modules/@openclaw/fs-safe/dist/filename.js +83 -36
  163. package/node_modules/@openclaw/fs-safe/dist/fs.d.ts +0 -1
  164. package/node_modules/@openclaw/fs-safe/dist/fs.js +3 -3
  165. package/node_modules/@openclaw/fs-safe/dist/guarded-mkdir.d.ts +12 -1
  166. package/node_modules/@openclaw/fs-safe/dist/guarded-mkdir.js +227 -33
  167. package/node_modules/@openclaw/fs-safe/dist/guarded-mutation.d.ts +2 -7
  168. package/node_modules/@openclaw/fs-safe/dist/guarded-mutation.js +15 -16
  169. package/node_modules/@openclaw/fs-safe/dist/guest-dispatch-python.d.ts +1 -0
  170. package/node_modules/@openclaw/fs-safe/dist/guest-dispatch-python.js +68 -0
  171. package/node_modules/@openclaw/fs-safe/dist/guest-native-python.d.ts +3 -0
  172. package/node_modules/@openclaw/fs-safe/dist/guest-native-python.js +135 -0
  173. package/node_modules/@openclaw/fs-safe/dist/guest.d.ts +8 -0
  174. package/node_modules/@openclaw/fs-safe/dist/guest.js +424 -0
  175. package/node_modules/@openclaw/fs-safe/dist/home-dir.d.ts +0 -1
  176. package/node_modules/@openclaw/fs-safe/dist/home-dir.js +81 -16
  177. package/node_modules/@openclaw/fs-safe/dist/index.d.ts +9 -7
  178. package/node_modules/@openclaw/fs-safe/dist/install-path.d.ts +6 -1
  179. package/node_modules/@openclaw/fs-safe/dist/install-path.js +73 -31
  180. package/node_modules/@openclaw/fs-safe/dist/json-document-store.d.ts +3 -1
  181. package/node_modules/@openclaw/fs-safe/dist/json-document-store.js +23 -15
  182. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-directory.d.ts +13 -1
  183. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-directory.js +137 -3
  184. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-ownership.d.ts +8 -2
  185. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-ownership.js +153 -90
  186. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-read.d.ts +5 -0
  187. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-read.js +65 -0
  188. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue.d.ts +1 -2
  189. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue.js +93 -261
  190. package/node_modules/@openclaw/fs-safe/dist/json-store.d.ts +0 -1
  191. package/node_modules/@openclaw/fs-safe/dist/json-store.js +4 -1
  192. package/node_modules/@openclaw/fs-safe/dist/json-stringify.d.ts +0 -1
  193. package/node_modules/@openclaw/fs-safe/dist/json.d.ts +0 -1
  194. package/node_modules/@openclaw/fs-safe/dist/json.js +90 -110
  195. package/node_modules/@openclaw/fs-safe/dist/local-file-access.d.ts +0 -1
  196. package/node_modules/@openclaw/fs-safe/dist/local-file-access.js +7 -10
  197. package/node_modules/@openclaw/fs-safe/dist/local-file-descriptor.d.ts +16 -0
  198. package/node_modules/@openclaw/fs-safe/dist/local-file-descriptor.js +84 -0
  199. package/node_modules/@openclaw/fs-safe/dist/local-roots.d.ts +0 -1
  200. package/node_modules/@openclaw/fs-safe/dist/local-roots.js +63 -38
  201. package/node_modules/@openclaw/fs-safe/dist/lock-config.d.ts +0 -1
  202. package/node_modules/@openclaw/fs-safe/dist/move-path-cleanup.d.ts +7 -20
  203. package/node_modules/@openclaw/fs-safe/dist/move-path-cleanup.js +100 -37
  204. package/node_modules/@openclaw/fs-safe/dist/move-path-stage.d.ts +7 -0
  205. package/node_modules/@openclaw/fs-safe/dist/move-path-stage.js +56 -0
  206. package/node_modules/@openclaw/fs-safe/dist/move-path.d.ts +0 -1
  207. package/node_modules/@openclaw/fs-safe/dist/move-path.js +120 -64
  208. package/node_modules/@openclaw/fs-safe/dist/mutation-authority.d.ts +8 -0
  209. package/node_modules/@openclaw/fs-safe/dist/mutation-authority.js +36 -0
  210. package/node_modules/@openclaw/fs-safe/dist/native-binding.d.ts +71 -2
  211. package/node_modules/@openclaw/fs-safe/dist/native-binding.js +8 -1
  212. package/node_modules/@openclaw/fs-safe/dist/native-config.d.ts +0 -1
  213. package/node_modules/@openclaw/fs-safe/dist/native-directory-observation.d.ts +16 -0
  214. package/node_modules/@openclaw/fs-safe/dist/native-directory-observation.js +37 -0
  215. package/node_modules/@openclaw/fs-safe/dist/native-fallback-warning.d.ts +3 -0
  216. package/node_modules/@openclaw/fs-safe/dist/native-fallback-warning.js +11 -0
  217. package/node_modules/@openclaw/fs-safe/dist/native-operations.d.ts +1 -7
  218. package/node_modules/@openclaw/fs-safe/dist/native-operations.js +6 -27
  219. package/node_modules/@openclaw/fs-safe/dist/native-parent-admission.d.ts +34 -0
  220. package/node_modules/@openclaw/fs-safe/dist/native-parent-admission.js +147 -0
  221. package/node_modules/@openclaw/fs-safe/dist/native-pinned-write-windows.d.ts +2 -4
  222. package/node_modules/@openclaw/fs-safe/dist/native-pinned-write-windows.js +194 -38
  223. package/node_modules/@openclaw/fs-safe/dist/native-pinned-write.d.ts +1 -2
  224. package/node_modules/@openclaw/fs-safe/dist/native-pinned-write.js +360 -49
  225. package/node_modules/@openclaw/fs-safe/dist/native-policy-directory-observation.d.ts +11 -0
  226. package/node_modules/@openclaw/fs-safe/dist/native-policy-directory-observation.js +61 -0
  227. package/node_modules/@openclaw/fs-safe/dist/native-policy-parent-windows.d.ts +13 -0
  228. package/node_modules/@openclaw/fs-safe/dist/native-policy-parent-windows.js +209 -0
  229. package/node_modules/@openclaw/fs-safe/dist/native-rename-outcome.d.ts +3 -0
  230. package/node_modules/@openclaw/fs-safe/dist/native-rename-outcome.js +8 -0
  231. package/node_modules/@openclaw/fs-safe/dist/native-staged-file.d.ts +23 -9
  232. package/node_modules/@openclaw/fs-safe/dist/native-staged-file.js +180 -100
  233. package/node_modules/@openclaw/fs-safe/dist/native.d.ts +1 -2
  234. package/node_modules/@openclaw/fs-safe/dist/native.js +9 -4
  235. package/node_modules/@openclaw/fs-safe/dist/opened-file-failure.d.ts +1 -2
  236. package/node_modules/@openclaw/fs-safe/dist/opened-file-failure.js +3 -2
  237. package/node_modules/@openclaw/fs-safe/dist/opened-realpath.d.ts +0 -1
  238. package/node_modules/@openclaw/fs-safe/dist/opened-realpath.js +16 -6
  239. package/node_modules/@openclaw/fs-safe/dist/output.d.ts +2 -1
  240. package/node_modules/@openclaw/fs-safe/dist/output.js +28 -12
  241. package/node_modules/@openclaw/fs-safe/dist/overwrite-file-handle.d.ts +7 -0
  242. package/node_modules/@openclaw/fs-safe/dist/overwrite-file-handle.js +46 -0
  243. package/node_modules/@openclaw/fs-safe/dist/owner-dacl.d.ts +0 -1
  244. package/node_modules/@openclaw/fs-safe/dist/owner-dacl.js +12 -4
  245. package/node_modules/@openclaw/fs-safe/dist/path-case.d.ts +6 -0
  246. package/node_modules/@openclaw/fs-safe/dist/path-case.js +136 -0
  247. package/node_modules/@openclaw/fs-safe/dist/path-policy.d.ts +0 -1
  248. package/node_modules/@openclaw/fs-safe/dist/path-policy.js +7 -2
  249. package/node_modules/@openclaw/fs-safe/dist/path-prefix.d.ts +6 -0
  250. package/node_modules/@openclaw/fs-safe/dist/path-prefix.js +104 -0
  251. package/node_modules/@openclaw/fs-safe/dist/path-scope-lexical.d.ts +13 -0
  252. package/node_modules/@openclaw/fs-safe/dist/path-scope-lexical.js +37 -0
  253. package/node_modules/@openclaw/fs-safe/dist/path-segment-route.d.ts +6 -0
  254. package/node_modules/@openclaw/fs-safe/dist/path-segment-route.js +24 -0
  255. package/node_modules/@openclaw/fs-safe/dist/path-suffix-aliases.d.ts +11 -0
  256. package/node_modules/@openclaw/fs-safe/dist/path-suffix-aliases.js +394 -0
  257. package/node_modules/@openclaw/fs-safe/dist/path.d.ts +0 -1
  258. package/node_modules/@openclaw/fs-safe/dist/path.js +40 -7
  259. package/node_modules/@openclaw/fs-safe/dist/permission-exec.d.ts +2 -1
  260. package/node_modules/@openclaw/fs-safe/dist/permission-exec.js +144 -21
  261. package/node_modules/@openclaw/fs-safe/dist/permissions-public.d.ts +0 -1
  262. package/node_modules/@openclaw/fs-safe/dist/permissions-windows.d.ts +2 -10
  263. package/node_modules/@openclaw/fs-safe/dist/permissions-windows.js +106 -83
  264. package/node_modules/@openclaw/fs-safe/dist/permissions.d.ts +0 -1
  265. package/node_modules/@openclaw/fs-safe/dist/permissions.js +37 -30
  266. package/node_modules/@openclaw/fs-safe/dist/pinned-mutation-admission.d.ts +24 -0
  267. package/node_modules/@openclaw/fs-safe/dist/pinned-mutation-admission.js +419 -0
  268. package/node_modules/@openclaw/fs-safe/dist/pinned-mutation-observation.d.ts +38 -0
  269. package/node_modules/@openclaw/fs-safe/dist/pinned-mutation-observation.js +205 -0
  270. package/node_modules/@openclaw/fs-safe/dist/pinned-mutation-shared-route.d.ts +24 -0
  271. package/node_modules/@openclaw/fs-safe/dist/pinned-mutation-shared-route.js +70 -0
  272. package/node_modules/@openclaw/fs-safe/dist/pinned-open.d.ts +7 -1
  273. package/node_modules/@openclaw/fs-safe/dist/pinned-open.js +35 -10
  274. package/node_modules/@openclaw/fs-safe/dist/pinned-operation.d.ts +1 -2
  275. package/node_modules/@openclaw/fs-safe/dist/pinned-operation.js +4 -17
  276. package/node_modules/@openclaw/fs-safe/dist/pinned-write-input.d.ts +3 -0
  277. package/node_modules/@openclaw/fs-safe/dist/pinned-write-input.js +35 -0
  278. package/node_modules/@openclaw/fs-safe/dist/pinned-write-mode.d.ts +4 -0
  279. package/node_modules/@openclaw/fs-safe/dist/pinned-write-mode.js +31 -0
  280. package/node_modules/@openclaw/fs-safe/dist/pinned-write-staged.d.ts +5 -0
  281. package/node_modules/@openclaw/fs-safe/dist/pinned-write-staged.js +185 -0
  282. package/node_modules/@openclaw/fs-safe/dist/pinned-write-types.d.ts +68 -0
  283. package/node_modules/@openclaw/fs-safe/dist/pinned-write.d.ts +6 -30
  284. package/node_modules/@openclaw/fs-safe/dist/pinned-write.js +202 -154
  285. package/node_modules/@openclaw/fs-safe/dist/positional-read.d.ts +8 -0
  286. package/node_modules/@openclaw/fs-safe/dist/positional-read.js +36 -0
  287. package/node_modules/@openclaw/fs-safe/dist/private-directory.d.ts +0 -1
  288. package/node_modules/@openclaw/fs-safe/dist/private-directory.js +20 -4
  289. package/node_modules/@openclaw/fs-safe/dist/private-producer-handoff-sync.d.ts +3 -0
  290. package/node_modules/@openclaw/fs-safe/dist/private-producer-handoff-sync.js +72 -0
  291. package/node_modules/@openclaw/fs-safe/dist/private-producer-handoff.d.ts +53 -0
  292. package/node_modules/@openclaw/fs-safe/dist/private-producer-handoff.js +358 -0
  293. package/node_modules/@openclaw/fs-safe/dist/private-temp-workspace.d.ts +2 -40
  294. package/node_modules/@openclaw/fs-safe/dist/private-temp-workspace.js +145 -103
  295. package/node_modules/@openclaw/fs-safe/dist/publish-copy-stage.d.ts +13 -0
  296. package/node_modules/@openclaw/fs-safe/dist/publish-copy-stage.js +56 -0
  297. package/node_modules/@openclaw/fs-safe/dist/publish-file-failure.d.ts +0 -1
  298. package/node_modules/@openclaw/fs-safe/dist/publish-file.d.ts +2 -4
  299. package/node_modules/@openclaw/fs-safe/dist/publish-file.js +110 -144
  300. package/node_modules/@openclaw/fs-safe/dist/read-open-flags.d.ts +0 -1
  301. package/node_modules/@openclaw/fs-safe/dist/read-opened-file.d.ts +0 -1
  302. package/node_modules/@openclaw/fs-safe/dist/realpath.d.ts +3 -0
  303. package/node_modules/@openclaw/fs-safe/dist/realpath.js +43 -0
  304. package/node_modules/@openclaw/fs-safe/dist/recursive-mkdir-path.d.ts +2 -0
  305. package/node_modules/@openclaw/fs-safe/dist/recursive-mkdir-path.js +8 -0
  306. package/node_modules/@openclaw/fs-safe/dist/regular-file.d.ts +0 -1
  307. package/node_modules/@openclaw/fs-safe/dist/regular-file.js +127 -201
  308. package/node_modules/@openclaw/fs-safe/dist/replace-directory.d.ts +0 -1
  309. package/node_modules/@openclaw/fs-safe/dist/replace-directory.js +269 -24
  310. package/node_modules/@openclaw/fs-safe/dist/replace-file-copy-fallback.d.ts +0 -1
  311. package/node_modules/@openclaw/fs-safe/dist/replace-file-copy-fallback.js +130 -120
  312. package/node_modules/@openclaw/fs-safe/dist/replace-file-copy-source.d.ts +0 -1
  313. package/node_modules/@openclaw/fs-safe/dist/replace-file-copy-source.js +36 -42
  314. package/node_modules/@openclaw/fs-safe/dist/replace-file-descriptor.d.ts +0 -1
  315. package/node_modules/@openclaw/fs-safe/dist/replace-file-descriptor.js +16 -17
  316. package/node_modules/@openclaw/fs-safe/dist/replace-file-mode.d.ts +2 -0
  317. package/node_modules/@openclaw/fs-safe/dist/replace-file-mode.js +10 -0
  318. package/node_modules/@openclaw/fs-safe/dist/replace-file-rename-policy.d.ts +1 -3
  319. package/node_modules/@openclaw/fs-safe/dist/replace-file-temp-owner.d.ts +18 -22
  320. package/node_modules/@openclaw/fs-safe/dist/replace-file-temp-owner.js +123 -143
  321. package/node_modules/@openclaw/fs-safe/dist/replace-file.d.ts +4 -4
  322. package/node_modules/@openclaw/fs-safe/dist/replace-file.js +58 -51
  323. package/node_modules/@openclaw/fs-safe/dist/retained-directory-replacement.d.ts +25 -0
  324. package/node_modules/@openclaw/fs-safe/dist/retained-directory-replacement.js +193 -0
  325. package/node_modules/@openclaw/fs-safe/dist/root-boundary.d.ts +29 -0
  326. package/node_modules/@openclaw/fs-safe/dist/root-boundary.js +186 -0
  327. package/node_modules/@openclaw/fs-safe/dist/root-context.d.ts +15 -10
  328. package/node_modules/@openclaw/fs-safe/dist/root-context.js +133 -42
  329. package/node_modules/@openclaw/fs-safe/dist/root-create-input.d.ts +16 -0
  330. package/node_modules/@openclaw/fs-safe/dist/root-create-input.js +93 -0
  331. package/node_modules/@openclaw/fs-safe/dist/root-directory-creation.d.ts +12 -0
  332. package/node_modules/@openclaw/fs-safe/dist/root-directory-creation.js +225 -0
  333. package/node_modules/@openclaw/fs-safe/dist/root-directory-list.d.ts +38 -0
  334. package/node_modules/@openclaw/fs-safe/dist/root-directory-list.js +382 -0
  335. package/node_modules/@openclaw/fs-safe/dist/root-directory.d.ts +22 -0
  336. package/node_modules/@openclaw/fs-safe/dist/root-directory.js +141 -0
  337. package/node_modules/@openclaw/fs-safe/dist/root-entries.d.ts +10 -0
  338. package/node_modules/@openclaw/fs-safe/dist/root-entries.js +61 -0
  339. package/node_modules/@openclaw/fs-safe/dist/root-errors.d.ts +10 -6
  340. package/node_modules/@openclaw/fs-safe/dist/root-errors.js +32 -15
  341. package/node_modules/@openclaw/fs-safe/dist/root-file-final-admission.d.ts +20 -0
  342. package/node_modules/@openclaw/fs-safe/dist/root-file-final-admission.js +86 -0
  343. package/node_modules/@openclaw/fs-safe/dist/root-file.d.ts +2 -1
  344. package/node_modules/@openclaw/fs-safe/dist/root-file.js +113 -25
  345. package/node_modules/@openclaw/fs-safe/dist/root-impl.d.ts +17 -63
  346. package/node_modules/@openclaw/fs-safe/dist/root-impl.js +803 -590
  347. package/node_modules/@openclaw/fs-safe/dist/root-move-noreplace.d.ts +15 -0
  348. package/node_modules/@openclaw/fs-safe/dist/root-move-noreplace.js +205 -0
  349. package/node_modules/@openclaw/fs-safe/dist/root-move-preflight.d.ts +7 -0
  350. package/node_modules/@openclaw/fs-safe/dist/root-move-preflight.js +16 -0
  351. package/node_modules/@openclaw/fs-safe/dist/root-observed-path.d.ts +8 -0
  352. package/node_modules/@openclaw/fs-safe/dist/root-observed-path.js +93 -0
  353. package/node_modules/@openclaw/fs-safe/dist/root-options.d.ts +84 -0
  354. package/node_modules/@openclaw/fs-safe/dist/root-options.js +18 -0
  355. package/node_modules/@openclaw/fs-safe/dist/root-path-errors.d.ts +12 -0
  356. package/node_modules/@openclaw/fs-safe/dist/root-path-errors.js +22 -0
  357. package/node_modules/@openclaw/fs-safe/dist/root-path-existing.d.ts +10 -1
  358. package/node_modules/@openclaw/fs-safe/dist/root-path-existing.js +133 -41
  359. package/node_modules/@openclaw/fs-safe/dist/root-path-observation.d.ts +62 -0
  360. package/node_modules/@openclaw/fs-safe/dist/root-path-observation.js +180 -0
  361. package/node_modules/@openclaw/fs-safe/dist/root-path-stat.d.ts +4 -0
  362. package/node_modules/@openclaw/fs-safe/dist/root-path-stat.js +151 -0
  363. package/node_modules/@openclaw/fs-safe/dist/root-path.d.ts +14 -1
  364. package/node_modules/@openclaw/fs-safe/dist/root-path.js +292 -330
  365. package/node_modules/@openclaw/fs-safe/dist/root-paths-lexical.d.ts +8 -0
  366. package/node_modules/@openclaw/fs-safe/dist/root-paths-lexical.js +22 -0
  367. package/node_modules/@openclaw/fs-safe/dist/root-paths.d.ts +3 -30
  368. package/node_modules/@openclaw/fs-safe/dist/root-paths.js +89 -174
  369. package/node_modules/@openclaw/fs-safe/dist/root-public-types.d.ts +11 -0
  370. package/node_modules/@openclaw/fs-safe/dist/root-public-types.js +1 -0
  371. package/node_modules/@openclaw/fs-safe/dist/root-read-admission.d.ts +25 -0
  372. package/node_modules/@openclaw/fs-safe/dist/root-read-admission.js +86 -0
  373. package/node_modules/@openclaw/fs-safe/dist/root-remove-identity.d.ts +14 -0
  374. package/node_modules/@openclaw/fs-safe/dist/root-remove-identity.js +87 -0
  375. package/node_modules/@openclaw/fs-safe/dist/root-remove-receipt.d.ts +16 -0
  376. package/node_modules/@openclaw/fs-safe/dist/root-remove-receipt.js +37 -0
  377. package/node_modules/@openclaw/fs-safe/dist/root-remove.d.ts +6 -0
  378. package/node_modules/@openclaw/fs-safe/dist/root-remove.js +464 -0
  379. package/node_modules/@openclaw/fs-safe/dist/root-symlink-policy.d.ts +13 -0
  380. package/node_modules/@openclaw/fs-safe/dist/root-symlink-policy.js +34 -0
  381. package/node_modules/@openclaw/fs-safe/dist/root-walk.d.ts +6 -6
  382. package/node_modules/@openclaw/fs-safe/dist/root-walk.js +116 -51
  383. package/node_modules/@openclaw/fs-safe/dist/root-write-admission.d.ts +65 -0
  384. package/node_modules/@openclaw/fs-safe/dist/root-write-admission.js +304 -0
  385. package/node_modules/@openclaw/fs-safe/dist/root-write-compatibility.d.ts +11 -0
  386. package/node_modules/@openclaw/fs-safe/dist/root-write-compatibility.js +23 -0
  387. package/node_modules/@openclaw/fs-safe/dist/root-write-complete-parent.d.ts +41 -0
  388. package/node_modules/@openclaw/fs-safe/dist/root-write-complete-parent.js +180 -0
  389. package/node_modules/@openclaw/fs-safe/dist/root-write-lock-binding.d.ts +14 -0
  390. package/node_modules/@openclaw/fs-safe/dist/root-write-lock-binding.js +162 -0
  391. package/node_modules/@openclaw/fs-safe/dist/root-write-mode.d.ts +2 -1
  392. package/node_modules/@openclaw/fs-safe/dist/root-write-mode.js +22 -11
  393. package/node_modules/@openclaw/fs-safe/dist/root-write-publication.d.ts +23 -0
  394. package/node_modules/@openclaw/fs-safe/dist/root-write-publication.js +85 -0
  395. package/node_modules/@openclaw/fs-safe/dist/root-write-verification.d.ts +1 -2
  396. package/node_modules/@openclaw/fs-safe/dist/root-write-verification.js +35 -37
  397. package/node_modules/@openclaw/fs-safe/dist/root.d.ts +2 -4
  398. package/node_modules/@openclaw/fs-safe/dist/safe-path-segment.d.ts +1 -2
  399. package/node_modules/@openclaw/fs-safe/dist/safe-path-segment.js +5 -6
  400. package/node_modules/@openclaw/fs-safe/dist/secret-file.d.ts +1 -1
  401. package/node_modules/@openclaw/fs-safe/dist/secret-file.js +60 -52
  402. package/node_modules/@openclaw/fs-safe/dist/secret-read-async.d.ts +0 -1
  403. package/node_modules/@openclaw/fs-safe/dist/secret-read-async.js +13 -28
  404. package/node_modules/@openclaw/fs-safe/dist/secret-read-policy.d.ts +6 -3
  405. package/node_modules/@openclaw/fs-safe/dist/secret-read-policy.js +31 -3
  406. package/node_modules/@openclaw/fs-safe/dist/secret.d.ts +0 -1
  407. package/node_modules/@openclaw/fs-safe/dist/secure-file-windows.d.ts +10 -0
  408. package/node_modules/@openclaw/fs-safe/dist/secure-file-windows.js +88 -0
  409. package/node_modules/@openclaw/fs-safe/dist/secure-file.d.ts +1 -2
  410. package/node_modules/@openclaw/fs-safe/dist/secure-file.js +143 -28
  411. package/node_modules/@openclaw/fs-safe/dist/secure-temp-dir.d.ts +6 -4
  412. package/node_modules/@openclaw/fs-safe/dist/secure-temp-dir.js +122 -101
  413. package/node_modules/@openclaw/fs-safe/dist/secure-temp-repair.d.ts +34 -0
  414. package/node_modules/@openclaw/fs-safe/dist/secure-temp-repair.js +110 -0
  415. package/node_modules/@openclaw/fs-safe/dist/sibling-staged-file.d.ts +4 -2
  416. package/node_modules/@openclaw/fs-safe/dist/sibling-staged-file.js +215 -57
  417. package/node_modules/@openclaw/fs-safe/dist/sibling-temp.d.ts +2 -1
  418. package/node_modules/@openclaw/fs-safe/dist/sibling-temp.js +64 -27
  419. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-acquire.d.ts +2 -29
  420. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-acquire.js +298 -192
  421. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-admission-context.d.ts +18 -0
  422. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-admission-context.js +60 -0
  423. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-admission-parser.d.ts +42 -0
  424. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-admission-parser.js +113 -0
  425. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-admission.d.ts +31 -0
  426. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-admission.js +1 -0
  427. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-handle.d.ts +3 -1
  428. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-handle.js +6 -0
  429. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-policy.d.ts +6 -1
  430. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-policy.js +45 -3
  431. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-reclaim.d.ts +10 -6
  432. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-reclaim.js +106 -36
  433. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-registration.d.ts +13 -0
  434. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-registration.js +47 -0
  435. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-root.d.ts +0 -1
  436. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-root.js +5 -2
  437. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-stale-admission.d.ts +38 -0
  438. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-stale-admission.js +228 -0
  439. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-target.d.ts +7 -0
  440. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-target.js +55 -0
  441. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-types.d.ts +22 -17
  442. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock.d.ts +0 -1
  443. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock.js +47 -32
  444. package/node_modules/@openclaw/fs-safe/dist/staged-directory.d.ts +18 -7
  445. package/node_modules/@openclaw/fs-safe/dist/staged-directory.js +98 -10
  446. package/node_modules/@openclaw/fs-safe/dist/staged-file-settlement.d.ts +16 -0
  447. package/node_modules/@openclaw/fs-safe/dist/staged-file-settlement.js +57 -0
  448. package/node_modules/@openclaw/fs-safe/dist/staged-file-types.d.ts +0 -1
  449. package/node_modules/@openclaw/fs-safe/dist/stat-observation.d.ts +10 -0
  450. package/node_modules/@openclaw/fs-safe/dist/stat-observation.js +64 -0
  451. package/node_modules/@openclaw/fs-safe/dist/store.d.ts +0 -1
  452. package/node_modules/@openclaw/fs-safe/dist/strict-file-identity.d.ts +1 -2
  453. package/node_modules/@openclaw/fs-safe/dist/strict-file-identity.js +41 -4
  454. package/node_modules/@openclaw/fs-safe/dist/string-coerce.d.ts +0 -1
  455. package/node_modules/@openclaw/fs-safe/dist/suppressed-error.d.ts +0 -1
  456. package/node_modules/@openclaw/fs-safe/dist/symlink-parents.d.ts +0 -1
  457. package/node_modules/@openclaw/fs-safe/dist/symlink-parents.js +9 -29
  458. package/node_modules/@openclaw/fs-safe/dist/temp-cleanup.d.ts +0 -1
  459. package/node_modules/@openclaw/fs-safe/dist/temp-cleanup.js +3 -2
  460. package/node_modules/@openclaw/fs-safe/dist/temp-target.d.ts +16 -13
  461. package/node_modules/@openclaw/fs-safe/dist/temp-target.js +120 -19
  462. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-admission.d.ts +14 -0
  463. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-admission.js +392 -0
  464. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-child-admission.d.ts +23 -0
  465. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-child-admission.js +151 -0
  466. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-descriptor.d.ts +42 -0
  467. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-descriptor.js +342 -0
  468. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-owner.d.ts +8 -7
  469. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-owner.js +156 -73
  470. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-types.d.ts +39 -0
  471. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-types.js +1 -0
  472. package/node_modules/@openclaw/fs-safe/dist/temp.d.ts +1 -2
  473. package/node_modules/@openclaw/fs-safe/dist/temp.js +1 -1
  474. package/node_modules/@openclaw/fs-safe/dist/test-hooks.d.ts +7 -1
  475. package/node_modules/@openclaw/fs-safe/dist/text-atomic.d.ts +0 -1
  476. package/node_modules/@openclaw/fs-safe/dist/text-atomic.js +3 -1
  477. package/node_modules/@openclaw/fs-safe/dist/timing.d.ts +1 -1
  478. package/node_modules/@openclaw/fs-safe/dist/timing.js +25 -6
  479. package/node_modules/@openclaw/fs-safe/dist/trash.d.ts +0 -1
  480. package/node_modules/@openclaw/fs-safe/dist/trash.js +61 -13
  481. package/node_modules/@openclaw/fs-safe/dist/types.d.ts +0 -1
  482. package/node_modules/@openclaw/fs-safe/dist/unicode-path.d.ts +2 -0
  483. package/node_modules/@openclaw/fs-safe/dist/unicode-path.js +16 -0
  484. package/node_modules/@openclaw/fs-safe/dist/walk.d.ts +5 -2
  485. package/node_modules/@openclaw/fs-safe/dist/walk.js +47 -47
  486. package/node_modules/@openclaw/fs-safe/dist/windows-command.d.ts +0 -1
  487. package/node_modules/@openclaw/fs-safe/dist/windows-owner.d.ts +9 -13
  488. package/node_modules/@openclaw/fs-safe/dist/windows-owner.js +36 -61
  489. package/node_modules/@openclaw/fs-safe/dist/windows-path-alias.d.ts +39 -0
  490. package/node_modules/@openclaw/fs-safe/dist/windows-path-alias.js +122 -0
  491. package/node_modules/@openclaw/fs-safe/dist/windows-path-syntax.d.ts +5 -0
  492. package/node_modules/@openclaw/fs-safe/dist/windows-path-syntax.js +21 -0
  493. package/node_modules/@openclaw/fs-safe/dist/windows-security-bridge.cs +336 -0
  494. package/node_modules/@openclaw/fs-safe/dist/windows-security-bridge.ps1 +15 -0
  495. package/node_modules/@openclaw/fs-safe/dist/windows-security-command.d.ts +25 -0
  496. package/node_modules/@openclaw/fs-safe/dist/windows-security-command.js +363 -0
  497. package/node_modules/@openclaw/fs-safe/dist/windows-security-facts.d.ts +5 -0
  498. package/node_modules/@openclaw/fs-safe/dist/windows-security-facts.js +108 -0
  499. package/node_modules/@openclaw/fs-safe/dist/write-file-handle.d.ts +13 -0
  500. package/node_modules/@openclaw/fs-safe/dist/write-file-handle.js +49 -0
  501. package/node_modules/@openclaw/fs-safe/dist/write-open-flags.d.ts +0 -1
  502. package/node_modules/@openclaw/fs-safe/dist/write-open-flags.js +1 -9
  503. package/node_modules/@openclaw/fs-safe/dist/write-queue.d.ts +0 -1
  504. package/node_modules/@openclaw/fs-safe/dist/write-queue.js +1 -4
  505. package/node_modules/@openclaw/fs-safe/docs/advanced.md +123 -7
  506. package/node_modules/@openclaw/fs-safe/docs/archive.md +227 -42
  507. package/node_modules/@openclaw/fs-safe/docs/atomic.md +199 -12
  508. package/node_modules/@openclaw/fs-safe/docs/config.md +7 -2
  509. package/node_modules/@openclaw/fs-safe/docs/contributing.md +88 -6
  510. package/node_modules/@openclaw/fs-safe/docs/copy.md +197 -0
  511. package/node_modules/@openclaw/fs-safe/docs/creation.md +132 -0
  512. package/node_modules/@openclaw/fs-safe/docs/directory-identity.md +85 -0
  513. package/node_modules/@openclaw/fs-safe/docs/durability.md +130 -5
  514. package/node_modules/@openclaw/fs-safe/docs/entries.md +109 -0
  515. package/node_modules/@openclaw/fs-safe/docs/errors.md +18 -10
  516. package/node_modules/@openclaw/fs-safe/docs/file-contents.md +68 -0
  517. package/node_modules/@openclaw/fs-safe/docs/file-store.md +112 -6
  518. package/node_modules/@openclaw/fs-safe/docs/filename.md +21 -7
  519. package/node_modules/@openclaw/fs-safe/docs/guest.md +146 -0
  520. package/node_modules/@openclaw/fs-safe/docs/in-place-write.md +81 -0
  521. package/node_modules/@openclaw/fs-safe/docs/index.md +2 -0
  522. package/node_modules/@openclaw/fs-safe/docs/install-path.md +61 -15
  523. package/node_modules/@openclaw/fs-safe/docs/install.md +69 -10
  524. package/node_modules/@openclaw/fs-safe/docs/json-store.md +20 -1
  525. package/node_modules/@openclaw/fs-safe/docs/json.md +16 -4
  526. package/node_modules/@openclaw/fs-safe/docs/local-roots.md +10 -1
  527. package/node_modules/@openclaw/fs-safe/docs/migrating-to-0.5.md +15 -6
  528. package/node_modules/@openclaw/fs-safe/docs/migrating-to-0.6.md +9 -4
  529. package/node_modules/@openclaw/fs-safe/docs/mutation-policy-proof.md +69 -0
  530. package/node_modules/@openclaw/fs-safe/docs/native-helper.md +75 -16
  531. package/node_modules/@openclaw/fs-safe/docs/native.md +108 -15
  532. package/node_modules/@openclaw/fs-safe/docs/output.md +61 -7
  533. package/node_modules/@openclaw/fs-safe/docs/path-case.md +64 -0
  534. package/node_modules/@openclaw/fs-safe/docs/path-prefix.md +74 -0
  535. package/node_modules/@openclaw/fs-safe/docs/path-scope.md +1 -1
  536. package/node_modules/@openclaw/fs-safe/docs/path-suffix-aliases.md +204 -0
  537. package/node_modules/@openclaw/fs-safe/docs/path.md +16 -5
  538. package/node_modules/@openclaw/fs-safe/docs/permissions.md +106 -20
  539. package/node_modules/@openclaw/fs-safe/docs/positional-read.md +63 -0
  540. package/node_modules/@openclaw/fs-safe/docs/private-file-store.md +14 -0
  541. package/node_modules/@openclaw/fs-safe/docs/public-api.md +51 -2
  542. package/node_modules/@openclaw/fs-safe/docs/quickstart.md +1 -1
  543. package/node_modules/@openclaw/fs-safe/docs/reading.md +16 -3
  544. package/node_modules/@openclaw/fs-safe/docs/regular-file.md +3 -0
  545. package/node_modules/@openclaw/fs-safe/docs/root.md +294 -15
  546. package/node_modules/@openclaw/fs-safe/docs/secret-file.md +28 -2
  547. package/node_modules/@openclaw/fs-safe/docs/secure-file.md +28 -16
  548. package/node_modules/@openclaw/fs-safe/docs/security-model.md +90 -9
  549. package/node_modules/@openclaw/fs-safe/docs/sidecar-lock.md +163 -7
  550. package/node_modules/@openclaw/fs-safe/docs/staged-file.md +16 -6
  551. package/node_modules/@openclaw/fs-safe/docs/store.md +35 -2
  552. package/node_modules/@openclaw/fs-safe/docs/temp.md +313 -29
  553. package/node_modules/@openclaw/fs-safe/docs/test-hooks.md +14 -0
  554. package/node_modules/@openclaw/fs-safe/docs/timing.md +2 -0
  555. package/node_modules/@openclaw/fs-safe/docs/types.md +35 -12
  556. package/node_modules/@openclaw/fs-safe/docs/walk.md +128 -6
  557. package/node_modules/@openclaw/fs-safe/docs/writing.md +314 -20
  558. package/node_modules/@openclaw/fs-safe/package.json +33 -20
  559. package/node_modules/@openclaw/fs-safe-darwin-arm64/fs-safe-native.node +0 -0
  560. package/node_modules/@openclaw/fs-safe-darwin-arm64/package.json +1 -1
  561. package/node_modules/@openclaw/fs-safe-darwin-x64/fs-safe-native.node +0 -0
  562. package/node_modules/@openclaw/fs-safe-darwin-x64/package.json +1 -1
  563. package/node_modules/@openclaw/fs-safe-linux-arm64-gnu/fs-safe-native.node +0 -0
  564. package/node_modules/@openclaw/fs-safe-linux-arm64-gnu/package.json +1 -1
  565. package/node_modules/@openclaw/fs-safe-linux-arm64-musl/fs-safe-native.node +0 -0
  566. package/node_modules/@openclaw/fs-safe-linux-arm64-musl/package.json +1 -1
  567. package/node_modules/@openclaw/fs-safe-linux-x64-gnu/fs-safe-native.node +0 -0
  568. package/node_modules/@openclaw/fs-safe-linux-x64-gnu/package.json +1 -1
  569. package/node_modules/@openclaw/fs-safe-linux-x64-musl/fs-safe-native.node +0 -0
  570. package/node_modules/@openclaw/fs-safe-linux-x64-musl/package.json +1 -1
  571. package/node_modules/@openclaw/fs-safe-win32-x64-msvc/fs-safe-native.node +0 -0
  572. package/node_modules/@openclaw/fs-safe-win32-x64-msvc/package.json +1 -1
  573. package/node_modules/jszip/.github/FUNDING.yml +1 -0
  574. package/node_modules/jszip/.github/actions/setup/action.yml +23 -0
  575. package/node_modules/jszip/.github/workflows/benchmark.yml +38 -0
  576. package/node_modules/jszip/.github/workflows/main.yml +55 -0
  577. package/node_modules/jszip/CHANGES.md +6 -0
  578. package/node_modules/jszip/dist/jszip.js +28 -19
  579. package/node_modules/jszip/dist/jszip.min.js +2 -2
  580. package/node_modules/jszip/index.d.ts +14 -0
  581. package/node_modules/jszip/lib/index.js +1 -1
  582. package/node_modules/jszip/lib/utils.js +26 -17
  583. package/node_modules/jszip/package.json +2 -2
  584. package/node_modules/p-limit/index.d.ts +1 -1
  585. package/node_modules/p-limit/index.js +6 -1
  586. package/node_modules/p-limit/package.json +1 -1
  587. package/node_modules/p-limit/readme.md +8 -0
  588. package/node_modules/zod/README.md +29 -2
  589. package/node_modules/zod/compile.cjs +96 -0
  590. package/node_modules/zod/compile.d.cts +1 -0
  591. package/node_modules/zod/compile.d.ts +1 -0
  592. package/node_modules/zod/compile.js +52 -0
  593. package/node_modules/zod/index.cjs +21 -2
  594. package/node_modules/zod/index.d.cts +1 -2
  595. package/node_modules/zod/index.d.ts +1 -2
  596. package/node_modules/zod/index.js +5 -2
  597. package/node_modules/zod/locales/index.cjs +19 -0
  598. package/node_modules/zod/mini/index.cjs +19 -0
  599. package/node_modules/zod/package.json +20 -8
  600. package/node_modules/zod/src/compile.ts +56 -0
  601. package/node_modules/zod/src/index.ts +5 -2
  602. package/node_modules/zod/src/v3/ZodError.ts +22 -12
  603. package/node_modules/zod/src/v3/helpers/errorUtil.ts +1 -1
  604. package/node_modules/zod/src/v3/tests/error.test.ts +35 -0
  605. package/node_modules/zod/src/v3/tests/intersection.test.ts +18 -0
  606. package/node_modules/zod/src/v3/tests/language-server.test.ts +1 -2
  607. package/node_modules/zod/src/v3/tests/object.test.ts +3 -6
  608. package/node_modules/zod/src/v3/tests/readonly.test.ts +0 -80
  609. package/node_modules/zod/src/v3/tests/string.test.ts +6 -0
  610. package/node_modules/zod/src/v3/types.ts +5 -5
  611. package/node_modules/zod/src/v4/classic/checks.ts +1 -0
  612. package/node_modules/zod/src/v4/classic/compat.ts +26 -18
  613. package/node_modules/zod/src/v4/classic/deep-partial.ts +76 -0
  614. package/node_modules/zod/src/v4/classic/errors.ts +59 -44
  615. package/node_modules/zod/src/v4/classic/external.ts +14 -9
  616. package/node_modules/zod/src/v4/classic/from-json-schema.ts +363 -78
  617. package/node_modules/zod/src/v4/classic/in-out.ts +45 -0
  618. package/node_modules/zod/src/v4/classic/index.ts +2 -2
  619. package/node_modules/zod/src/v4/classic/iso.ts +2 -72
  620. package/node_modules/zod/src/v4/classic/parse.ts +10 -4
  621. package/node_modules/zod/src/v4/classic/schemas.ts +640 -375
  622. package/node_modules/zod/src/v4/classic/tests/apply.test.ts +27 -0
  623. package/node_modules/zod/src/v4/classic/tests/array.test.ts +2 -2
  624. package/node_modules/zod/src/v4/classic/tests/assignability.test.ts +186 -0
  625. package/node_modules/zod/src/v4/classic/tests/bigint.test.ts +36 -1
  626. package/node_modules/zod/src/v4/classic/tests/catch.test.ts +278 -0
  627. package/node_modules/zod/src/v4/classic/tests/codec-examples.test.ts +1 -2
  628. package/node_modules/zod/src/v4/classic/tests/codec.test.ts +2 -1
  629. package/node_modules/zod/src/v4/classic/tests/continuability.test.ts +3 -3
  630. package/node_modules/zod/src/v4/classic/tests/credit-card.test.ts +76 -0
  631. package/node_modules/zod/src/v4/classic/tests/cyclic-data.test.ts +985 -0
  632. package/node_modules/zod/src/v4/classic/tests/date.test.ts +30 -0
  633. package/node_modules/zod/src/v4/classic/tests/datetime.test.ts +32 -18
  634. package/node_modules/zod/src/v4/classic/tests/deep-partial.test.ts +380 -0
  635. package/node_modules/zod/src/v4/classic/tests/default-locale.test.ts +32 -0
  636. package/node_modules/zod/src/v4/classic/tests/default.test.ts +46 -0
  637. package/node_modules/zod/src/v4/classic/tests/detached-methods.test.ts +31 -7
  638. package/node_modules/zod/src/v4/classic/tests/discriminated-unions.test.ts +261 -13
  639. package/node_modules/zod/src/v4/classic/tests/enum.test.ts +20 -0
  640. package/node_modules/zod/src/v4/classic/tests/error-utils.test.ts +112 -2
  641. package/node_modules/zod/src/v4/classic/tests/error.test.ts +403 -6
  642. package/node_modules/zod/src/v4/classic/tests/from-json-schema.test.ts +582 -10
  643. package/node_modules/zod/src/v4/classic/tests/function.test.ts +31 -0
  644. package/node_modules/zod/src/v4/classic/tests/global-config.test.ts +2 -9
  645. package/node_modules/zod/src/v4/classic/tests/hash.test.ts +1 -2
  646. package/node_modules/zod/src/v4/classic/tests/iban.test.ts +81 -0
  647. package/node_modules/zod/src/v4/classic/tests/in-out.test.ts +159 -0
  648. package/node_modules/zod/src/v4/classic/tests/index.test.ts +21 -2
  649. package/node_modules/zod/src/v4/classic/tests/instance-footprint.test.ts +319 -0
  650. package/node_modules/zod/src/v4/classic/tests/instanceof.test.ts +67 -0
  651. package/node_modules/zod/src/v4/classic/tests/intersection.test.ts +136 -0
  652. package/node_modules/zod/src/v4/classic/tests/issue-schema.test.ts +215 -0
  653. package/node_modules/zod/src/v4/classic/tests/jitless-allows-eval.test.ts +3 -10
  654. package/node_modules/zod/src/v4/classic/tests/lazy.test.ts +36 -1
  655. package/node_modules/zod/src/v4/classic/tests/literal.test.ts +12 -1
  656. package/node_modules/zod/src/v4/classic/tests/map.test.ts +12 -0
  657. package/node_modules/zod/src/v4/classic/tests/number.test.ts +85 -9
  658. package/node_modules/zod/src/v4/classic/tests/object.test.ts +301 -12
  659. package/node_modules/zod/src/v4/classic/tests/optin-ladder.test.ts +235 -0
  660. package/node_modules/zod/src/v4/classic/tests/optional.test.ts +49 -16
  661. package/node_modules/zod/src/v4/classic/tests/partial.test.ts +51 -4
  662. package/node_modules/zod/src/v4/classic/tests/prefault.test.ts +70 -0
  663. package/node_modules/zod/src/v4/classic/tests/preprocess-types.test.ts +20 -2
  664. package/node_modules/zod/src/v4/classic/tests/properties.test.ts +141 -0
  665. package/node_modules/zod/src/v4/classic/tests/readonly.test.ts +0 -68
  666. package/node_modules/zod/src/v4/classic/tests/record.test.ts +186 -18
  667. package/node_modules/zod/src/v4/classic/tests/recursive-types.test.ts +79 -3
  668. package/node_modules/zod/src/v4/classic/tests/redos.test.ts +68 -0
  669. package/node_modules/zod/src/v4/classic/tests/refine.test.ts +60 -0
  670. package/node_modules/zod/src/v4/classic/tests/set.test.ts +9 -0
  671. package/node_modules/zod/src/v4/classic/tests/standard-schema.test.ts +19 -0
  672. package/node_modules/zod/src/v4/classic/tests/string.test.ts +222 -6
  673. package/node_modules/zod/src/v4/classic/tests/stringbool.test.ts +18 -0
  674. package/node_modules/zod/src/v4/classic/tests/template-literal.test.ts +44 -3
  675. package/node_modules/zod/src/v4/classic/tests/to-json-schema.test.ts +1812 -204
  676. package/node_modules/zod/src/v4/classic/tests/tuple.test.ts +45 -30
  677. package/node_modules/zod/src/v4/classic/tests/union.test.ts +39 -2
  678. package/node_modules/zod/src/v4/classic/tests/validate.test.ts +645 -0
  679. package/node_modules/zod/src/v4/classic/tests/validations.test.ts +2 -2
  680. package/node_modules/zod/src/v4/core/api.ts +87 -35
  681. package/node_modules/zod/src/v4/core/checks.ts +119 -146
  682. package/node_modules/zod/src/v4/core/compile.ts +2313 -0
  683. package/node_modules/zod/src/v4/core/core.ts +99 -22
  684. package/node_modules/zod/src/v4/core/doc.ts +17 -9
  685. package/node_modules/zod/src/v4/core/errors.ts +113 -25
  686. package/node_modules/zod/src/v4/core/index.ts +3 -0
  687. package/node_modules/zod/src/v4/core/json-schema-generator.ts +8 -3
  688. package/node_modules/zod/src/v4/core/json-schema-processors.ts +424 -156
  689. package/node_modules/zod/src/v4/core/json-schema.ts +2 -1
  690. package/node_modules/zod/src/v4/core/memoizer.ts +331 -0
  691. package/node_modules/zod/src/v4/core/parse.ts +164 -50
  692. package/node_modules/zod/src/v4/core/regexes.ts +42 -15
  693. package/node_modules/zod/src/v4/core/registries.ts +2 -2
  694. package/node_modules/zod/src/v4/core/schemas.ts +1000 -538
  695. package/node_modules/zod/src/v4/core/tests/cached.test.ts +54 -0
  696. package/node_modules/zod/src/v4/core/tests/compile-differential.test.ts +1004 -0
  697. package/node_modules/zod/src/v4/core/tests/compile-generative.test.ts +445 -0
  698. package/node_modules/zod/src/v4/core/tests/compile-global.test.ts +89 -0
  699. package/node_modules/zod/src/v4/core/tests/compile-off-by-default.test.ts +26 -0
  700. package/node_modules/zod/src/v4/core/tests/compile-stats.test.ts +34 -0
  701. package/node_modules/zod/src/v4/core/tests/compile.test.ts +2036 -0
  702. package/node_modules/zod/src/v4/core/tests/email-regex.test.ts +140 -0
  703. package/node_modules/zod/src/v4/core/tests/locales/el.test.ts +1 -2
  704. package/node_modules/zod/src/v4/core/tests/locales/es.test.ts +1 -2
  705. package/node_modules/zod/src/v4/core/tests/locales/fr.test.ts +3 -3
  706. package/node_modules/zod/src/v4/core/tests/locales/parity.test.ts +42 -0
  707. package/node_modules/zod/src/v4/core/tests/locales/tg.test.ts +85 -0
  708. package/node_modules/zod/src/v4/core/tests/locales/tk.test.ts +69 -0
  709. package/node_modules/zod/src/v4/core/tests/polyfill-collision.test.ts +46 -0
  710. package/node_modules/zod/src/v4/core/tests/treeshake.test.ts +51 -0
  711. package/node_modules/zod/src/v4/core/tests/url-no-canparse.test.ts +133 -0
  712. package/node_modules/zod/src/v4/core/to-json-schema.ts +283 -48
  713. package/node_modules/zod/src/v4/core/util.ts +454 -157
  714. package/node_modules/zod/src/v4/core/versions.ts +2 -2
  715. package/node_modules/zod/src/v4/core/visit.ts +193 -0
  716. package/node_modules/zod/src/v4/index.ts +3 -3
  717. package/node_modules/zod/src/v4/locales/ar.ts +5 -0
  718. package/node_modules/zod/src/v4/locales/az.ts +5 -0
  719. package/node_modules/zod/src/v4/locales/be.ts +12 -0
  720. package/node_modules/zod/src/v4/locales/bg.ts +5 -0
  721. package/node_modules/zod/src/v4/locales/bn.ts +123 -0
  722. package/node_modules/zod/src/v4/locales/ca.ts +5 -0
  723. package/node_modules/zod/src/v4/locales/ckb.ts +140 -0
  724. package/node_modules/zod/src/v4/locales/cs.ts +5 -0
  725. package/node_modules/zod/src/v4/locales/da.ts +7 -2
  726. package/node_modules/zod/src/v4/locales/de.ts +5 -0
  727. package/node_modules/zod/src/v4/locales/el.ts +3 -0
  728. package/node_modules/zod/src/v4/locales/en.ts +17 -4
  729. package/node_modules/zod/src/v4/locales/eo.ts +5 -0
  730. package/node_modules/zod/src/v4/locales/es.ts +4 -0
  731. package/node_modules/zod/src/v4/locales/fa.ts +5 -0
  732. package/node_modules/zod/src/v4/locales/fi.ts +5 -0
  733. package/node_modules/zod/src/v4/locales/fr-CA.ts +5 -0
  734. package/node_modules/zod/src/v4/locales/fr.ts +21 -14
  735. package/node_modules/zod/src/v4/locales/gu.ts +123 -0
  736. package/node_modules/zod/src/v4/locales/he.ts +8 -1
  737. package/node_modules/zod/src/v4/locales/hi.ts +126 -0
  738. package/node_modules/zod/src/v4/locales/hr.ts +4 -0
  739. package/node_modules/zod/src/v4/locales/hu.ts +5 -0
  740. package/node_modules/zod/src/v4/locales/hy.ts +11 -0
  741. package/node_modules/zod/src/v4/locales/id.ts +5 -0
  742. package/node_modules/zod/src/v4/locales/index.ts +11 -0
  743. package/node_modules/zod/src/v4/locales/is.ts +5 -0
  744. package/node_modules/zod/src/v4/locales/it.ts +5 -0
  745. package/node_modules/zod/src/v4/locales/ja.ts +5 -0
  746. package/node_modules/zod/src/v4/locales/ka.ts +5 -0
  747. package/node_modules/zod/src/v4/locales/km.ts +5 -0
  748. package/node_modules/zod/src/v4/locales/kn.ts +126 -0
  749. package/node_modules/zod/src/v4/locales/ko.ts +5 -0
  750. package/node_modules/zod/src/v4/locales/lt.ts +4 -0
  751. package/node_modules/zod/src/v4/locales/mk.ts +5 -0
  752. package/node_modules/zod/src/v4/locales/ms.ts +5 -0
  753. package/node_modules/zod/src/v4/locales/ne.ts +128 -0
  754. package/node_modules/zod/src/v4/locales/nl.ts +5 -0
  755. package/node_modules/zod/src/v4/locales/nn.ts +121 -0
  756. package/node_modules/zod/src/v4/locales/no.ts +7 -2
  757. package/node_modules/zod/src/v4/locales/ota.ts +5 -0
  758. package/node_modules/zod/src/v4/locales/pl.ts +5 -0
  759. package/node_modules/zod/src/v4/locales/ps.ts +5 -0
  760. package/node_modules/zod/src/v4/locales/pt-BR.ts +161 -0
  761. package/node_modules/zod/src/v4/locales/pt.ts +101 -58
  762. package/node_modules/zod/src/v4/locales/ro.ts +3 -0
  763. package/node_modules/zod/src/v4/locales/ru.ts +12 -0
  764. package/node_modules/zod/src/v4/locales/sk.ts +123 -0
  765. package/node_modules/zod/src/v4/locales/sl.ts +5 -0
  766. package/node_modules/zod/src/v4/locales/sv.ts +7 -2
  767. package/node_modules/zod/src/v4/locales/ta.ts +5 -0
  768. package/node_modules/zod/src/v4/locales/tg.ts +135 -0
  769. package/node_modules/zod/src/v4/locales/th.ts +5 -0
  770. package/node_modules/zod/src/v4/locales/tk.ts +113 -0
  771. package/node_modules/zod/src/v4/locales/tr.ts +5 -0
  772. package/node_modules/zod/src/v4/locales/uk.ts +5 -0
  773. package/node_modules/zod/src/v4/locales/ur.ts +5 -0
  774. package/node_modules/zod/src/v4/locales/uz.ts +3 -0
  775. package/node_modules/zod/src/v4/locales/vi.ts +5 -0
  776. package/node_modules/zod/src/v4/locales/yo.ts +5 -0
  777. package/node_modules/zod/src/v4/locales/zh-CN.ts +5 -0
  778. package/node_modules/zod/src/v4/locales/zh-TW.ts +5 -0
  779. package/node_modules/zod/src/v4/mini/checks.ts +1 -0
  780. package/node_modules/zod/src/v4/mini/deep-partial.ts +73 -0
  781. package/node_modules/zod/src/v4/mini/external.ts +12 -1
  782. package/node_modules/zod/src/v4/mini/in-out.ts +45 -0
  783. package/node_modules/zod/src/v4/mini/parse.ts +2 -0
  784. package/node_modules/zod/src/v4/mini/schemas.ts +167 -63
  785. package/node_modules/zod/src/v4/mini/tests/apply.test.ts +33 -0
  786. package/node_modules/zod/src/v4/mini/tests/assignability.test.ts +62 -1
  787. package/node_modules/zod/src/v4/mini/tests/checks.test.ts +14 -0
  788. package/node_modules/zod/src/v4/mini/tests/codec.test.ts +35 -1
  789. package/node_modules/zod/src/v4/mini/tests/computed.test.ts +11 -17
  790. package/node_modules/zod/src/v4/mini/tests/cyclic-data.test.ts +84 -0
  791. package/node_modules/zod/src/v4/mini/tests/deep-partial.test.ts +54 -0
  792. package/node_modules/zod/src/v4/mini/tests/error.test.ts +23 -4
  793. package/node_modules/zod/src/v4/mini/tests/functions.test.ts +9 -0
  794. package/node_modules/zod/src/v4/mini/tests/index.test.ts +158 -5
  795. package/node_modules/zod/src/v4/mini/tests/number.test.ts +14 -0
  796. package/node_modules/zod/src/v4/mini/tests/object.test.ts +65 -0
  797. package/node_modules/zod/src/v4/mini/tests/recursive-types.test.ts +16 -0
  798. package/node_modules/zod/src/v4/mini/tests/string.test.ts +44 -0
  799. package/node_modules/zod/v3/ZodError.cjs +41 -12
  800. package/node_modules/zod/v3/ZodError.d.cts +1 -1
  801. package/node_modules/zod/v3/ZodError.d.ts +1 -1
  802. package/node_modules/zod/v3/ZodError.js +22 -12
  803. package/node_modules/zod/v3/errors.cjs +19 -0
  804. package/node_modules/zod/v3/external.cjs +19 -0
  805. package/node_modules/zod/v3/helpers/enumUtil.cjs +19 -0
  806. package/node_modules/zod/v3/helpers/errorUtil.cjs +20 -1
  807. package/node_modules/zod/v3/helpers/errorUtil.js +1 -1
  808. package/node_modules/zod/v3/helpers/parseUtil.cjs +19 -0
  809. package/node_modules/zod/v3/helpers/partialUtil.cjs +19 -0
  810. package/node_modules/zod/v3/helpers/typeAliases.cjs +19 -0
  811. package/node_modules/zod/v3/helpers/util.cjs +19 -0
  812. package/node_modules/zod/v3/index.cjs +19 -0
  813. package/node_modules/zod/v3/standard-schema.cjs +19 -0
  814. package/node_modules/zod/v3/types.cjs +26 -5
  815. package/node_modules/zod/v3/types.js +7 -5
  816. package/node_modules/zod/v4/classic/checks.cjs +21 -1
  817. package/node_modules/zod/v4/classic/checks.d.cts +1 -1
  818. package/node_modules/zod/v4/classic/checks.d.ts +1 -1
  819. package/node_modules/zod/v4/classic/checks.js +1 -1
  820. package/node_modules/zod/v4/classic/coerce.cjs +19 -0
  821. package/node_modules/zod/v4/classic/compat.cjs +19 -0
  822. package/node_modules/zod/v4/classic/compat.d.cts +9 -11
  823. package/node_modules/zod/v4/classic/compat.d.ts +9 -11
  824. package/node_modules/zod/v4/classic/deep-partial.cjs +58 -0
  825. package/node_modules/zod/v4/classic/deep-partial.d.cts +14 -0
  826. package/node_modules/zod/v4/classic/deep-partial.d.ts +14 -0
  827. package/node_modules/zod/v4/classic/deep-partial.js +13 -0
  828. package/node_modules/zod/v4/classic/errors.cjs +62 -34
  829. package/node_modules/zod/v4/classic/errors.d.cts +3 -4
  830. package/node_modules/zod/v4/classic/errors.d.ts +3 -4
  831. package/node_modules/zod/v4/classic/errors.js +43 -34
  832. package/node_modules/zod/v4/classic/external.cjs +51 -27
  833. package/node_modules/zod/v4/classic/external.d.cts +5 -2
  834. package/node_modules/zod/v4/classic/external.d.ts +5 -2
  835. package/node_modules/zod/v4/classic/external.js +5 -8
  836. package/node_modules/zod/v4/classic/from-json-schema.cjs +376 -75
  837. package/node_modules/zod/v4/classic/from-json-schema.js +357 -75
  838. package/node_modules/zod/v4/classic/in-out.cjs +82 -0
  839. package/node_modules/zod/v4/classic/in-out.d.cts +8 -0
  840. package/node_modules/zod/v4/classic/in-out.d.ts +8 -0
  841. package/node_modules/zod/v4/classic/in-out.js +36 -0
  842. package/node_modules/zod/v4/classic/index.cjs +21 -2
  843. package/node_modules/zod/v4/classic/index.d.cts +1 -2
  844. package/node_modules/zod/v4/classic/index.d.ts +1 -2
  845. package/node_modules/zod/v4/classic/index.js +2 -2
  846. package/node_modules/zod/v4/classic/iso.cjs +30 -22
  847. package/node_modules/zod/v4/classic/iso.d.cts +2 -17
  848. package/node_modules/zod/v4/classic/iso.d.ts +2 -17
  849. package/node_modules/zod/v4/classic/iso.js +2 -17
  850. package/node_modules/zod/v4/classic/parse.cjs +23 -1
  851. package/node_modules/zod/v4/classic/parse.d.cts +17 -4
  852. package/node_modules/zod/v4/classic/parse.d.ts +17 -4
  853. package/node_modules/zod/v4/classic/parse.js +1 -0
  854. package/node_modules/zod/v4/classic/schemas.cjs +591 -426
  855. package/node_modules/zod/v4/classic/schemas.d.cts +68 -19
  856. package/node_modules/zod/v4/classic/schemas.d.ts +68 -19
  857. package/node_modules/zod/v4/classic/schemas.js +564 -424
  858. package/node_modules/zod/v4/core/api.cjs +66 -24
  859. package/node_modules/zod/v4/core/api.d.cts +22 -12
  860. package/node_modules/zod/v4/core/api.d.ts +22 -12
  861. package/node_modules/zod/v4/core/api.js +44 -24
  862. package/node_modules/zod/v4/core/checks.cjs +88 -128
  863. package/node_modules/zod/v4/core/checks.d.cts +29 -13
  864. package/node_modules/zod/v4/core/checks.d.ts +29 -13
  865. package/node_modules/zod/v4/core/checks.js +68 -127
  866. package/node_modules/zod/v4/core/compile.cjs +1908 -0
  867. package/node_modules/zod/v4/core/compile.d.cts +65 -0
  868. package/node_modules/zod/v4/core/compile.d.ts +65 -0
  869. package/node_modules/zod/v4/core/compile.js +1858 -0
  870. package/node_modules/zod/v4/core/core.cjs +101 -19
  871. package/node_modules/zod/v4/core/core.d.cts +16 -4
  872. package/node_modules/zod/v4/core/core.d.ts +16 -4
  873. package/node_modules/zod/v4/core/core.js +83 -20
  874. package/node_modules/zod/v4/core/doc.cjs +31 -9
  875. package/node_modules/zod/v4/core/doc.d.cts +3 -1
  876. package/node_modules/zod/v4/core/doc.d.ts +3 -1
  877. package/node_modules/zod/v4/core/doc.js +12 -9
  878. package/node_modules/zod/v4/core/errors.cjs +126 -25
  879. package/node_modules/zod/v4/core/errors.d.cts +4 -0
  880. package/node_modules/zod/v4/core/errors.d.ts +4 -0
  881. package/node_modules/zod/v4/core/errors.js +107 -25
  882. package/node_modules/zod/v4/core/index.cjs +24 -1
  883. package/node_modules/zod/v4/core/index.d.cts +3 -0
  884. package/node_modules/zod/v4/core/index.d.ts +3 -0
  885. package/node_modules/zod/v4/core/index.js +3 -0
  886. package/node_modules/zod/v4/core/json-schema-generator.cjs +24 -1
  887. package/node_modules/zod/v4/core/json-schema-generator.d.cts +2 -2
  888. package/node_modules/zod/v4/core/json-schema-generator.d.ts +2 -2
  889. package/node_modules/zod/v4/core/json-schema-generator.js +6 -2
  890. package/node_modules/zod/v4/core/json-schema-processors.cjs +441 -156
  891. package/node_modules/zod/v4/core/json-schema-processors.d.cts +16 -0
  892. package/node_modules/zod/v4/core/json-schema-processors.d.ts +16 -0
  893. package/node_modules/zod/v4/core/json-schema-processors.js +400 -158
  894. package/node_modules/zod/v4/core/json-schema.cjs +19 -0
  895. package/node_modules/zod/v4/core/json-schema.d.cts +2 -1
  896. package/node_modules/zod/v4/core/json-schema.d.ts +2 -1
  897. package/node_modules/zod/v4/core/memoizer.cjs +360 -0
  898. package/node_modules/zod/v4/core/memoizer.d.cts +15 -0
  899. package/node_modules/zod/v4/core/memoizer.d.ts +15 -0
  900. package/node_modules/zod/v4/core/memoizer.js +311 -0
  901. package/node_modules/zod/v4/core/parse.cjs +148 -46
  902. package/node_modules/zod/v4/core/parse.d.cts +14 -11
  903. package/node_modules/zod/v4/core/parse.d.ts +14 -11
  904. package/node_modules/zod/v4/core/parse.js +127 -45
  905. package/node_modules/zod/v4/core/regexes.cjs +54 -17
  906. package/node_modules/zod/v4/core/regexes.d.cts +5 -0
  907. package/node_modules/zod/v4/core/regexes.d.ts +5 -0
  908. package/node_modules/zod/v4/core/regexes.js +32 -15
  909. package/node_modules/zod/v4/core/registries.cjs +19 -0
  910. package/node_modules/zod/v4/core/registries.js +2 -2
  911. package/node_modules/zod/v4/core/schemas.cjs +785 -386
  912. package/node_modules/zod/v4/core/schemas.d.cts +123 -34
  913. package/node_modules/zod/v4/core/schemas.d.ts +123 -34
  914. package/node_modules/zod/v4/core/schemas.js +753 -386
  915. package/node_modules/zod/v4/core/standard-schema.cjs +19 -0
  916. package/node_modules/zod/v4/core/to-json-schema.cjs +269 -45
  917. package/node_modules/zod/v4/core/to-json-schema.d.cts +45 -5
  918. package/node_modules/zod/v4/core/to-json-schema.d.ts +45 -5
  919. package/node_modules/zod/v4/core/to-json-schema.js +247 -44
  920. package/node_modules/zod/v4/core/util.cjs +372 -157
  921. package/node_modules/zod/v4/core/util.d.cts +79 -1
  922. package/node_modules/zod/v4/core/util.d.ts +79 -1
  923. package/node_modules/zod/v4/core/util.js +341 -156
  924. package/node_modules/zod/v4/core/versions.cjs +21 -2
  925. package/node_modules/zod/v4/core/versions.d.cts +1 -1
  926. package/node_modules/zod/v4/core/versions.d.ts +1 -1
  927. package/node_modules/zod/v4/core/versions.js +2 -2
  928. package/node_modules/zod/v4/core/visit.cjs +214 -0
  929. package/node_modules/zod/v4/core/visit.d.cts +30 -0
  930. package/node_modules/zod/v4/core/visit.d.ts +30 -0
  931. package/node_modules/zod/v4/core/visit.js +169 -0
  932. package/node_modules/zod/v4/index.cjs +34 -5
  933. package/node_modules/zod/v4/index.d.cts +2 -2
  934. package/node_modules/zod/v4/index.d.ts +2 -2
  935. package/node_modules/zod/v4/index.js +3 -2
  936. package/node_modules/zod/v4/locales/ar.cjs +5 -0
  937. package/node_modules/zod/v4/locales/ar.js +5 -0
  938. package/node_modules/zod/v4/locales/az.cjs +5 -0
  939. package/node_modules/zod/v4/locales/az.js +5 -0
  940. package/node_modules/zod/v4/locales/be.cjs +12 -0
  941. package/node_modules/zod/v4/locales/be.js +12 -0
  942. package/node_modules/zod/v4/locales/bg.cjs +5 -0
  943. package/node_modules/zod/v4/locales/bg.js +5 -0
  944. package/node_modules/zod/v4/locales/bn.cjs +140 -0
  945. package/node_modules/zod/v4/locales/bn.d.cts +5 -0
  946. package/node_modules/zod/v4/locales/bn.d.ts +4 -0
  947. package/node_modules/zod/v4/locales/bn.js +113 -0
  948. package/node_modules/zod/v4/locales/ca.cjs +5 -0
  949. package/node_modules/zod/v4/locales/ca.js +5 -0
  950. package/node_modules/zod/v4/locales/ckb.cjs +160 -0
  951. package/node_modules/zod/v4/locales/ckb.d.cts +5 -0
  952. package/node_modules/zod/v4/locales/ckb.d.ts +4 -0
  953. package/node_modules/zod/v4/locales/ckb.js +133 -0
  954. package/node_modules/zod/v4/locales/cs.cjs +5 -0
  955. package/node_modules/zod/v4/locales/cs.js +5 -0
  956. package/node_modules/zod/v4/locales/da.cjs +7 -2
  957. package/node_modules/zod/v4/locales/da.js +7 -2
  958. package/node_modules/zod/v4/locales/de.cjs +5 -0
  959. package/node_modules/zod/v4/locales/de.js +5 -0
  960. package/node_modules/zod/v4/locales/el.cjs +3 -0
  961. package/node_modules/zod/v4/locales/el.js +3 -0
  962. package/node_modules/zod/v4/locales/en.cjs +16 -4
  963. package/node_modules/zod/v4/locales/en.js +16 -4
  964. package/node_modules/zod/v4/locales/eo.cjs +5 -0
  965. package/node_modules/zod/v4/locales/eo.js +5 -0
  966. package/node_modules/zod/v4/locales/es.cjs +4 -0
  967. package/node_modules/zod/v4/locales/es.js +4 -0
  968. package/node_modules/zod/v4/locales/fa.cjs +5 -0
  969. package/node_modules/zod/v4/locales/fa.js +5 -0
  970. package/node_modules/zod/v4/locales/fi.cjs +5 -0
  971. package/node_modules/zod/v4/locales/fi.js +5 -0
  972. package/node_modules/zod/v4/locales/fr-CA.cjs +5 -0
  973. package/node_modules/zod/v4/locales/fr-CA.js +5 -0
  974. package/node_modules/zod/v4/locales/fr.cjs +18 -14
  975. package/node_modules/zod/v4/locales/fr.js +18 -14
  976. package/node_modules/zod/v4/locales/gu.cjs +140 -0
  977. package/node_modules/zod/v4/locales/gu.d.cts +5 -0
  978. package/node_modules/zod/v4/locales/gu.d.ts +4 -0
  979. package/node_modules/zod/v4/locales/gu.js +113 -0
  980. package/node_modules/zod/v4/locales/he.cjs +7 -0
  981. package/node_modules/zod/v4/locales/he.js +7 -0
  982. package/node_modules/zod/v4/locales/hi.cjs +138 -0
  983. package/node_modules/zod/v4/locales/hi.d.cts +5 -0
  984. package/node_modules/zod/v4/locales/hi.d.ts +4 -0
  985. package/node_modules/zod/v4/locales/hi.js +111 -0
  986. package/node_modules/zod/v4/locales/hr.cjs +4 -0
  987. package/node_modules/zod/v4/locales/hr.js +4 -0
  988. package/node_modules/zod/v4/locales/hu.cjs +5 -0
  989. package/node_modules/zod/v4/locales/hu.js +5 -0
  990. package/node_modules/zod/v4/locales/hy.cjs +11 -0
  991. package/node_modules/zod/v4/locales/hy.js +11 -0
  992. package/node_modules/zod/v4/locales/id.cjs +5 -0
  993. package/node_modules/zod/v4/locales/id.js +5 -0
  994. package/node_modules/zod/v4/locales/index.cjs +43 -2
  995. package/node_modules/zod/v4/locales/index.d.cts +11 -0
  996. package/node_modules/zod/v4/locales/index.d.ts +11 -0
  997. package/node_modules/zod/v4/locales/index.js +11 -0
  998. package/node_modules/zod/v4/locales/is.cjs +5 -0
  999. package/node_modules/zod/v4/locales/is.js +5 -0
  1000. package/node_modules/zod/v4/locales/it.cjs +5 -0
  1001. package/node_modules/zod/v4/locales/it.js +5 -0
  1002. package/node_modules/zod/v4/locales/ja.cjs +5 -0
  1003. package/node_modules/zod/v4/locales/ja.js +5 -0
  1004. package/node_modules/zod/v4/locales/ka.cjs +5 -0
  1005. package/node_modules/zod/v4/locales/ka.js +5 -0
  1006. package/node_modules/zod/v4/locales/km.cjs +5 -0
  1007. package/node_modules/zod/v4/locales/km.js +5 -0
  1008. package/node_modules/zod/v4/locales/kn.cjs +143 -0
  1009. package/node_modules/zod/v4/locales/kn.d.cts +5 -0
  1010. package/node_modules/zod/v4/locales/kn.d.ts +4 -0
  1011. package/node_modules/zod/v4/locales/kn.js +116 -0
  1012. package/node_modules/zod/v4/locales/ko.cjs +5 -0
  1013. package/node_modules/zod/v4/locales/ko.js +5 -0
  1014. package/node_modules/zod/v4/locales/lt.cjs +4 -0
  1015. package/node_modules/zod/v4/locales/lt.js +4 -0
  1016. package/node_modules/zod/v4/locales/mk.cjs +5 -0
  1017. package/node_modules/zod/v4/locales/mk.js +5 -0
  1018. package/node_modules/zod/v4/locales/ms.cjs +5 -0
  1019. package/node_modules/zod/v4/locales/ms.js +5 -0
  1020. package/node_modules/zod/v4/locales/ne.cjs +138 -0
  1021. package/node_modules/zod/v4/locales/ne.d.cts +5 -0
  1022. package/node_modules/zod/v4/locales/ne.d.ts +4 -0
  1023. package/node_modules/zod/v4/locales/ne.js +111 -0
  1024. package/node_modules/zod/v4/locales/nl.cjs +5 -0
  1025. package/node_modules/zod/v4/locales/nl.js +5 -0
  1026. package/node_modules/zod/v4/locales/nn.cjs +140 -0
  1027. package/node_modules/zod/v4/locales/nn.d.cts +5 -0
  1028. package/node_modules/zod/v4/locales/nn.d.ts +4 -0
  1029. package/node_modules/zod/v4/locales/nn.js +113 -0
  1030. package/node_modules/zod/v4/locales/no.cjs +7 -2
  1031. package/node_modules/zod/v4/locales/no.js +7 -2
  1032. package/node_modules/zod/v4/locales/ota.cjs +5 -0
  1033. package/node_modules/zod/v4/locales/ota.js +5 -0
  1034. package/node_modules/zod/v4/locales/pl.cjs +5 -0
  1035. package/node_modules/zod/v4/locales/pl.js +5 -0
  1036. package/node_modules/zod/v4/locales/ps.cjs +5 -0
  1037. package/node_modules/zod/v4/locales/ps.js +5 -0
  1038. package/node_modules/zod/v4/locales/pt-BR.cjs +170 -0
  1039. package/node_modules/zod/v4/locales/pt-BR.d.cts +5 -0
  1040. package/node_modules/zod/v4/locales/pt-BR.d.ts +4 -0
  1041. package/node_modules/zod/v4/locales/pt-BR.js +143 -0
  1042. package/node_modules/zod/v4/locales/pt.cjs +89 -55
  1043. package/node_modules/zod/v4/locales/pt.js +89 -55
  1044. package/node_modules/zod/v4/locales/ro.cjs +3 -0
  1045. package/node_modules/zod/v4/locales/ro.js +3 -0
  1046. package/node_modules/zod/v4/locales/ru.cjs +12 -0
  1047. package/node_modules/zod/v4/locales/ru.js +12 -0
  1048. package/node_modules/zod/v4/locales/sk.cjs +143 -0
  1049. package/node_modules/zod/v4/locales/sk.d.cts +5 -0
  1050. package/node_modules/zod/v4/locales/sk.d.ts +4 -0
  1051. package/node_modules/zod/v4/locales/sk.js +116 -0
  1052. package/node_modules/zod/v4/locales/sl.cjs +5 -0
  1053. package/node_modules/zod/v4/locales/sl.js +5 -0
  1054. package/node_modules/zod/v4/locales/sv.cjs +7 -2
  1055. package/node_modules/zod/v4/locales/sv.js +7 -2
  1056. package/node_modules/zod/v4/locales/ta.cjs +5 -0
  1057. package/node_modules/zod/v4/locales/ta.js +5 -0
  1058. package/node_modules/zod/v4/locales/tg.cjs +144 -0
  1059. package/node_modules/zod/v4/locales/tg.d.cts +5 -0
  1060. package/node_modules/zod/v4/locales/tg.d.ts +4 -0
  1061. package/node_modules/zod/v4/locales/tg.js +117 -0
  1062. package/node_modules/zod/v4/locales/th.cjs +5 -0
  1063. package/node_modules/zod/v4/locales/th.js +5 -0
  1064. package/node_modules/zod/v4/locales/tk.cjs +134 -0
  1065. package/node_modules/zod/v4/locales/tk.d.cts +5 -0
  1066. package/node_modules/zod/v4/locales/tk.d.ts +4 -0
  1067. package/node_modules/zod/v4/locales/tk.js +107 -0
  1068. package/node_modules/zod/v4/locales/tr.cjs +5 -0
  1069. package/node_modules/zod/v4/locales/tr.js +5 -0
  1070. package/node_modules/zod/v4/locales/uk.cjs +5 -0
  1071. package/node_modules/zod/v4/locales/uk.js +5 -0
  1072. package/node_modules/zod/v4/locales/ur.cjs +5 -0
  1073. package/node_modules/zod/v4/locales/ur.js +5 -0
  1074. package/node_modules/zod/v4/locales/uz.cjs +3 -0
  1075. package/node_modules/zod/v4/locales/uz.js +3 -0
  1076. package/node_modules/zod/v4/locales/vi.cjs +5 -0
  1077. package/node_modules/zod/v4/locales/vi.js +5 -0
  1078. package/node_modules/zod/v4/locales/yo.cjs +5 -0
  1079. package/node_modules/zod/v4/locales/yo.js +5 -0
  1080. package/node_modules/zod/v4/locales/zh-CN.cjs +5 -0
  1081. package/node_modules/zod/v4/locales/zh-CN.js +5 -0
  1082. package/node_modules/zod/v4/locales/zh-TW.cjs +5 -0
  1083. package/node_modules/zod/v4/locales/zh-TW.js +5 -0
  1084. package/node_modules/zod/v4/mini/checks.cjs +21 -1
  1085. package/node_modules/zod/v4/mini/checks.d.cts +1 -1
  1086. package/node_modules/zod/v4/mini/checks.d.ts +1 -1
  1087. package/node_modules/zod/v4/mini/checks.js +1 -1
  1088. package/node_modules/zod/v4/mini/coerce.cjs +19 -0
  1089. package/node_modules/zod/v4/mini/deep-partial.cjs +58 -0
  1090. package/node_modules/zod/v4/mini/deep-partial.d.cts +14 -0
  1091. package/node_modules/zod/v4/mini/deep-partial.d.ts +14 -0
  1092. package/node_modules/zod/v4/mini/deep-partial.js +13 -0
  1093. package/node_modules/zod/v4/mini/external.cjs +33 -1
  1094. package/node_modules/zod/v4/mini/external.d.cts +5 -2
  1095. package/node_modules/zod/v4/mini/external.d.ts +5 -2
  1096. package/node_modules/zod/v4/mini/external.js +3 -1
  1097. package/node_modules/zod/v4/mini/in-out.cjs +82 -0
  1098. package/node_modules/zod/v4/mini/in-out.d.cts +8 -0
  1099. package/node_modules/zod/v4/mini/in-out.d.ts +8 -0
  1100. package/node_modules/zod/v4/mini/in-out.js +36 -0
  1101. package/node_modules/zod/v4/mini/index.cjs +19 -0
  1102. package/node_modules/zod/v4/mini/iso.cjs +19 -0
  1103. package/node_modules/zod/v4/mini/parse.cjs +22 -1
  1104. package/node_modules/zod/v4/mini/parse.d.cts +1 -1
  1105. package/node_modules/zod/v4/mini/parse.d.ts +1 -1
  1106. package/node_modules/zod/v4/mini/parse.js +1 -1
  1107. package/node_modules/zod/v4/mini/schemas.cjs +117 -53
  1108. package/node_modules/zod/v4/mini/schemas.d.cts +49 -14
  1109. package/node_modules/zod/v4/mini/schemas.d.ts +49 -14
  1110. package/node_modules/zod/v4/mini/schemas.js +92 -51
  1111. package/node_modules/zod/v4-mini/index.cjs +19 -0
  1112. package/openclaw.plugin.json +21 -1
  1113. package/package.json +10 -8
  1114. package/node_modules/@openclaw/fs-safe/dist/absolute-path.d.ts.map +0 -1
  1115. package/node_modules/@openclaw/fs-safe/dist/advanced.d.ts.map +0 -1
  1116. package/node_modules/@openclaw/fs-safe/dist/archive-crc32.d.ts.map +0 -1
  1117. package/node_modules/@openclaw/fs-safe/dist/archive-deadline.d.ts.map +0 -1
  1118. package/node_modules/@openclaw/fs-safe/dist/archive-entry.d.ts.map +0 -1
  1119. package/node_modules/@openclaw/fs-safe/dist/archive-errors.d.ts.map +0 -1
  1120. package/node_modules/@openclaw/fs-safe/dist/archive-gzip-tail.d.ts.map +0 -1
  1121. package/node_modules/@openclaw/fs-safe/dist/archive-input.d.ts.map +0 -1
  1122. package/node_modules/@openclaw/fs-safe/dist/archive-kind.d.ts.map +0 -1
  1123. package/node_modules/@openclaw/fs-safe/dist/archive-limits.d.ts.map +0 -1
  1124. package/node_modules/@openclaw/fs-safe/dist/archive-merge.d.ts.map +0 -1
  1125. package/node_modules/@openclaw/fs-safe/dist/archive-native.d.ts +0 -20
  1126. package/node_modules/@openclaw/fs-safe/dist/archive-native.d.ts.map +0 -1
  1127. package/node_modules/@openclaw/fs-safe/dist/archive-native.js +0 -107
  1128. package/node_modules/@openclaw/fs-safe/dist/archive-options.d.ts +0 -21
  1129. package/node_modules/@openclaw/fs-safe/dist/archive-options.d.ts.map +0 -1
  1130. package/node_modules/@openclaw/fs-safe/dist/archive-parser-errors.d.ts.map +0 -1
  1131. package/node_modules/@openclaw/fs-safe/dist/archive-plan.d.ts.map +0 -1
  1132. package/node_modules/@openclaw/fs-safe/dist/archive-policy.d.ts +0 -22
  1133. package/node_modules/@openclaw/fs-safe/dist/archive-policy.d.ts.map +0 -1
  1134. package/node_modules/@openclaw/fs-safe/dist/archive-policy.js +0 -38
  1135. package/node_modules/@openclaw/fs-safe/dist/archive-read.d.ts.map +0 -1
  1136. package/node_modules/@openclaw/fs-safe/dist/archive-staging.d.ts.map +0 -1
  1137. package/node_modules/@openclaw/fs-safe/dist/archive-tar-inspect.d.ts +0 -7
  1138. package/node_modules/@openclaw/fs-safe/dist/archive-tar-inspect.d.ts.map +0 -1
  1139. package/node_modules/@openclaw/fs-safe/dist/archive-tar-inspect.js +0 -59
  1140. package/node_modules/@openclaw/fs-safe/dist/archive-tar-stream.d.ts.map +0 -1
  1141. package/node_modules/@openclaw/fs-safe/dist/archive-tar-wasm.d.ts.map +0 -1
  1142. package/node_modules/@openclaw/fs-safe/dist/archive-tar.d.ts +0 -19
  1143. package/node_modules/@openclaw/fs-safe/dist/archive-tar.d.ts.map +0 -1
  1144. package/node_modules/@openclaw/fs-safe/dist/archive-tar.js +0 -21
  1145. package/node_modules/@openclaw/fs-safe/dist/archive-zip-admission.d.ts.map +0 -1
  1146. package/node_modules/@openclaw/fs-safe/dist/archive-zip-count.d.ts.map +0 -1
  1147. package/node_modules/@openclaw/fs-safe/dist/archive-zip-directory.d.ts.map +0 -1
  1148. package/node_modules/@openclaw/fs-safe/dist/archive-zip-entry.d.ts.map +0 -1
  1149. package/node_modules/@openclaw/fs-safe/dist/archive-zip-integrity.d.ts.map +0 -1
  1150. package/node_modules/@openclaw/fs-safe/dist/archive-zip-names.d.ts.map +0 -1
  1151. package/node_modules/@openclaw/fs-safe/dist/archive-zip-preflight.d.ts.map +0 -1
  1152. package/node_modules/@openclaw/fs-safe/dist/archive.d.ts.map +0 -1
  1153. package/node_modules/@openclaw/fs-safe/dist/async-lock.d.ts.map +0 -1
  1154. package/node_modules/@openclaw/fs-safe/dist/atomic.d.ts.map +0 -1
  1155. package/node_modules/@openclaw/fs-safe/dist/bounded-read-stream.d.ts.map +0 -1
  1156. package/node_modules/@openclaw/fs-safe/dist/bounded-read.d.ts.map +0 -1
  1157. package/node_modules/@openclaw/fs-safe/dist/byte-budget.d.ts.map +0 -1
  1158. package/node_modules/@openclaw/fs-safe/dist/config.d.ts.map +0 -1
  1159. package/node_modules/@openclaw/fs-safe/dist/containment.d.ts.map +0 -1
  1160. package/node_modules/@openclaw/fs-safe/dist/deny-mutations.d.ts.map +0 -1
  1161. package/node_modules/@openclaw/fs-safe/dist/device-path.d.ts.map +0 -1
  1162. package/node_modules/@openclaw/fs-safe/dist/directory-durability.d.ts.map +0 -1
  1163. package/node_modules/@openclaw/fs-safe/dist/directory-guard.d.ts.map +0 -1
  1164. package/node_modules/@openclaw/fs-safe/dist/directory-mode-node.d.ts.map +0 -1
  1165. package/node_modules/@openclaw/fs-safe/dist/directory-mode-owner.d.ts.map +0 -1
  1166. package/node_modules/@openclaw/fs-safe/dist/durability.d.ts.map +0 -1
  1167. package/node_modules/@openclaw/fs-safe/dist/error-detail.d.ts.map +0 -1
  1168. package/node_modules/@openclaw/fs-safe/dist/errors.d.ts.map +0 -1
  1169. package/node_modules/@openclaw/fs-safe/dist/file-hash.d.ts.map +0 -1
  1170. package/node_modules/@openclaw/fs-safe/dist/file-identity.d.ts.map +0 -1
  1171. package/node_modules/@openclaw/fs-safe/dist/file-lock-sync.d.ts.map +0 -1
  1172. package/node_modules/@openclaw/fs-safe/dist/file-lock.d.ts.map +0 -1
  1173. package/node_modules/@openclaw/fs-safe/dist/file-observation.d.ts.map +0 -1
  1174. package/node_modules/@openclaw/fs-safe/dist/file-store-boundary.d.ts.map +0 -1
  1175. package/node_modules/@openclaw/fs-safe/dist/file-store-limit.d.ts +0 -2
  1176. package/node_modules/@openclaw/fs-safe/dist/file-store-limit.d.ts.map +0 -1
  1177. package/node_modules/@openclaw/fs-safe/dist/file-store-limit.js +0 -8
  1178. package/node_modules/@openclaw/fs-safe/dist/file-store-prune.d.ts.map +0 -1
  1179. package/node_modules/@openclaw/fs-safe/dist/file-store-sync-write.d.ts.map +0 -1
  1180. package/node_modules/@openclaw/fs-safe/dist/file-store.d.ts.map +0 -1
  1181. package/node_modules/@openclaw/fs-safe/dist/file-sync.d.ts.map +0 -1
  1182. package/node_modules/@openclaw/fs-safe/dist/filename.d.ts.map +0 -1
  1183. package/node_modules/@openclaw/fs-safe/dist/fs.d.ts.map +0 -1
  1184. package/node_modules/@openclaw/fs-safe/dist/guarded-mkdir.d.ts.map +0 -1
  1185. package/node_modules/@openclaw/fs-safe/dist/guarded-mutation.d.ts.map +0 -1
  1186. package/node_modules/@openclaw/fs-safe/dist/home-dir.d.ts.map +0 -1
  1187. package/node_modules/@openclaw/fs-safe/dist/index.d.ts.map +0 -1
  1188. package/node_modules/@openclaw/fs-safe/dist/install-path.d.ts.map +0 -1
  1189. package/node_modules/@openclaw/fs-safe/dist/json-document-store.d.ts.map +0 -1
  1190. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-directory.d.ts.map +0 -1
  1191. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue-ownership.d.ts.map +0 -1
  1192. package/node_modules/@openclaw/fs-safe/dist/json-durable-queue.d.ts.map +0 -1
  1193. package/node_modules/@openclaw/fs-safe/dist/json-store.d.ts.map +0 -1
  1194. package/node_modules/@openclaw/fs-safe/dist/json-stringify.d.ts.map +0 -1
  1195. package/node_modules/@openclaw/fs-safe/dist/json.d.ts.map +0 -1
  1196. package/node_modules/@openclaw/fs-safe/dist/local-file-access.d.ts.map +0 -1
  1197. package/node_modules/@openclaw/fs-safe/dist/local-roots.d.ts.map +0 -1
  1198. package/node_modules/@openclaw/fs-safe/dist/lock-config.d.ts.map +0 -1
  1199. package/node_modules/@openclaw/fs-safe/dist/move-path-cleanup.d.ts.map +0 -1
  1200. package/node_modules/@openclaw/fs-safe/dist/move-path.d.ts.map +0 -1
  1201. package/node_modules/@openclaw/fs-safe/dist/native-binding.d.ts.map +0 -1
  1202. package/node_modules/@openclaw/fs-safe/dist/native-config.d.ts.map +0 -1
  1203. package/node_modules/@openclaw/fs-safe/dist/native-operations.d.ts.map +0 -1
  1204. package/node_modules/@openclaw/fs-safe/dist/native-pinned-write-windows.d.ts.map +0 -1
  1205. package/node_modules/@openclaw/fs-safe/dist/native-pinned-write.d.ts.map +0 -1
  1206. package/node_modules/@openclaw/fs-safe/dist/native-staged-file.d.ts.map +0 -1
  1207. package/node_modules/@openclaw/fs-safe/dist/native.d.ts.map +0 -1
  1208. package/node_modules/@openclaw/fs-safe/dist/opened-file-failure.d.ts.map +0 -1
  1209. package/node_modules/@openclaw/fs-safe/dist/opened-realpath.d.ts.map +0 -1
  1210. package/node_modules/@openclaw/fs-safe/dist/output.d.ts.map +0 -1
  1211. package/node_modules/@openclaw/fs-safe/dist/owner-dacl.d.ts.map +0 -1
  1212. package/node_modules/@openclaw/fs-safe/dist/path-policy.d.ts.map +0 -1
  1213. package/node_modules/@openclaw/fs-safe/dist/path.d.ts.map +0 -1
  1214. package/node_modules/@openclaw/fs-safe/dist/permission-exec.d.ts.map +0 -1
  1215. package/node_modules/@openclaw/fs-safe/dist/permissions-public.d.ts.map +0 -1
  1216. package/node_modules/@openclaw/fs-safe/dist/permissions-windows.d.ts.map +0 -1
  1217. package/node_modules/@openclaw/fs-safe/dist/permissions.d.ts.map +0 -1
  1218. package/node_modules/@openclaw/fs-safe/dist/pinned-open.d.ts.map +0 -1
  1219. package/node_modules/@openclaw/fs-safe/dist/pinned-operation.d.ts.map +0 -1
  1220. package/node_modules/@openclaw/fs-safe/dist/pinned-write.d.ts.map +0 -1
  1221. package/node_modules/@openclaw/fs-safe/dist/private-directory.d.ts.map +0 -1
  1222. package/node_modules/@openclaw/fs-safe/dist/private-temp-workspace.d.ts.map +0 -1
  1223. package/node_modules/@openclaw/fs-safe/dist/publish-file-failure.d.ts.map +0 -1
  1224. package/node_modules/@openclaw/fs-safe/dist/publish-file.d.ts.map +0 -1
  1225. package/node_modules/@openclaw/fs-safe/dist/read-open-flags.d.ts.map +0 -1
  1226. package/node_modules/@openclaw/fs-safe/dist/read-opened-file.d.ts.map +0 -1
  1227. package/node_modules/@openclaw/fs-safe/dist/regular-file.d.ts.map +0 -1
  1228. package/node_modules/@openclaw/fs-safe/dist/replace-directory.d.ts.map +0 -1
  1229. package/node_modules/@openclaw/fs-safe/dist/replace-file-copy-fallback.d.ts.map +0 -1
  1230. package/node_modules/@openclaw/fs-safe/dist/replace-file-copy-source.d.ts.map +0 -1
  1231. package/node_modules/@openclaw/fs-safe/dist/replace-file-descriptor.d.ts.map +0 -1
  1232. package/node_modules/@openclaw/fs-safe/dist/replace-file-rename-policy.d.ts.map +0 -1
  1233. package/node_modules/@openclaw/fs-safe/dist/replace-file-temp-owner.d.ts.map +0 -1
  1234. package/node_modules/@openclaw/fs-safe/dist/replace-file.d.ts.map +0 -1
  1235. package/node_modules/@openclaw/fs-safe/dist/root-context.d.ts.map +0 -1
  1236. package/node_modules/@openclaw/fs-safe/dist/root-errors.d.ts.map +0 -1
  1237. package/node_modules/@openclaw/fs-safe/dist/root-file.d.ts.map +0 -1
  1238. package/node_modules/@openclaw/fs-safe/dist/root-impl.d.ts.map +0 -1
  1239. package/node_modules/@openclaw/fs-safe/dist/root-path-existing.d.ts.map +0 -1
  1240. package/node_modules/@openclaw/fs-safe/dist/root-path-symlink.d.ts +0 -7
  1241. package/node_modules/@openclaw/fs-safe/dist/root-path-symlink.d.ts.map +0 -1
  1242. package/node_modules/@openclaw/fs-safe/dist/root-path-symlink.js +0 -35
  1243. package/node_modules/@openclaw/fs-safe/dist/root-path.d.ts.map +0 -1
  1244. package/node_modules/@openclaw/fs-safe/dist/root-paths.d.ts.map +0 -1
  1245. package/node_modules/@openclaw/fs-safe/dist/root-walk.d.ts.map +0 -1
  1246. package/node_modules/@openclaw/fs-safe/dist/root-write-mode.d.ts.map +0 -1
  1247. package/node_modules/@openclaw/fs-safe/dist/root-write-verification.d.ts.map +0 -1
  1248. package/node_modules/@openclaw/fs-safe/dist/root.d.ts.map +0 -1
  1249. package/node_modules/@openclaw/fs-safe/dist/safe-path-segment.d.ts.map +0 -1
  1250. package/node_modules/@openclaw/fs-safe/dist/secret-file.d.ts.map +0 -1
  1251. package/node_modules/@openclaw/fs-safe/dist/secret-read-async.d.ts.map +0 -1
  1252. package/node_modules/@openclaw/fs-safe/dist/secret-read-policy.d.ts.map +0 -1
  1253. package/node_modules/@openclaw/fs-safe/dist/secret.d.ts.map +0 -1
  1254. package/node_modules/@openclaw/fs-safe/dist/secure-file.d.ts.map +0 -1
  1255. package/node_modules/@openclaw/fs-safe/dist/secure-temp-dir.d.ts.map +0 -1
  1256. package/node_modules/@openclaw/fs-safe/dist/sibling-staged-file.d.ts.map +0 -1
  1257. package/node_modules/@openclaw/fs-safe/dist/sibling-temp.d.ts.map +0 -1
  1258. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-acquire.d.ts.map +0 -1
  1259. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-handle.d.ts.map +0 -1
  1260. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-policy.d.ts.map +0 -1
  1261. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-reclaim.d.ts.map +0 -1
  1262. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-root.d.ts.map +0 -1
  1263. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock-types.d.ts.map +0 -1
  1264. package/node_modules/@openclaw/fs-safe/dist/sidecar-lock.d.ts.map +0 -1
  1265. package/node_modules/@openclaw/fs-safe/dist/staged-directory.d.ts.map +0 -1
  1266. package/node_modules/@openclaw/fs-safe/dist/staged-file-types.d.ts.map +0 -1
  1267. package/node_modules/@openclaw/fs-safe/dist/store.d.ts.map +0 -1
  1268. package/node_modules/@openclaw/fs-safe/dist/strict-file-identity.d.ts.map +0 -1
  1269. package/node_modules/@openclaw/fs-safe/dist/string-coerce.d.ts.map +0 -1
  1270. package/node_modules/@openclaw/fs-safe/dist/suppressed-error.d.ts.map +0 -1
  1271. package/node_modules/@openclaw/fs-safe/dist/symlink-parents.d.ts.map +0 -1
  1272. package/node_modules/@openclaw/fs-safe/dist/temp-cleanup.d.ts.map +0 -1
  1273. package/node_modules/@openclaw/fs-safe/dist/temp-target.d.ts.map +0 -1
  1274. package/node_modules/@openclaw/fs-safe/dist/temp-workspace-owner.d.ts.map +0 -1
  1275. package/node_modules/@openclaw/fs-safe/dist/temp.d.ts.map +0 -1
  1276. package/node_modules/@openclaw/fs-safe/dist/test-hooks.d.ts.map +0 -1
  1277. package/node_modules/@openclaw/fs-safe/dist/text-atomic.d.ts.map +0 -1
  1278. package/node_modules/@openclaw/fs-safe/dist/timing.d.ts.map +0 -1
  1279. package/node_modules/@openclaw/fs-safe/dist/trash.d.ts.map +0 -1
  1280. package/node_modules/@openclaw/fs-safe/dist/types.d.ts.map +0 -1
  1281. package/node_modules/@openclaw/fs-safe/dist/walk.d.ts.map +0 -1
  1282. package/node_modules/@openclaw/fs-safe/dist/windows-command.d.ts.map +0 -1
  1283. package/node_modules/@openclaw/fs-safe/dist/windows-owner.d.ts.map +0 -1
  1284. package/node_modules/@openclaw/fs-safe/dist/write-open-flags.d.ts.map +0 -1
  1285. package/node_modules/@openclaw/fs-safe/dist/write-queue.d.ts.map +0 -1
  1286. package/node_modules/jszip/.github/workflows/pr.yaml +0 -58
  1287. package/node_modules/jszip/.jekyll-metadata +0 -0
  1288. package/node_modules/jszip/.travis.yml +0 -17
  1289. package/node_modules/jszip/deps.js +0 -37
  1290. package/node_modules/jszip/graph.svg +0 -601
  1291. package/node_modules/zod/src/v4/core/config.ts +0 -15
  1292. /package/node_modules/@openclaw/fs-safe/dist/{archive-options.js → pinned-write-types.js} +0 -0
@@ -0,0 +1,2036 @@
1
+ import { expect, expectTypeOf, test } from "vitest";
2
+
3
+ import * as z from "../../index.js";
4
+ import {
5
+ INVALID,
6
+ ZodCompileAsyncError,
7
+ ZodCompileUnsupportedError,
8
+ compile,
9
+ compileFn,
10
+ withParser,
11
+ } from "../compile.js";
12
+ import { $ZodAsyncError } from "../core.js";
13
+
14
+ // Differential helper: assert compiled schema matches the original on a value.
15
+ function expectMatch(schema: z.ZodType, value: unknown) {
16
+ const compiled = compile(schema);
17
+ const original = schema.safeParse(value);
18
+ const fast = compiled.safeParse(value);
19
+
20
+ expect(fast.success).toBe(original.success);
21
+ if (original.success && fast.success) {
22
+ expect(fast.data).toEqual(original.data);
23
+ } else if (!original.success && !fast.success) {
24
+ expect(fast.error.issues).toEqual(original.error.issues);
25
+ }
26
+ }
27
+
28
+ // Parse and assert success; return the parsed data for further assertions.
29
+ function valid<T extends z.ZodType>(schema: T, value: unknown): z.output<T> {
30
+ const result = schema.safeParse(value);
31
+ if (!result.success) {
32
+ throw new Error(`expected success, got issues: ${JSON.stringify(result.error.issues)}`);
33
+ }
34
+ return result.data;
35
+ }
36
+
37
+ // Parse and assert failure.
38
+ function invalid(schema: z.ZodType, value: unknown) {
39
+ const result = schema.safeParse(value);
40
+ expect(result.success).toBe(false);
41
+ }
42
+
43
+ // === Primitives ===
44
+
45
+ test("string", () => {
46
+ const aot = compile(z.string());
47
+ expect(valid(aot, "hello")).toBe("hello");
48
+ expect(valid(aot, "")).toBe("");
49
+ invalid(aot, 123);
50
+ invalid(aot, null);
51
+ invalid(aot, undefined);
52
+ });
53
+
54
+ test("number", () => {
55
+ const aot = compile(z.number());
56
+ expect(valid(aot, 123)).toBe(123);
57
+ expect(valid(aot, 0)).toBe(0);
58
+ expect(valid(aot, -5.5)).toBe(-5.5);
59
+ invalid(aot, Number.NaN); // z.number() rejects NaN
60
+ invalid(aot, Number.POSITIVE_INFINITY); // z.number() rejects Infinity
61
+ invalid(aot, Number.NEGATIVE_INFINITY);
62
+ invalid(aot, "123");
63
+ invalid(aot, null);
64
+ });
65
+
66
+ test("boolean", () => {
67
+ const aot = compile(z.boolean());
68
+ expect(valid(aot, true)).toBe(true);
69
+ expect(valid(aot, false)).toBe(false);
70
+ invalid(aot, 1);
71
+ invalid(aot, "true");
72
+ });
73
+
74
+ test("bigint", () => {
75
+ const aot = compile(z.bigint());
76
+ expect(valid(aot, 123n)).toBe(123n);
77
+ expect(valid(aot, 0n)).toBe(0n);
78
+ invalid(aot, 123);
79
+ invalid(aot, "123");
80
+ });
81
+
82
+ test("symbol", () => {
83
+ const aot = compile(z.symbol());
84
+ const sym = Symbol();
85
+ expect(valid(aot, sym)).toBe(sym);
86
+ const namedSym = Symbol.for("test");
87
+ expect(valid(aot, namedSym)).toBe(namedSym);
88
+ invalid(aot, "symbol");
89
+ });
90
+
91
+ test("undefined", () => {
92
+ const aot = compile(z.undefined());
93
+ expect(valid(aot, undefined)).toBe(undefined);
94
+ invalid(aot, null);
95
+ invalid(aot, 0);
96
+ });
97
+
98
+ test("null", () => {
99
+ const aot = compile(z.null());
100
+ expect(valid(aot, null)).toBe(null);
101
+ invalid(aot, undefined);
102
+ invalid(aot, 0);
103
+ });
104
+
105
+ test("void", () => {
106
+ const aot = compile(z.void());
107
+ expect(valid(aot, undefined)).toBe(undefined);
108
+ invalid(aot, null);
109
+ invalid(aot, 0);
110
+ });
111
+
112
+ test("nan", () => {
113
+ const aot = compile(z.nan());
114
+ expect(Number.isNaN(valid(aot, Number.NaN))).toBe(true);
115
+ expect(Number.isNaN(valid(aot, Number.NaN))).toBe(true);
116
+ invalid(aot, 0);
117
+ invalid(aot, Number.POSITIVE_INFINITY);
118
+ invalid(aot, "NaN");
119
+ });
120
+
121
+ test("date", () => {
122
+ const aot = compile(z.date());
123
+ const d1 = new Date();
124
+ expect(valid(aot, d1)).toBe(d1);
125
+ const d2 = new Date(0);
126
+ expect(valid(aot, d2)).toBe(d2);
127
+ invalid(aot, new Date("invalid")); // Invalid date
128
+ invalid(aot, "2024-01-01");
129
+ invalid(aot, Date.now());
130
+ });
131
+
132
+ // === Special Types ===
133
+
134
+ test("any", () => {
135
+ const aot = compile(z.any());
136
+ expect(valid(aot, null)).toBe(null);
137
+ expect(valid(aot, undefined)).toBe(undefined);
138
+ expect(valid(aot, 123)).toBe(123);
139
+ expect(valid(aot, { nested: { deep: true } })).toEqual({ nested: { deep: true } });
140
+ });
141
+
142
+ test("unknown", () => {
143
+ const aot = compile(z.unknown());
144
+ expect(valid(aot, null)).toBe(null);
145
+ expect(valid(aot, undefined)).toBe(undefined);
146
+ expect(valid(aot, 123)).toBe(123);
147
+ });
148
+
149
+ test("never", () => {
150
+ const aot = compile(z.never());
151
+ invalid(aot, null);
152
+ invalid(aot, undefined);
153
+ invalid(aot, 123);
154
+ });
155
+
156
+ // === Literal ===
157
+
158
+ test("literal string", () => {
159
+ const aot = compile(z.literal("hello"));
160
+ expect(valid(aot, "hello")).toBe("hello");
161
+ invalid(aot, "Hello");
162
+ invalid(aot, "");
163
+ });
164
+
165
+ test("literal number", () => {
166
+ const aot = compile(z.literal(42));
167
+ expect(valid(aot, 42)).toBe(42);
168
+ invalid(aot, 43);
169
+ invalid(aot, "42");
170
+ });
171
+
172
+ test("literal boolean", () => {
173
+ const aot = compile(z.literal(true));
174
+ expect(valid(aot, true)).toBe(true);
175
+ invalid(aot, false);
176
+ });
177
+
178
+ test("literal null", () => {
179
+ const aot = compile(z.literal(null));
180
+ expect(valid(aot, null)).toBe(null);
181
+ invalid(aot, undefined);
182
+ });
183
+
184
+ test("literal bigint", () => {
185
+ const aot = compile(z.literal(100n));
186
+ expect(valid(aot, 100n)).toBe(100n);
187
+ invalid(aot, 100);
188
+ invalid(aot, 101n);
189
+ });
190
+
191
+ // === Enum ===
192
+
193
+ test("enum", () => {
194
+ const aot = compile(z.enum(["a", "b", "c"]));
195
+ expect(valid(aot, "a")).toBe("a");
196
+ expect(valid(aot, "b")).toBe("b");
197
+ expect(valid(aot, "c")).toBe("c");
198
+ invalid(aot, "d");
199
+ invalid(aot, "A");
200
+ invalid(aot, 1);
201
+ });
202
+
203
+ // === Wrapper Types ===
204
+
205
+ test("readonly", () => {
206
+ const aot = compile(z.readonly(z.string()));
207
+ expect(valid(aot, "hello")).toBe("hello");
208
+ invalid(aot, 123);
209
+ });
210
+
211
+ test("default", () => {
212
+ const aot = compile(z.string().default("hello"));
213
+ expect(valid(aot, "world")).toBe("world");
214
+ expect(valid(aot, undefined)).toBe("hello"); // default applies
215
+ invalid(aot, 123);
216
+ });
217
+
218
+ test("prefault", () => {
219
+ const aot = compile(z.string().trim().prefault(" hello "));
220
+ expect(valid(aot, "world")).toBe("world");
221
+ expect(valid(aot, undefined)).toBe("hello");
222
+ invalid(aot, 123);
223
+ });
224
+
225
+ test("nonoptional", () => {
226
+ const aot = compile(z.string().optional().nonoptional());
227
+ expect(valid(aot, "hello")).toBe("hello");
228
+ invalid(aot, undefined); // nonoptional rejects undefined
229
+ invalid(aot, 123);
230
+ });
231
+
232
+ test("nonoptional judges the inner's output, not its input", () => {
233
+ // An inner catch turns a *defined* input into undefined, which must still be rejected; an inner default turns an absent input into a value, which must be accepted. Testing the input alone got both backwards.
234
+ const caught = z
235
+ .string()
236
+ .min(2)
237
+ .max(8)
238
+ .prefault("abc")
239
+ .catch(undefined as any)
240
+ .optional()
241
+ .nonoptional();
242
+ for (const input of ["abc", "abcdefghij", "a", undefined]) expectMatch(caught, input);
243
+
244
+ expectMatch(
245
+ z
246
+ .string()
247
+ .transform(() => undefined)
248
+ .nonoptional(),
249
+ "s"
250
+ );
251
+ for (const input of [undefined, "y", 1]) expectMatch(z.string().default("x").nonoptional(), input);
252
+ });
253
+
254
+ test("a nonoptional object key whose inner supplies a value still needs the key", () => {
255
+ // The runtime separates an absent key from an explicit undefined here: absent fails, explicit undefined takes the default. The fast path has to as well.
256
+ const prop = z
257
+ .literal("lit")
258
+ .default("other" as any)
259
+ .optional()
260
+ .nonoptional();
261
+ const schema = z.object({ k1: prop });
262
+ expectMatch(schema, {});
263
+ expectMatch(schema, { k1: undefined });
264
+ expectMatch(schema, { k1: "lit" });
265
+ expectMatch(prop, undefined);
266
+ });
267
+
268
+ test("success", () => {
269
+ const aot = compile(z.success(z.string()));
270
+ expect(valid(aot, "hello")).toBe(true);
271
+ invalid(aot, 123);
272
+ expectMatch(z.success(z.string()), "hello");
273
+ expectMatch(z.success(z.string()), 123);
274
+ expectMatch(z.object({ ok: z.success(z.number()) }), { ok: 5 });
275
+ });
276
+
277
+ // === Optional & Nullable ===
278
+
279
+ test("optional", () => {
280
+ const aot = compile(z.optional(z.string()));
281
+ expect(valid(aot, "hello")).toBe("hello");
282
+ expect(valid(aot, undefined)).toBe(undefined);
283
+ invalid(aot, null);
284
+ invalid(aot, 123);
285
+ });
286
+
287
+ test("nullable", () => {
288
+ const aot = compile(z.nullable(z.string()));
289
+ expect(valid(aot, "hello")).toBe("hello");
290
+ expect(valid(aot, null)).toBe(null);
291
+ invalid(aot, undefined);
292
+ invalid(aot, 123);
293
+ });
294
+
295
+ // === Array ===
296
+
297
+ test("array of strings", () => {
298
+ const aot = compile(z.array(z.string()));
299
+ expect(valid(aot, [])).toEqual([]);
300
+ expect(valid(aot, ["a", "b"])).toEqual(["a", "b"]);
301
+ invalid(aot, [1, 2]);
302
+ invalid(aot, ["a", 1]);
303
+ invalid(aot, "not array");
304
+ });
305
+
306
+ test("array of objects", () => {
307
+ const aot = compile(z.array(z.object({ id: z.number() })));
308
+ expect(valid(aot, [{ id: 1 }, { id: 2 }])).toEqual([{ id: 1 }, { id: 2 }]);
309
+ invalid(aot, [{ id: "1" }]);
310
+ invalid(aot, [{}]);
311
+ });
312
+
313
+ // === Object ===
314
+
315
+ test("simple object", () => {
316
+ const aot = compile(z.object({ name: z.string(), age: z.number() }));
317
+ expect(valid(aot, { name: "Alice", age: 30 })).toEqual({ name: "Alice", age: 30 });
318
+ expect(valid(aot, { name: "Bob", age: 25, extra: true })).toEqual({ name: "Bob", age: 25 }); // strip mode
319
+ invalid(aot, { name: "Charlie" });
320
+ invalid(aot, { name: 123, age: 30 });
321
+ invalid(aot, null);
322
+ invalid(aot, []);
323
+ });
324
+
325
+ test("nested object", () => {
326
+ const aot = compile(
327
+ z.object({
328
+ user: z.object({
329
+ name: z.string(),
330
+ address: z.object({
331
+ city: z.string(),
332
+ }),
333
+ }),
334
+ })
335
+ );
336
+ expect(valid(aot, { user: { name: "Alice", address: { city: "NYC" } } })).toEqual({
337
+ user: { name: "Alice", address: { city: "NYC" } },
338
+ });
339
+ invalid(aot, { user: { name: "Alice", address: {} } });
340
+ });
341
+
342
+ test("object with optional property", () => {
343
+ const aot = compile(z.object({ name: z.string(), age: z.optional(z.number()) }));
344
+ expect(valid(aot, { name: "Alice" })).toEqual({ name: "Alice" });
345
+ expect(valid(aot, { name: "Alice", age: 30 })).toEqual({ name: "Alice", age: 30 });
346
+ expect(valid(aot, { name: "Alice", age: undefined })).toEqual({ name: "Alice", age: undefined });
347
+ invalid(aot, { name: "Alice", age: "30" });
348
+ });
349
+
350
+ test("object required undefined-accepting properties distinguish absence", () => {
351
+ const cases = [
352
+ z.object({ value: z.undefined() }),
353
+ z.object({ value: z.union([z.string(), z.undefined()]) }),
354
+ z.object({ value: z.any() }),
355
+ z.object({ value: z.unknown() }),
356
+ ];
357
+
358
+ for (const schema of cases) {
359
+ const aot = compile(schema);
360
+ invalid(aot, {});
361
+ expect(valid(aot, { value: undefined })).toEqual({ value: undefined });
362
+ }
363
+ });
364
+
365
+ test("strictObject", () => {
366
+ const aot = compile(z.strictObject({ name: z.string() }));
367
+ expect(valid(aot, { name: "Alice" })).toEqual({ name: "Alice" });
368
+ invalid(aot, { name: "Alice", extra: true });
369
+ invalid(aot, {});
370
+ });
371
+
372
+ test("strictObject with optional", () => {
373
+ const aot = compile(z.strictObject({ name: z.string(), age: z.optional(z.number()) }));
374
+ expect(valid(aot, { name: "Alice" })).toEqual({ name: "Alice" });
375
+ expect(valid(aot, { name: "Alice", age: 30 })).toEqual({ name: "Alice", age: 30 });
376
+ invalid(aot, { name: "Alice", extra: true });
377
+ });
378
+
379
+ test("looseObject", () => {
380
+ const aot = compile(z.looseObject({ name: z.string() }));
381
+ expect(valid(aot, { name: "Alice" })).toEqual({ name: "Alice" });
382
+ expect(valid(aot, { name: "Alice", extra: true })).toEqual({ name: "Alice", extra: true });
383
+ invalid(aot, {});
384
+ });
385
+
386
+ test("object with catchall", () => {
387
+ const aot = compile(z.object({ name: z.string() }).catchall(z.number()));
388
+ expect(valid(aot, { name: "Alice" })).toEqual({ name: "Alice" });
389
+ expect(valid(aot, { name: "Alice", age: 30 })).toEqual({ name: "Alice", age: 30 });
390
+ invalid(aot, { name: "Alice", age: "30" });
391
+ });
392
+
393
+ // === Matches Zod behavior ===
394
+
395
+ test("matches Zod: primitives", () => {
396
+ expectMatch(z.string(), "hello");
397
+ expectMatch(z.string(), 123);
398
+ expectMatch(z.number(), 123);
399
+ expectMatch(z.number(), Number.NaN);
400
+ expectMatch(z.boolean(), true);
401
+ expectMatch(z.boolean(), 1);
402
+ });
403
+
404
+ test("matches Zod: void/nan/date", () => {
405
+ expectMatch(z.void(), undefined);
406
+ expectMatch(z.void(), null);
407
+ expectMatch(z.nan(), Number.NaN);
408
+ expectMatch(z.nan(), 0);
409
+ expectMatch(z.date(), new Date());
410
+ expectMatch(z.date(), new Date("invalid"));
411
+ expectMatch(z.date(), "2024-01-01");
412
+ });
413
+
414
+ test("matches Zod: complex schema", () => {
415
+ const schema = z.strictObject({
416
+ id: z.number(),
417
+ name: z.string(),
418
+ tags: z.array(z.string()),
419
+ nested: z.object({
420
+ active: z.boolean(),
421
+ }),
422
+ });
423
+
424
+ expectMatch(schema, { id: 1, name: "test", tags: ["a"], nested: { active: true } });
425
+ expectMatch(schema, { id: 1, name: "test", tags: ["a"], nested: { active: true }, extra: "x" });
426
+ expectMatch(schema, { id: "1", name: "test", tags: ["a"], nested: { active: true } });
427
+ });
428
+
429
+ // === Checks ===
430
+
431
+ test("number min/max", () => {
432
+ const aot = compile(z.number().min(0).max(100));
433
+ expect(valid(aot, 50)).toBe(50);
434
+ expect(valid(aot, 0)).toBe(0);
435
+ expect(valid(aot, 100)).toBe(100);
436
+ invalid(aot, -1);
437
+ invalid(aot, 101);
438
+ });
439
+
440
+ test("number exclusive min/max", () => {
441
+ const aot = compile(z.number().gt(0).lt(100));
442
+ expect(valid(aot, 50)).toBe(50);
443
+ expect(valid(aot, 1)).toBe(1);
444
+ expect(valid(aot, 99)).toBe(99);
445
+ invalid(aot, 0);
446
+ invalid(aot, 100);
447
+ });
448
+
449
+ test("number int", () => {
450
+ const aot = compile(z.number().int());
451
+ expect(valid(aot, 5)).toBe(5);
452
+ expect(valid(aot, -10)).toBe(-10);
453
+ invalid(aot, 5.5);
454
+ });
455
+
456
+ test("number multipleOf", () => {
457
+ const aot = compile(z.number().multipleOf(5));
458
+ expect(valid(aot, 0)).toBe(0);
459
+ expect(valid(aot, 5)).toBe(5);
460
+ expect(valid(aot, 10)).toBe(10);
461
+ invalid(aot, 7);
462
+ });
463
+
464
+ test("string length checks", () => {
465
+ const aot = compile(z.string().min(3).max(10));
466
+ expect(valid(aot, "abc")).toBe("abc");
467
+ expect(valid(aot, "0123456789")).toBe("0123456789");
468
+ invalid(aot, "ab");
469
+ invalid(aot, "01234567890");
470
+ });
471
+
472
+ test("string exact length", () => {
473
+ const aot = compile(z.string().length(5));
474
+ expect(valid(aot, "hello")).toBe("hello");
475
+ invalid(aot, "hi");
476
+ invalid(aot, "toolong");
477
+ });
478
+
479
+ test("string regex", () => {
480
+ const aot = compile(z.string().regex(/^[a-z]+$/));
481
+ expect(valid(aot, "hello")).toBe("hello");
482
+ invalid(aot, "Hello");
483
+ invalid(aot, "hello123");
484
+ });
485
+
486
+ test("string startsWith/endsWith/includes", () => {
487
+ const aot = compile(z.string().startsWith("hello").endsWith("world").includes("beautiful"));
488
+ expect(valid(aot, "hello beautiful world")).toBe("hello beautiful world");
489
+ invalid(aot, "hello world");
490
+ invalid(aot, "beautiful world");
491
+ });
492
+
493
+ test("string lowercase/uppercase", () => {
494
+ const lower = compile(z.string().lowercase());
495
+ expect(valid(lower, "hello")).toBe("hello");
496
+ invalid(lower, "Hello");
497
+
498
+ const upper = compile(z.string().uppercase());
499
+ expect(valid(upper, "HELLO")).toBe("HELLO");
500
+ invalid(upper, "Hello");
501
+ });
502
+
503
+ test("array length checks", () => {
504
+ const aot = compile(z.array(z.number()).min(1).max(3));
505
+ expect(valid(aot, [1])).toEqual([1]);
506
+ expect(valid(aot, [1, 2, 3])).toEqual([1, 2, 3]);
507
+ invalid(aot, []);
508
+ invalid(aot, [1, 2, 3, 4]);
509
+ });
510
+
511
+ test("bigint min/max", () => {
512
+ const aot = compile(z.bigint().min(0n).max(100n));
513
+ expect(valid(aot, 50n)).toBe(50n);
514
+ expect(valid(aot, 0n)).toBe(0n);
515
+ invalid(aot, -1n);
516
+ invalid(aot, 101n);
517
+ });
518
+
519
+ test("matches Zod: checks", () => {
520
+ const schema = z
521
+ .string()
522
+ .min(3)
523
+ .max(10)
524
+ .regex(/^[a-z]+$/);
525
+ expectMatch(schema, "hello");
526
+ expectMatch(schema, "ab");
527
+ expectMatch(schema, "Hello");
528
+ expectMatch(schema, "toolongstring");
529
+ });
530
+
531
+ test("custom refine", () => {
532
+ const aot = compile(z.string().refine((x) => x.length > 3));
533
+ expect(valid(aot, "hello")).toBe("hello");
534
+ invalid(aot, "abc");
535
+ invalid(aot, "ab");
536
+ });
537
+
538
+ test("custom refine with object", () => {
539
+ const aot = compile(
540
+ z
541
+ .object({
542
+ password: z.string(),
543
+ confirm: z.string(),
544
+ })
545
+ .refine((data) => data.password === data.confirm)
546
+ );
547
+ expect(valid(aot, { password: "secret", confirm: "secret" })).toEqual({ password: "secret", confirm: "secret" });
548
+ invalid(aot, { password: "secret", confirm: "wrong" });
549
+ });
550
+
551
+ // === String Formats ===
552
+
553
+ test("email", () => {
554
+ const aot = compile(z.email());
555
+ expect(valid(aot, "test@example.com")).toBe("test@example.com");
556
+ expect(valid(aot, "user.name+tag@example.co.uk")).toBe("user.name+tag@example.co.uk");
557
+ invalid(aot, "invalid");
558
+ invalid(aot, "@example.com");
559
+ invalid(aot, 123);
560
+ });
561
+
562
+ test("uuid", () => {
563
+ const aot = compile(z.uuid());
564
+ expect(valid(aot, "550e8400-e29b-41d4-a716-446655440000")).toBe("550e8400-e29b-41d4-a716-446655440000");
565
+ expect(valid(aot, "00000000-0000-0000-0000-000000000000")).toBe("00000000-0000-0000-0000-000000000000");
566
+ invalid(aot, "not-a-uuid");
567
+ invalid(aot, "550e8400-e29b-41d4-a716");
568
+ });
569
+
570
+ test("url", () => {
571
+ const aot = compile(z.url());
572
+ expect(valid(aot, "https://example.com")).toBe("https://example.com");
573
+ expect(valid(aot, " https://example.com ")).toBe("https://example.com");
574
+ expect(valid(aot, "http://localhost:3000/path")).toBe("http://localhost:3000/path");
575
+ invalid(aot, "not a url");
576
+ invalid(aot, "example.com");
577
+ });
578
+
579
+ test("ipv4", () => {
580
+ const aot = compile(z.ipv4());
581
+ expect(valid(aot, "192.168.1.1")).toBe("192.168.1.1");
582
+ expect(valid(aot, "0.0.0.0")).toBe("0.0.0.0");
583
+ expect(valid(aot, "255.255.255.255")).toBe("255.255.255.255");
584
+ invalid(aot, "192.168.1");
585
+ invalid(aot, "256.0.0.0");
586
+ });
587
+
588
+ test("matches Zod: string formats", () => {
589
+ expectMatch(z.email(), "test@example.com");
590
+ expectMatch(z.email(), "invalid");
591
+ expectMatch(z.uuid(), "550e8400-e29b-41d4-a716-446655440000");
592
+ expectMatch(z.uuid(), "not-a-uuid");
593
+ // z.url() intentionally throws at compile time (see "url is unsupported").
594
+ });
595
+
596
+ // === Tuple ===
597
+
598
+ test("tuple basic", () => {
599
+ const aot = compile(z.tuple([z.string(), z.number()]));
600
+ expect(valid(aot, ["hello", 42])).toEqual(["hello", 42]);
601
+ invalid(aot, ["hello", "world"]);
602
+ invalid(aot, ["hello"]);
603
+ invalid(aot, ["hello", 42, "extra"]);
604
+ invalid(aot, {});
605
+ });
606
+
607
+ test("tuple with rest", () => {
608
+ const aot = compile(z.tuple([z.string(), z.number()]).rest(z.boolean()));
609
+ expect(valid(aot, ["hello", 42])).toEqual(["hello", 42]);
610
+ expect(valid(aot, ["hello", 42, true])).toEqual(["hello", 42, true]);
611
+ expect(valid(aot, ["hello", 42, true, false])).toEqual(["hello", 42, true, false]);
612
+ invalid(aot, ["hello", 42, "extra"]);
613
+ invalid(aot, ["hello"]);
614
+ });
615
+
616
+ test("tuple empty", () => {
617
+ const aot = compile(z.tuple([]));
618
+ expect(valid(aot, [])).toEqual([]);
619
+ invalid(aot, ["extra"]);
620
+ });
621
+
622
+ test("matches Zod: tuple", () => {
623
+ const schema = z.tuple([z.string(), z.number()]).rest(z.boolean());
624
+ expectMatch(schema, ["hello", 42]);
625
+ expectMatch(schema, ["hello", 42, true, false]);
626
+ expectMatch(schema, ["hello", 42, "not boolean"]);
627
+ expectMatch(schema, ["hello"]);
628
+ });
629
+
630
+ // === Union ===
631
+
632
+ test("union of primitives", () => {
633
+ const aot = compile(z.union([z.string(), z.number()]));
634
+ expect(valid(aot, "hello")).toBe("hello");
635
+ expect(valid(aot, 42)).toBe(42);
636
+ invalid(aot, true);
637
+ invalid(aot, null);
638
+ });
639
+
640
+ test("union of literals (Set optimization)", () => {
641
+ const aot = compile(z.union([z.literal("a"), z.literal("b"), z.literal("c")]));
642
+ expect(valid(aot, "a")).toBe("a");
643
+ expect(valid(aot, "b")).toBe("b");
644
+ expect(valid(aot, "c")).toBe("c");
645
+ invalid(aot, "d");
646
+ });
647
+
648
+ test("union single option", () => {
649
+ const aot = compile(z.union([z.string()]));
650
+ expect(valid(aot, "hello")).toBe("hello");
651
+ invalid(aot, 42);
652
+ });
653
+
654
+ test("union with objects", () => {
655
+ const aot = compile(
656
+ z.union([
657
+ z.object({ type: z.literal("a"), value: z.string() }),
658
+ z.object({ type: z.literal("b"), value: z.number() }),
659
+ ])
660
+ );
661
+ expect(valid(aot, { type: "a", value: "hello" })).toEqual({ type: "a", value: "hello" });
662
+ expect(valid(aot, { type: "b", value: 42 })).toEqual({ type: "b", value: 42 });
663
+ invalid(aot, { type: "a", value: 42 });
664
+ invalid(aot, { type: "c", value: "hello" });
665
+ });
666
+
667
+ test("matches Zod: union", () => {
668
+ const schema = z.union([z.string(), z.number(), z.null()]);
669
+ expectMatch(schema, "hello");
670
+ expectMatch(schema, 42);
671
+ expectMatch(schema, null);
672
+ expectMatch(schema, true);
673
+ expectMatch(schema, undefined);
674
+ });
675
+
676
+ // === Intersection ===
677
+
678
+ test("intersection of objects", () => {
679
+ const aot = compile(z.intersection(z.object({ name: z.string() }), z.object({ age: z.number() })));
680
+ expect(valid(aot, { name: "Alice", age: 30 })).toEqual({ name: "Alice", age: 30 });
681
+ invalid(aot, { name: "Alice" });
682
+ invalid(aot, { age: 30 });
683
+ });
684
+
685
+ test("intersection deep merge", () => {
686
+ const aot = compile(
687
+ z.intersection(z.object({ nested: z.object({ a: z.string() }) }), z.object({ nested: z.object({ b: z.number() }) }))
688
+ );
689
+ expect(valid(aot, { nested: { a: "x", b: 1 } })).toEqual({ nested: { a: "x", b: 1 } });
690
+ });
691
+
692
+ // === Record ===
693
+
694
+ test("record basic", () => {
695
+ const aot = compile(z.record(z.string(), z.number()));
696
+ expect(valid(aot, {})).toEqual({});
697
+ expect(valid(aot, { a: 1, b: 2 })).toEqual({ a: 1, b: 2 });
698
+ invalid(aot, { a: "hello" });
699
+ invalid(aot, null);
700
+ invalid(aot, []);
701
+ });
702
+
703
+ test("record with enum keys", () => {
704
+ // Records with enum/literal keys have exhaustive semantics: every enum value must be present in the input. Compile currently forces fallback for this case (see compile.ts generateRecordCheck), so behavior matches the runtime by delegation.
705
+ const aot = compile(z.record(z.enum(["a", "b"]), z.number()));
706
+ expect(valid(aot, { a: 1, b: 2 })).toEqual({ a: 1, b: 2 });
707
+ invalid(aot, { a: 1 }); // missing required key b
708
+ invalid(aot, { c: 3 }); // unknown key
709
+ });
710
+
711
+ test("matches Zod: record", () => {
712
+ const schema = z.record(z.string(), z.number());
713
+ expectMatch(schema, {});
714
+ expectMatch(schema, { a: 1, b: 2 });
715
+ expectMatch(schema, { a: "hello" });
716
+ });
717
+
718
+ // === Map ===
719
+
720
+ test("map basic", () => {
721
+ const aot = compile(z.map(z.string(), z.number()));
722
+ expect(valid(aot, new Map())).toEqual(new Map());
723
+ expect(
724
+ valid(
725
+ aot,
726
+ new Map([
727
+ ["a", 1],
728
+ ["b", 2],
729
+ ])
730
+ )
731
+ ).toEqual(
732
+ new Map([
733
+ ["a", 1],
734
+ ["b", 2],
735
+ ])
736
+ );
737
+ invalid(aot, new Map([["a", "hello"]]));
738
+ invalid(aot, new Map([[1, 1]]));
739
+ invalid(aot, {});
740
+ });
741
+
742
+ test("matches Zod: map", () => {
743
+ const schema = z.map(z.string(), z.number());
744
+ expectMatch(schema, new Map());
745
+ expectMatch(schema, new Map([["a", 1]]));
746
+ expectMatch(schema, new Map([["a", "hello"]]));
747
+ expectMatch(schema, {});
748
+ });
749
+
750
+ // === Set ===
751
+
752
+ test("set basic", () => {
753
+ const aot = compile(z.set(z.number()));
754
+ expect(valid(aot, new Set())).toEqual(new Set());
755
+ expect(valid(aot, new Set([1, 2, 3]))).toEqual(new Set([1, 2, 3]));
756
+ invalid(aot, new Set(["hello"]));
757
+ invalid(aot, []);
758
+ });
759
+
760
+ test("set size checks", () => {
761
+ const aot = compile(z.set(z.number()).min(1).max(3));
762
+ expect(valid(aot, new Set([1]))).toEqual(new Set([1]));
763
+ expect(valid(aot, new Set([1, 2, 3]))).toEqual(new Set([1, 2, 3]));
764
+ invalid(aot, new Set());
765
+ invalid(aot, new Set([1, 2, 3, 4]));
766
+ });
767
+
768
+ test("matches Zod: set", () => {
769
+ const schema = z.set(z.string());
770
+ expectMatch(schema, new Set());
771
+ expectMatch(schema, new Set(["a", "b"]));
772
+ expectMatch(schema, new Set([1, 2]));
773
+ expectMatch(schema, []);
774
+ });
775
+
776
+ // === Template Literal ===
777
+
778
+ test("template literal basic", () => {
779
+ const aot = compile(z.templateLiteral([z.literal("hello"), z.literal("-"), z.literal("world")]));
780
+ expect(valid(aot, "hello-world")).toBe("hello-world");
781
+ invalid(aot, "hello-world!");
782
+ invalid(aot, "helloworld");
783
+ invalid(aot, 123);
784
+ });
785
+
786
+ test("template literal with types", () => {
787
+ const aot = compile(z.templateLiteral(["user-", z.number()]));
788
+ expect(valid(aot, "user-123")).toBe("user-123");
789
+ expect(valid(aot, "user-0")).toBe("user-0");
790
+ invalid(aot, "user-abc");
791
+ invalid(aot, "admin-123");
792
+ });
793
+
794
+ test("matches Zod: template literal", () => {
795
+ const schema = z.templateLiteral(["id-", z.number()]);
796
+ expectMatch(schema, "id-123");
797
+ expectMatch(schema, "id-abc");
798
+ expectMatch(schema, "other-123");
799
+ });
800
+
801
+ // === Lazy ===
802
+
803
+ test("lazy basic", () => {
804
+ const aot = compile(z.lazy(() => z.string()));
805
+ expect(valid(aot, "hello")).toBe("hello");
806
+ invalid(aot, 123);
807
+ });
808
+
809
+ test("lazy recursive schemas are refused, and still parse through the runtime", () => {
810
+ interface Node {
811
+ value: string;
812
+ next?: Node | undefined;
813
+ }
814
+ const nodeSchema: z.ZodType<Node> = z.object({
815
+ value: z.string(),
816
+ next: z.lazy(() => nodeSchema).optional(),
817
+ });
818
+
819
+ // A recursive schema is re-entered by a single parse, which is how the runtime memoizer terminates input containing a reference cycle. That state is keyed on the parse context, and the fast path has none, so it declines the schema rather than following the cycle until the stack runs out.
820
+ expect(() => compile(nodeSchema, { strict: true })).toThrow(ZodCompileUnsupportedError);
821
+
822
+ expect(valid(nodeSchema, { value: "a" })).toEqual({ value: "a" });
823
+ expect(valid(nodeSchema, { value: "a", next: { value: "b" } })).toEqual({ value: "a", next: { value: "b" } });
824
+ invalid(nodeSchema, { value: "a", next: { value: 123 } });
825
+ invalid(nodeSchema, { value: 123 });
826
+
827
+ // The case the refusal exists for: cyclic input parses instead of crashing.
828
+ const cyclic: any = { value: "a" };
829
+ cyclic.next = cyclic;
830
+ expect(() => nodeSchema.parse(cyclic)).not.toThrow();
831
+ });
832
+
833
+ test("matches Zod: lazy", () => {
834
+ const schema = z.lazy(() => z.string());
835
+ expectMatch(schema, "hello");
836
+ expectMatch(schema, 123);
837
+ });
838
+
839
+ // === Pipe ===
840
+
841
+ test("pipe without transform", () => {
842
+ // Pipe with both schemas validating the same type
843
+ const aot = compile(z.string().pipe(z.string().min(3)));
844
+ expect(valid(aot, "hello")).toBe("hello");
845
+ invalid(aot, "ab");
846
+ invalid(aot, 123);
847
+ });
848
+
849
+ test("matches Zod: pipe without transform", () => {
850
+ const schema = z.string().pipe(z.string().min(3));
851
+ expectMatch(schema, "hello");
852
+ expectMatch(schema, "ab");
853
+ expectMatch(schema, 123);
854
+ });
855
+
856
+ // === Custom / Instanceof ===
857
+
858
+ test("instanceof", () => {
859
+ class MyClass {
860
+ value: number;
861
+ constructor(v: number) {
862
+ this.value = v;
863
+ }
864
+ }
865
+
866
+ const aot = compile(z.instanceof(MyClass));
867
+ const instance = new MyClass(1);
868
+ expect(valid(aot, instance)).toBe(instance);
869
+ invalid(aot, { value: 1 });
870
+ invalid(aot, null);
871
+ });
872
+
873
+ test("instanceof Date", () => {
874
+ const aot = compile(z.instanceof(Date));
875
+ const d = new Date();
876
+ expect(valid(aot, d)).toBe(d);
877
+ invalid(aot, "2024-01-01");
878
+ invalid(aot, {});
879
+ });
880
+
881
+ test("matches Zod: instanceof", () => {
882
+ class Test {}
883
+ const schema = z.instanceof(Test);
884
+ expectMatch(schema, new Test());
885
+ expectMatch(schema, {});
886
+ expectMatch(schema, null);
887
+ });
888
+
889
+ // === Bigint Format Checks ===
890
+
891
+ test("bigint int64 format", () => {
892
+ const aot = compile(z.int64());
893
+ expect(valid(aot, 0n)).toBe(0n);
894
+ expect(valid(aot, 9223372036854775807n)).toBe(9223372036854775807n);
895
+ expect(valid(aot, -9223372036854775808n)).toBe(-9223372036854775808n);
896
+ invalid(aot, 9223372036854775808n); // too big
897
+ invalid(aot, -9223372036854775809n); // too small
898
+ });
899
+
900
+ test("bigint uint64 format", () => {
901
+ const aot = compile(z.uint64());
902
+ expect(valid(aot, 0n)).toBe(0n);
903
+ expect(valid(aot, 18446744073709551615n)).toBe(18446744073709551615n);
904
+ invalid(aot, -1n); // negative
905
+ invalid(aot, 18446744073709551616n); // too big
906
+ });
907
+
908
+ test("matches Zod: bigint format", () => {
909
+ const schema = z.int64();
910
+ expectMatch(schema, 0n);
911
+ expectMatch(schema, 9223372036854775807n);
912
+ expectMatch(schema, 9223372036854775808n);
913
+ });
914
+
915
+ // === Nullish (combines optional + nullable) ===
916
+
917
+ test("nullish", () => {
918
+ const aot = compile(z.string().nullish());
919
+ expect(valid(aot, "hello")).toBe("hello");
920
+ expect(valid(aot, null)).toBe(null);
921
+ expect(valid(aot, undefined)).toBe(undefined);
922
+ invalid(aot, 123);
923
+ });
924
+
925
+ test("matches Zod: nullish", () => {
926
+ const schema = z.string().nullish();
927
+ expectMatch(schema, "hello");
928
+ expectMatch(schema, null);
929
+ expectMatch(schema, undefined);
930
+ expectMatch(schema, 123);
931
+ });
932
+
933
+ // === Codec (extends pipe with transform) ===
934
+ // Note: Codecs involve transforms, so AOT validates input and executes transforms.
935
+
936
+ test("codec validates and transforms", () => {
937
+ // stringbool is a codec from string to boolean
938
+ const aot = compile(z.stringbool());
939
+ expect(valid(aot, "true")).toBe(true);
940
+ expect(valid(aot, "false")).toBe(false);
941
+ expect(valid(aot, "1")).toBe(true);
942
+ expect(valid(aot, "0")).toBe(false);
943
+ invalid(aot, 123); // Not a string
944
+ invalid(aot, null);
945
+ });
946
+
947
+ // === SuperRefine ===
948
+
949
+ test("superRefine basic", () => {
950
+ const schema = z.string().superRefine((val, ctx) => {
951
+ if (val.length < 3) {
952
+ ctx.addIssue({ code: "custom", message: "Too short" });
953
+ }
954
+ });
955
+ const aot = compile(schema);
956
+ expect(valid(aot, "hello")).toBe("hello");
957
+ invalid(aot, "ab");
958
+ invalid(aot, 123);
959
+ });
960
+
961
+ test("superRefine with multiple issues", () => {
962
+ const schema = z.number().superRefine((val, ctx) => {
963
+ if (val < 0) ctx.addIssue({ code: "custom", message: "Must be positive" });
964
+ if (val > 100) ctx.addIssue({ code: "custom", message: "Must be <= 100" });
965
+ });
966
+ const aot = compile(schema);
967
+ expect(valid(aot, 50)).toBe(50);
968
+ invalid(aot, -1);
969
+ invalid(aot, 101);
970
+ });
971
+
972
+ test("matches Zod: superRefine", () => {
973
+ const schema = z.string().superRefine((val, ctx) => {
974
+ if (!val.includes("@")) {
975
+ ctx.addIssue({ code: "custom", message: "Must contain @" });
976
+ }
977
+ });
978
+ expectMatch(schema, "test@example.com");
979
+ expectMatch(schema, "invalid");
980
+ expectMatch(schema, 123);
981
+ });
982
+
983
+ // === Transform ===
984
+
985
+ test("transform basic", () => {
986
+ const schema = z.string().transform((val) => val.toUpperCase());
987
+ const aot = compile(schema);
988
+ expect(valid(aot, "hello")).toBe("HELLO"); // Transform succeeds
989
+ invalid(aot, 123); // Not a string (fails before transform)
990
+ });
991
+
992
+ test("transform with validation", () => {
993
+ const schema = z.string().transform((val, ctx) => {
994
+ if (val.length === 0) {
995
+ ctx.addIssue({ code: "custom", message: "Empty string" });
996
+ return z.NEVER;
997
+ }
998
+ return val.length;
999
+ });
1000
+ const aot = compile(schema);
1001
+ expect(valid(aot, "hello")).toBe(5);
1002
+ invalid(aot, ""); // Transform adds issue
1003
+ });
1004
+
1005
+ test("matches Zod: transform", () => {
1006
+ const schema = z.string().transform((val) => val.length);
1007
+ expectMatch(schema, "hello");
1008
+ expectMatch(schema, 123);
1009
+ });
1010
+
1011
+ // === Overwrite Checks (trim, toLowerCase, toUpperCase) ===
1012
+
1013
+ test("trim", () => {
1014
+ const schema = z.string().trim();
1015
+ const aot = compile(schema);
1016
+
1017
+ // AOT validates the input type and applies trim transform
1018
+ expect(valid(aot, " hello ")).toBe("hello");
1019
+ expect(valid(aot, "hello")).toBe("hello");
1020
+ expect(valid(aot, "")).toBe("");
1021
+ invalid(aot, 123);
1022
+ });
1023
+
1024
+ test("toLowerCase", () => {
1025
+ const schema = z.string().toLowerCase();
1026
+ const aot = compile(schema);
1027
+
1028
+ // AOT validates the input type and applies toLowerCase transform
1029
+ expect(valid(aot, "HELLO")).toBe("hello");
1030
+ expect(valid(aot, "hello")).toBe("hello");
1031
+ expect(valid(aot, "")).toBe("");
1032
+ invalid(aot, 123);
1033
+ });
1034
+
1035
+ test("toUpperCase", () => {
1036
+ const schema = z.string().toUpperCase();
1037
+ const aot = compile(schema);
1038
+
1039
+ // AOT validates the input type and applies toUpperCase transform
1040
+ expect(valid(aot, "hello")).toBe("HELLO");
1041
+ expect(valid(aot, "HELLO")).toBe("HELLO");
1042
+ expect(valid(aot, "")).toBe("");
1043
+ invalid(aot, 123);
1044
+ });
1045
+
1046
+ test("chained overwrites", () => {
1047
+ const schema = z.string().trim().toLowerCase();
1048
+ const aot = compile(schema);
1049
+
1050
+ // AOT validates the input type and applies transforms in order
1051
+ expect(valid(aot, " HELLO ")).toBe("hello");
1052
+ expect(valid(aot, "hello")).toBe("hello");
1053
+ expect(valid(aot, "")).toBe("");
1054
+ invalid(aot, 123);
1055
+ });
1056
+
1057
+ test("overwrite with validation", () => {
1058
+ const schema = z.string().trim().min(3);
1059
+ const aot = compile(schema);
1060
+
1061
+ // After trim, check min length
1062
+ expect(valid(aot, " hello ")).toBe("hello"); // "hello" length 5 >= 3
1063
+ expect(valid(aot, "hello")).toBe("hello");
1064
+ invalid(aot, " ab "); // "ab" length 2 < 3
1065
+ expect(valid(aot, "abc")).toBe("abc");
1066
+ invalid(aot, 123);
1067
+ });
1068
+
1069
+ test("matches Zod: trim", () => {
1070
+ const schema = z.string().trim();
1071
+ expectMatch(schema, " hello ");
1072
+ expectMatch(schema, "hello");
1073
+ expectMatch(schema, 123);
1074
+ });
1075
+
1076
+ test("matches Zod: toLowerCase", () => {
1077
+ const schema = z.string().toLowerCase();
1078
+ expectMatch(schema, "HELLO");
1079
+ expectMatch(schema, "hello");
1080
+ expectMatch(schema, 123);
1081
+ });
1082
+
1083
+ test("matches Zod: toUpperCase", () => {
1084
+ const schema = z.string().toUpperCase();
1085
+ expectMatch(schema, "hello");
1086
+ expectMatch(schema, "HELLO");
1087
+ expectMatch(schema, 123);
1088
+ });
1089
+
1090
+ test("matches Zod: chained overwrites", () => {
1091
+ const schema = z.string().trim().toLowerCase();
1092
+ expectMatch(schema, " HELLO ");
1093
+ expectMatch(schema, "hello");
1094
+ expectMatch(schema, 123);
1095
+ });
1096
+
1097
+ test("matches Zod: overwrite with validation", () => {
1098
+ const schema = z.string().trim().min(3);
1099
+ expectMatch(schema, " hello ");
1100
+ expectMatch(schema, " ab ");
1101
+ expectMatch(schema, "abc");
1102
+ expectMatch(schema, 123);
1103
+ });
1104
+
1105
+ // === Regressions tracking main ===
1106
+
1107
+ test("object catchall ignores __proto__ key (#5898)", () => {
1108
+ // Passthrough variant
1109
+ const loose = compile(z.looseObject({ name: z.string() }));
1110
+ const polluted = JSON.parse('{"name":"ok","__proto__":{"polluted":true}}');
1111
+ const out = valid(loose, polluted) as Record<string, unknown>;
1112
+ expect(Object.getPrototypeOf(out)).toBe(Object.prototype);
1113
+ expect((out as { polluted?: unknown }).polluted).toBeUndefined();
1114
+
1115
+ // Schema-typed catchall
1116
+ const typed = compile(z.object({ name: z.string() }).catchall(z.number()));
1117
+ const out2 = valid(typed, JSON.parse('{"name":"ok","extra":1}')) as Record<string, unknown>;
1118
+ expect(Object.getPrototypeOf(out2)).toBe(Object.prototype);
1119
+ });
1120
+
1121
+ test("multipleOf with sub-integer step uses float tolerance (#5793)", () => {
1122
+ const aot = compile(z.number().multipleOf(1e-7));
1123
+ expect(valid(aot, 0)).toBe(0);
1124
+ expect(valid(aot, 1e-7)).toBe(1e-7);
1125
+ expect(valid(aot, 3e-7)).toBe(3e-7);
1126
+ invalid(aot, 2.5e-7);
1127
+ invalid(aot, 1.5e-7);
1128
+ });
1129
+
1130
+ test("tuple with trailing optionals accepts short input (#5661)", () => {
1131
+ const schema = z.tuple([z.string(), z.number().optional()]);
1132
+ const aot = compile(schema);
1133
+ expect(valid(aot, ["a"])).toEqual(["a"]);
1134
+ expect(valid(aot, ["a", 1])).toEqual(["a", 1]);
1135
+ invalid(aot, []);
1136
+ invalid(aot, ["a", "b"]);
1137
+ invalid(aot, ["a", 1, "extra"]);
1138
+ });
1139
+
1140
+ test("tuple exactOptional rejects explicit undefined but accepts absence", () => {
1141
+ const aot = compile(z.tuple([z.string().exactOptional()]));
1142
+ expect(valid(aot, [])).toEqual([]);
1143
+ expect(valid(aot, ["x"])).toEqual(["x"]);
1144
+ invalid(aot, [undefined]);
1145
+ invalid(aot, [1]);
1146
+ });
1147
+
1148
+ test("tuple mixed required and exactOptional", () => {
1149
+ const aot = compile(z.tuple([z.number(), z.string().exactOptional(), z.boolean().exactOptional()]));
1150
+ expect(valid(aot, [1])).toEqual([1]);
1151
+ expect(valid(aot, [1, "x"])).toEqual([1, "x"]);
1152
+ expect(valid(aot, [1, "x", true])).toEqual([1, "x", true]);
1153
+ invalid(aot, []);
1154
+ invalid(aot, [1, undefined]);
1155
+ invalid(aot, [1, "x", undefined]);
1156
+ invalid(aot, [1, "x", true, "extra"]);
1157
+ });
1158
+
1159
+ test("tuple optional vs exactOptional differ on explicit undefined", () => {
1160
+ const opt = compile(z.tuple([z.string().optional()]));
1161
+ expect(valid(opt, [])).toEqual([]);
1162
+ expect(valid(opt, [undefined])).toEqual([undefined]);
1163
+
1164
+ const exact = compile(z.tuple([z.string().exactOptional()]));
1165
+ expect(valid(exact, [])).toEqual([]);
1166
+ invalid(exact, [undefined]);
1167
+ });
1168
+
1169
+ test("default() shallow-clones Map/Set/array/object (#5855)", () => {
1170
+ const mapSchema = z.map(z.string(), z.number()).default(new Map([["a", 1]]));
1171
+ const mapFn = compile(mapSchema);
1172
+ const m1 = valid(mapFn, undefined) as Map<string, number>;
1173
+ const m2 = valid(mapFn, undefined) as Map<string, number>;
1174
+ expect(m1).not.toBe(m2);
1175
+ m1.set("b", 2);
1176
+ expect(m2.has("b")).toBe(false);
1177
+
1178
+ const setSchema = z.set(z.string()).default(new Set(["x"]));
1179
+ const setFn = compile(setSchema);
1180
+ const s1 = valid(setFn, undefined) as Set<string>;
1181
+ const s2 = valid(setFn, undefined) as Set<string>;
1182
+ expect(s1).not.toBe(s2);
1183
+ });
1184
+
1185
+ test("multi-value literal accepts each value", () => {
1186
+ const aot = compile(z.literal(["a", "b", 1]));
1187
+ expect(valid(aot, "a")).toBe("a");
1188
+ expect(valid(aot, "b")).toBe("b");
1189
+ expect(valid(aot, 1)).toBe(1);
1190
+ invalid(aot, "c");
1191
+ invalid(aot, 2);
1192
+ });
1193
+
1194
+ // === Phase 1: schema-clone + fallback contract ===
1195
+
1196
+ test("compile returns a fresh clone; original schema is untouched", () => {
1197
+ const original = z.object({ name: z.string() });
1198
+ const originalRun = original._zod.run;
1199
+ const compiled = compile(original);
1200
+ expect(compiled).not.toBe(original);
1201
+ expect(original._zod.run).toBe(originalRun);
1202
+ expect(compiled._zod.run).not.toBe(originalRun);
1203
+ // shape def is shared by reference; cloning is structural at the top
1204
+ expect(compiled._zod.def).toBe(original._zod.def);
1205
+ });
1206
+
1207
+ test("fallback produces ZodError identical to the original schema", () => {
1208
+ const schema = z.object({ name: z.string(), age: z.number().min(0) });
1209
+ const compiled = compile(schema);
1210
+ const cases: unknown[] = [
1211
+ { name: 123, age: 30 },
1212
+ { name: "ok", age: -5 },
1213
+ { name: "ok", age: "thirty" },
1214
+ null,
1215
+ [],
1216
+ { name: "ok" },
1217
+ ];
1218
+ for (const value of cases) {
1219
+ const a = schema.safeParse(value);
1220
+ const b = compiled.safeParse(value);
1221
+ expect(b.success).toBe(a.success);
1222
+ if (!a.success && !b.success) {
1223
+ expect(b.error.issues).toEqual(a.error.issues);
1224
+ }
1225
+ }
1226
+ });
1227
+
1228
+ test("fallback preserves instanceof class name in error message", () => {
1229
+ class User {}
1230
+ const schema = z.instanceof(User);
1231
+ const compiled = compile(schema);
1232
+ expect(compiled.safeParse(new User()).success).toBe(true);
1233
+ const bad = compiled.safeParse({});
1234
+ expect(bad.success).toBe(false);
1235
+ if (!bad.success) {
1236
+ // The error must come from the original schema's runtime, which captured `inst` referring to the original. Class name surfaces in the message.
1237
+ expect(bad.error.issues[0]?.message).toMatch(/User/);
1238
+ }
1239
+ });
1240
+
1241
+ test("compile bypasses fast path for backward direction (codec encode)", () => {
1242
+ const codec = z.stringbool();
1243
+ const compiled = compile(codec);
1244
+ expect(compiled.safeParse("true").data).toBe(true);
1245
+ expect(compiled.safeParse("false").data).toBe(false);
1246
+ expect(compiled.encode(true)).toBe("true");
1247
+ expect(compiled.encode(false)).toBe("false");
1248
+ });
1249
+
1250
+ test("compile bypasses fast path for safeParseAsync", async () => {
1251
+ const schema = z.string().min(3);
1252
+ const compiled = compile(schema);
1253
+ const r = await compiled.safeParseAsync("ok");
1254
+ expect(r.success).toBe(false);
1255
+ const ok = await compiled.safeParseAsync("hello");
1256
+ expect(ok.success).toBe(true);
1257
+ });
1258
+
1259
+ test("ZodCompileAsyncError thrown on async refinement", () => {
1260
+ const schema = z.string().refine(async () => true);
1261
+ expect(() => compile(schema, { strict: true })).toThrow(ZodCompileAsyncError);
1262
+ });
1263
+
1264
+ test("ZodCompileAsyncError thrown on async transform", () => {
1265
+ const schema = z.string().transform(async (s) => s.length);
1266
+ expect(() => compile(schema, { strict: true })).toThrow(ZodCompileAsyncError);
1267
+ });
1268
+
1269
+ test("compiled clone is composable inside another schema", () => {
1270
+ const inner = z.object({ name: z.string() });
1271
+ const compiledInner = compile(inner);
1272
+ const outer = z.object({ user: compiledInner, count: z.number() });
1273
+ const r = outer.safeParse({ user: { name: "ok" }, count: 1 });
1274
+ expect(r.success).toBe(true);
1275
+ if (r.success) expect(r.data).toEqual({ user: { name: "ok" }, count: 1 });
1276
+ const bad = outer.safeParse({ user: { name: 1 }, count: 1 });
1277
+ expect(bad.success).toBe(false);
1278
+ });
1279
+
1280
+ // === catch ===
1281
+
1282
+ test("catch over primitive", () => {
1283
+ const aot = compile(z.catch(z.string(), "fallback"));
1284
+ expect(valid(aot, "hello")).toBe("hello");
1285
+ expect(valid(aot, 123)).toBe("fallback");
1286
+ expect(valid(aot, undefined)).toBe("fallback");
1287
+ });
1288
+
1289
+ test("catch as object property", () => {
1290
+ const aot = compile(z.object({ name: z.catch(z.string(), "anon") }));
1291
+ expect(valid(aot, { name: "Alice" })).toEqual({ name: "Alice" });
1292
+ expect(valid(aot, { name: 123 })).toEqual({ name: "anon" });
1293
+ expect(valid(aot, {})).toEqual({ name: "anon" });
1294
+ });
1295
+
1296
+ test("a catch callback reading ctx is refused; a constant catch compiles", () => {
1297
+ // Finalizing the issues the callback sees depends on the caller's per-parse error map, which generated code never receives — the compiled path produced the default message where `.parse(input, { error })` produces the mapped one. Refuse it, so a union treats it as uncompilable rather than as a rejected branch.
1298
+ const reads = z.catch(z.string().min(5), (ctx) => `bad:${ctx.error.issues.length}`);
1299
+ expect(() => compile(reads, { strict: true })).toThrow(ZodCompileUnsupportedError);
1300
+ expect(reads.parse("hi")).toBe("bad:1");
1301
+ expect(reads.parse(42 as never)).toMatch(/^bad:\d+$/);
1302
+
1303
+ // A constant catch value needs no issues at all, so it keeps the fast path.
1304
+ const constant = compile(z.catch(z.string().min(5), "fb"));
1305
+ expect(valid(constant, "hello world")).toBe("hello world");
1306
+ expect(valid(constant, "hi")).toBe("fb");
1307
+ expect(valid(constant, 42)).toBe("fb");
1308
+ });
1309
+
1310
+ test("catch falls through unsupported inner via runtime island", () => {
1311
+ // Async refine in the inner makes the inner uncompilable, but catch should still compile by treating the whole catch as a runtime island.
1312
+ const aot = compile(z.catch(z.union([z.string(), z.number()]), "fb"));
1313
+ expect(valid(aot, "x")).toBe("x");
1314
+ expect(valid(aot, 1)).toBe(1);
1315
+ expect(valid(aot, true)).toBe("fb");
1316
+ });
1317
+
1318
+ // === IPv6 / CIDRv6 hoisted helpers ===
1319
+
1320
+ test("ipv6 compiled rejects regex-passing but URL-rejecting values", () => {
1321
+ const aot = compile(z.ipv6());
1322
+ expect(valid(aot, "::1")).toBe("::1");
1323
+ expect(valid(aot, "2001:db8::1")).toBe("2001:db8::1");
1324
+ // "0:0:0:0:0:0:0:1:1" matches the IPv6 regex but `new URL` rejects it.
1325
+ invalid(aot, "0:0:0:0:0:0:0:1:1");
1326
+ // Differential: confirm runtime and compiled agree on this fixture.
1327
+ expectMatch(z.ipv6(), "0:0:0:0:0:0:0:1:1");
1328
+ });
1329
+
1330
+ test("cidrv6 compiled validates prefix range and address", () => {
1331
+ const aot = compile(z.cidrv6());
1332
+ expect(valid(aot, "::1/128")).toBe("::1/128");
1333
+ invalid(aot, "::1/129");
1334
+ invalid(aot, "::1/-1");
1335
+ invalid(aot, "not-an-address/64");
1336
+ invalid(aot, "::1");
1337
+ expectMatch(z.cidrv6(), "::1/129");
1338
+ });
1339
+
1340
+ // === Runtime islands ===
1341
+
1342
+ test("runtime island falls through unsupported child inside object", () => {
1343
+ // z.xor (exclusive union) currently throws ZodCompileUnsupportedError. As an object property, the island should let the rest of the object compile.
1344
+ const aot = compile(
1345
+ z.object({
1346
+ label: z.string(),
1347
+ payload: z.xor([z.string(), z.number()]),
1348
+ })
1349
+ );
1350
+ expect(valid(aot, { label: "ok", payload: "x" })).toEqual({ label: "ok", payload: "x" });
1351
+ invalid(aot, { label: "ok", payload: true });
1352
+ invalid(aot, { label: 1, payload: "x" });
1353
+ });
1354
+
1355
+ test("runtime island inside array element", () => {
1356
+ const aot = compile(z.array(z.xor([z.string(), z.number()])));
1357
+ expect(valid(aot, ["a", 1, "b"])).toEqual(["a", 1, "b"]);
1358
+ invalid(aot, ["a", true]);
1359
+ });
1360
+
1361
+ test("an island thrown from inside an indented block leaves the indent level alone", () => {
1362
+ // nullable opens an indented block, coerce throws inside it, and the property islands the pair — two of them so a leak compounds
1363
+ const schema = z.object({ a: z.coerce.number().nullable(), b: z.coerce.number().nullable(), tail: z.string() });
1364
+ expect(compileFn(schema, { debug: true }).code).toMatchInlineSnapshot(`
1365
+ "// Constants: INVALID, c0, c1, c2
1366
+ if (typeof input !== "object" || input === null || Array.isArray(input)) return INVALID;
1367
+ const v0 = input["a"];
1368
+ if (!("a" in input)) return INVALID;
1369
+ const v1 = c1(c0, v0);
1370
+ if (v1 === INVALID) return INVALID;
1371
+ const v2 = input["b"];
1372
+ if (!("b" in input)) return INVALID;
1373
+ const v3 = c1(c2, v2);
1374
+ if (v3 === INVALID) return INVALID;
1375
+ const v4 = input["tail"];
1376
+ if (typeof v4 !== "string") return INVALID;
1377
+ const v5 = { "a": v1, "b": v3, "tail": v4 };
1378
+ return v5;"
1379
+ `);
1380
+ expectMatch(schema, { a: "1", b: null, tail: "x" });
1381
+ expectMatch(schema, { a: "nope", b: null, tail: "x" });
1382
+ });
1383
+
1384
+ test("url string-format check never assigns to its accessor", () => {
1385
+ // const accessor (array element): previously emitted `elem = normalized`,
1386
+ // a TypeError on valid input.
1387
+ const arr = compile(z.array(z.string().url()));
1388
+ expect(valid(arr, ["https://example.com"])).toEqual(["https://example.com"]);
1389
+ invalid(arr, ["not a url"]);
1390
+
1391
+ // property accessor: previously wrote the normalized value back into the caller's input object.
1392
+ const padded = " https://example.com ";
1393
+ const input = { u: padded };
1394
+ expectMatch(z.object({ u: z.string().url() }), input);
1395
+ expect(input.u).toBe(padded);
1396
+ });
1397
+
1398
+ test("lazy schemas with checked or defaulted descendants parse without crashing", () => {
1399
+ // Inner runtime run must receive a ctx — checks read ctx.skipChecks, default/transform read ctx.direction.
1400
+ const aot = compile(z.lazy(() => z.string().min(2)));
1401
+ expect(valid(aot, "abc")).toEqual("abc");
1402
+ invalid(aot, "a");
1403
+
1404
+ // Recursive, so the fast path declines it; the runtime still parses it.
1405
+ const tree: z.ZodType = z.lazy(() => z.object({ v: z.number().int(), kids: z.array(tree).default([]) }));
1406
+ expect(() => compile(tree, { strict: true })).toThrow(ZodCompileUnsupportedError);
1407
+ expect(valid(tree, { v: 1, kids: [{ v: 2 }] })).toEqual({ v: 1, kids: [{ v: 2, kids: [] }] });
1408
+ invalid(tree, { v: 1.5 });
1409
+ });
1410
+
1411
+ test("sync refine returning a Promise rejects like the runtime", () => {
1412
+ const schema = z.string().refine((() => Promise.resolve(true)) as unknown as (v: string) => boolean);
1413
+ const aot = compile(schema);
1414
+ let runtimeErr: string | undefined;
1415
+ let compiledErr: string | undefined;
1416
+ try {
1417
+ schema.parse("x");
1418
+ } catch (e) {
1419
+ runtimeErr = (e as Error).name;
1420
+ }
1421
+ try {
1422
+ aot.parse("x");
1423
+ } catch (e) {
1424
+ compiledErr = (e as Error).name;
1425
+ }
1426
+ expect(runtimeErr).toBeDefined();
1427
+ expect(compiledErr).toBe(runtimeErr);
1428
+ });
1429
+
1430
+ test("literal-union Set optimization respects checks and multi-value literals", () => {
1431
+ const withCheck = z.union([z.literal("a").refine(() => false), z.literal("b")]);
1432
+ expectMatch(withCheck, "a"); // runtime rejects via refine; compiled must too
1433
+ expectMatch(withCheck, "b");
1434
+
1435
+ const multi = z.union([z.literal(["a", "b"]), z.literal("c")]);
1436
+ for (const v of ["a", "b", "c", "d"]) expectMatch(multi, v);
1437
+ });
1438
+
1439
+ test("xor and custom when-gated checks force runtime fallback", () => {
1440
+ expect(() => compile(z.xor([z.string(), z.number()]), { strict: true })).toThrow(ZodCompileUnsupportedError);
1441
+ // Multi-match must reject — verified through the object island.
1442
+ expectMatch(z.object({ v: z.xor([z.number(), z.number().int()]) }), { v: 2 });
1443
+ expectMatch(z.object({ v: z.xor([z.number(), z.number().int()]) }), { v: 1.5 });
1444
+
1445
+ const gated = z.number().gt(5);
1446
+ (gated._zod.def.checks![0]!._zod.def as { when?: unknown }).when = () => false;
1447
+ expect(() => compile(gated, { strict: true })).toThrow(ZodCompileUnsupportedError);
1448
+ expectMatch(z.object({ n: gated }), { n: 3 }); // runtime skips the gated check
1449
+ });
1450
+
1451
+ test("compiled parse surfaces the interpreter's throws through the fallback", () => {
1452
+ // an unmergeable intersection bails to INVALID, and the fallback it hands to raises the interpreter's own error
1453
+ const unmergeable = compile(
1454
+ z.intersection(
1455
+ z.number(),
1456
+ z.number().transform((x) => x + 1)
1457
+ ),
1458
+ { strict: true }
1459
+ );
1460
+ expect(() => unmergeable.parse(1234)).toThrowErrorMatchingInlineSnapshot(
1461
+ `[Error: Unmergable intersection. Error path: []]`
1462
+ );
1463
+
1464
+ // a when-gated check islands at codegen, and the island's INVALID for an async run reaches the same fallback
1465
+ const gated = z.number().refine(() => Promise.resolve(true));
1466
+ (gated._zod.def.checks![0]!._zod.def as { when?: unknown }).when = () => true;
1467
+ const compiled = compile(z.object({ n: gated }), { strict: true });
1468
+ expect(() => compiled.parse({ n: 3 })).toThrow($ZodAsyncError);
1469
+ });
1470
+
1471
+ test("strict objects reject inherited enumerable keys like the runtime", () => {
1472
+ const schema = z.strictObject({ a: z.string() });
1473
+ expectMatch(schema, Object.assign(Object.create({ extra: 1 }), { a: "x" }));
1474
+ expectMatch(schema, { a: "x" });
1475
+ // Own __proto__ keys are skipped by the runtime, not unrecognized.
1476
+ expectMatch(schema, JSON.parse('{"a":"x","__proto__":{"polluted":true}}'));
1477
+
1478
+ const withOptional = z.strictObject({ a: z.string(), b: z.string().optional() });
1479
+ expectMatch(withOptional, Object.assign(Object.create({ extra: 1 }), { a: "x" }));
1480
+ expectMatch(withOptional, JSON.parse('{"a":"x","__proto__":{}}'));
1481
+ });
1482
+
1483
+ test("object output parity: key order, undefined keys, inherited keys, getters", () => {
1484
+ // Loose object: shape keys precede unknown keys in the output.
1485
+ const loose = z.looseObject({ a: z.string() });
1486
+ const looseIn = { x: 1, a: "q", y: 2 };
1487
+ expect(Object.keys(compile(loose).parse(looseIn) as object)).toEqual(Object.keys(loose.parse(looseIn)));
1488
+
1489
+ const cat = z.object({ a: z.string() }).catchall(z.number());
1490
+ const catIn = { x: 1, a: "q" };
1491
+ expect(Object.keys(compile(cat).parse(catIn) as object)).toEqual(Object.keys(cat.parse(catIn)));
1492
+
1493
+ // optin-optional/optout-required prop: absent key omitted, explicit undefined preserved (runtime handlePropertyResult rule).
1494
+ const tf = z.object({
1495
+ a: z
1496
+ .string()
1497
+ .optional()
1498
+ .transform((v) => v),
1499
+ });
1500
+ expect("a" in (compile(tf).parse({}) as object)).toBe(false);
1501
+ expect("a" in tf.parse({})).toBe(false);
1502
+ const opt = z.object({ a: z.string().optional() });
1503
+ expect(Object.keys(compile(opt).parse({ a: undefined }) as object)).toEqual(["a"]);
1504
+
1505
+ // Empty-shape loose: inherited enumerable keys included, own __proto__ dropped.
1506
+ const empty = z.looseObject({});
1507
+ const inherited = Object.assign(Object.create({ extra: 1 }), { own: 2 });
1508
+ expect(compile(empty).parse(inherited)).toEqual({ own: 2, extra: 1 });
1509
+ expect(empty.parse(inherited)).toEqual({ own: 2, extra: 1 });
1510
+ const protoIn = JSON.parse('{"__proto__":{"polluted":1},"x":2}');
1511
+ expect(Object.keys(compile(empty).parse(protoIn) as object)).toEqual(Object.keys(empty.parse(protoIn)));
1512
+
1513
+ // Getters are read exactly once, like the runtime.
1514
+ let reads = 0;
1515
+ const getterIn = {
1516
+ get a() {
1517
+ reads++;
1518
+ return "v";
1519
+ },
1520
+ };
1521
+ expect(compile(z.object({ a: z.string().min(1) })).parse(getterIn)).toEqual({ a: "v" });
1522
+ expect(reads).toBe(1);
1523
+ });
1524
+
1525
+ // === Error taxonomy ===
1526
+
1527
+ test("unsupported features throw ZodCompileUnsupportedError, not raw errors", () => {
1528
+ // __proto__ shape key: output object literal would set the prototype.
1529
+ expect(() => compile(z.object({ ["__proto__"]: z.string() }), { strict: true })).toThrow(ZodCompileUnsupportedError);
1530
+ // Exclusive unions need every branch's failure to be a real runtime failure.
1531
+ expect(() => compile(z.xor([z.object({ a: z.string() }), z.object({ b: z.string() })]), { strict: true })).toThrow(
1532
+ ZodCompileUnsupportedError
1533
+ );
1534
+ // NaN comparison bounds can't compile to a faithful comparison.
1535
+ expect(() => compile(z.number().gt(Number.NaN), { strict: true })).toThrow(ZodCompileUnsupportedError);
1536
+ // A zero bigint divisor has no compiled form: `x % 0n` throws.
1537
+ expect(() => compile(z.bigint().multipleOf(BigInt(0)), { strict: true })).toThrow(ZodCompileUnsupportedError);
1538
+ // Unsupported children still island inside containers.
1539
+ const aot = compile(z.object({ a: z.string(), x: z.xor([z.literal("p"), z.literal("q")]) }));
1540
+ expect(valid(aot, { a: "x", x: "p" })).toEqual({ a: "x", x: "p" });
1541
+ invalid(aot, { a: "x", x: "z" });
1542
+ });
1543
+
1544
+ test("record key schemas compile: formats, checks, numbers, transforms", () => {
1545
+ // A string format lives on the def rather than in `checks`, so an email key schema reads as a bare `z.string()` unless the key path looks for it.
1546
+ for (const [schema, inputs] of [
1547
+ [z.record(z.email(), z.number()), [{ "a@b.com": 1 }, { nope: 1 }, {}]],
1548
+ [z.record(z.string().min(2), z.number()), [{ ab: 1 }, { a: 1 }]],
1549
+ [z.record(z.string().regex(/^k_/), z.number()), [{ k_a: 1 }, { x: 1 }]],
1550
+ // Numeric keys arrive stringified; the runtime retries them as numbers.
1551
+ [z.record(z.number(), z.string()), [{ 1: "a" }, { "1.5": "a" }, { x: "a" }]],
1552
+ [z.record(z.templateLiteral(["id_", z.string()]), z.number()), [{ id_a: 1 }, { b: 1 }]],
1553
+ // The key schema picks the output key, not the input key.
1554
+ [
1555
+ z.record(
1556
+ z
1557
+ .string()
1558
+ .min(1)
1559
+ .overwrite((s: string) => s.toUpperCase()),
1560
+ z.number()
1561
+ ),
1562
+ [{ ab: 1 }, { "": 1 }],
1563
+ ],
1564
+ ] as [z.ZodType, unknown[]][]) {
1565
+ for (const input of inputs) expectMatch(schema, input);
1566
+ }
1567
+
1568
+ // Own __proto__ is skipped rather than validated, matching the runtime.
1569
+ expectMatch(z.record(z.email(), z.number()), JSON.parse('{"__proto__":{"p":1},"a@b.com":1}'));
1570
+
1571
+ // Coercion is modelled nowhere, so a coercing key schema is refused outright rather than compiled to the bare type test it would otherwise become.
1572
+ expect(() => compile(z.record(z.coerce.string(), z.number()), { strict: true })).toThrow(ZodCompileUnsupportedError);
1573
+
1574
+ // A loose record keeps a rejected key verbatim, copying its value across unvalidated instead of failing.
1575
+ for (const input of [{ "a@b.com": 1 }, { nope: 1 }, { "a@b.com": 1, nope: "raw" }, { "a@b.com": "bad" }]) {
1576
+ expectMatch(z.looseRecord(z.email(), z.number()), input);
1577
+ }
1578
+ });
1579
+
1580
+ test("date min/max bounds compile with runtime parity", () => {
1581
+ const schema = z.date().min(new Date("2024-01-01")).max(new Date("2025-01-01"));
1582
+ const aot = compile(schema);
1583
+ const inputs = [new Date("2024-06-15"), new Date("2024-01-01"), new Date("2023-12-31"), new Date("2025-01-02")];
1584
+ for (const input of inputs) expectMatch(schema, input);
1585
+ expect(valid(aot, inputs[0])).toEqual(inputs[0]);
1586
+ invalid(aot, inputs[2]);
1587
+ });
1588
+
1589
+ test("the compiled fallback builds the same Error-shaped error as the runtime", () => {
1590
+ const schema = z.object({ a: z.string(), b: z.number() });
1591
+ const aot = compile(schema);
1592
+
1593
+ // both fast closures fall back to the runtime on rejection, so the error is the runtime's
1594
+ const err = aot.safeParse({ a: 1, b: "x" }).error!;
1595
+ expect(err).toBeInstanceOf(Error);
1596
+ expect(err).toBeInstanceOf(z.core.$ZodError);
1597
+ expect(err.issues).toEqual(schema.safeParse({ a: 1, b: "x" }).error!.issues);
1598
+
1599
+ function callSite() {
1600
+ aot.parse({ a: 1, b: "x" });
1601
+ }
1602
+
1603
+ let thrown: unknown;
1604
+ try {
1605
+ callSite();
1606
+ } catch (err) {
1607
+ thrown = err;
1608
+ }
1609
+ expect(thrown).toBeInstanceOf(Error);
1610
+ expect((thrown as Error).stack).toContain("callSite");
1611
+ });
1612
+
1613
+ // === Never throws ===
1614
+
1615
+ // Snapshot a parse outcome structurally, so a refused compile can be shown not to have disturbed it.
1616
+ function snap(schema: z.ZodType, value: unknown) {
1617
+ const r = schema.safeParse(value);
1618
+ return r.success ? { ok: true, data: r.data } : { ok: false, issues: r.error.issues };
1619
+ }
1620
+
1621
+ // Every shape the compiler refuses, with inputs that exercise the pass, fail and fallback branches of each.
1622
+ function refusedCases(): [string, z.ZodType, unknown[]][] {
1623
+ const gated = z.number().gt(5);
1624
+ (gated._zod.def.checks![0]!._zod.def as { when?: unknown }).when = () => false;
1625
+ const tree: z.ZodType = z.lazy(() => z.object({ v: z.number().int(), kids: z.array(tree).default([]) }));
1626
+
1627
+ return [
1628
+ ["cycle", tree, [{ v: 1, kids: [{ v: 2 }] }, { v: 1.5 }, "nope"]],
1629
+ ["async refine", z.string().refine(async () => true), ["a", 1]],
1630
+ ["async transform", z.string().transform(async (s) => s.length), ["a", 1]],
1631
+ ["async custom", z.custom(async () => true), ["a"]],
1632
+ ["xor", z.xor([z.string(), z.number()]), ["a", 1, true]],
1633
+ ["coerce", z.coerce.number(), ["5", 5, Symbol("x")]],
1634
+ ["catch callback", z.catch(z.string().min(5), (c) => `bad:${c.error.issues.length}`), ["hello world", "hi", 42]],
1635
+ ["when-gated check", gated, [3, 9, "x"]],
1636
+ ["__proto__ key", z.object({ ["__proto__"]: z.string() }), [{}, { a: 1 }]],
1637
+ ["NaN bound", z.number().gt(Number.NaN), [1, "x"]],
1638
+ ["zero bigint divisor", z.bigint().multipleOf(BigInt(0)), [BigInt(4), "x"]],
1639
+ ["coercing record key", z.record(z.coerce.string(), z.number()), [{ a: 1 }, { a: "x" }]],
1640
+ ];
1641
+ }
1642
+
1643
+ test("compile hands back the original schema instead of throwing", () => {
1644
+ for (const [name, schema] of refusedCases()) {
1645
+ expect(() => compile(schema, { strict: true }), name).toThrow();
1646
+ // No wrapper and no clone: the uncompilable schema is its own fallback, exactly as global mode leaves it.
1647
+ expect(compile(schema), name).toBe(schema);
1648
+ }
1649
+ });
1650
+
1651
+ test("a refused compile leaves the schema parsing identically", () => {
1652
+ for (const [name, schema, inputs] of refusedCases()) {
1653
+ // Async schemas throw $ZodAsyncError out of a sync parse; that path is covered separately.
1654
+ if (name.startsWith("async")) continue;
1655
+ const before = inputs.map((i) => snap(schema, i));
1656
+ compile(schema);
1657
+ expect(
1658
+ inputs.map((i) => snap(schema, i)),
1659
+ name
1660
+ ).toEqual(before);
1661
+ }
1662
+ });
1663
+
1664
+ test("a refused compile keeps cyclic input parsing", () => {
1665
+ const nodeSchema: z.ZodType = z.object({ value: z.string(), next: z.lazy(() => nodeSchema).optional() });
1666
+ const cyclic: any = { value: "a" };
1667
+ cyclic.next = cyclic;
1668
+ expect(() => compile(nodeSchema).parse(cyclic)).not.toThrow();
1669
+ });
1670
+
1671
+ test("a refused async compile parses async and rejects sync like the runtime", async () => {
1672
+ const schema = z.string().refine(async (s) => s.length > 1);
1673
+ const aot = compile(schema);
1674
+ expect(aot).toBe(schema);
1675
+
1676
+ await expect(aot.parseAsync("ab")).resolves.toBe("ab");
1677
+ const bad = await aot.safeParseAsync("a");
1678
+ expect(bad.success).toBe(false);
1679
+ expect(bad.error!.issues).toEqual((await schema.safeParseAsync("a")).error!.issues);
1680
+ expect(() => aot.parse("ab")).toThrow(z.core.$ZodAsyncError);
1681
+ });
1682
+
1683
+ test("strict is per-call, so a supported schema compiles either way", () => {
1684
+ const schema = z.object({ a: z.string(), b: z.number() });
1685
+ for (const aot of [compile(schema), compile(schema, { strict: true }), compile(schema, { strict: false })]) {
1686
+ expect(aot).not.toBe(schema);
1687
+ expect(valid(aot, { a: "x", b: 1 })).toEqual({ a: "x", b: 1 });
1688
+ invalid(aot, { a: 1, b: 1 });
1689
+ }
1690
+ });
1691
+
1692
+ test("compiled records walk own enumerable keys without Reflect.ownKeys", () => {
1693
+ // a getOwnPropertyNames snapshot plus a per-key recheck sees the same keys as the runtime's Reflect.ownKeys walk: inherited enumerables are skipped, symbols fail a string key schema but pass a symbol one, and the numeric-string retry still applies
1694
+ const sym = Symbol("s");
1695
+ const bare = compile(z.record(z.string(), z.number()));
1696
+ const inherited = Object.assign(Object.create({ proto: 1 }), { a: 1 });
1697
+ expect(bare.parse(inherited)).toEqual({ a: 1 });
1698
+ const symbolic = { a: 1, [sym]: 2 };
1699
+ expect(bare.safeParse(symbolic).error!.issues).toEqual(
1700
+ z.record(z.string(), z.number()).safeParse(symbolic).error!.issues
1701
+ );
1702
+ expect(bare.safeParse({ a: 1, b: "x" }).error!.issues).toEqual(
1703
+ z.record(z.string(), z.number()).safeParse({ a: 1, b: "x" }).error!.issues
1704
+ );
1705
+ const symKeys = compile(z.record(z.symbol(), z.number()));
1706
+ expect(symKeys.parse({ [sym]: 2 })).toEqual({ [sym]: 2 });
1707
+ expect(symKeys.safeParse({ a: 1 }).success).toBe(false);
1708
+ const emailKeys = compile(z.record(z.email(), z.number()));
1709
+ expect(emailKeys.parse({ "a@b.co": 1 })).toEqual({ "a@b.co": 1 });
1710
+ expect(emailKeys.safeParse({ "a@b.co": 1, [sym]: 2 }).success).toBe(false);
1711
+ expect(compile(z.record(z.number(), z.string())).parse({ 1: "a" })).toEqual({ 1: "a" });
1712
+ // keys are snapshotted before any value is read and rechecked when visited, like the runtime's Reflect.ownKeys walk: a getter that adds a key mid-walk is not visited, one that hides a later key skips it
1713
+ const mutating = (effect: (o: Record<PropertyKey, unknown>) => void) => {
1714
+ const o: Record<PropertyKey, unknown> = {};
1715
+ Object.defineProperty(o, "a", {
1716
+ enumerable: true,
1717
+ get() {
1718
+ effect(o);
1719
+ return 1;
1720
+ },
1721
+ });
1722
+ o.b = 2;
1723
+ return o;
1724
+ };
1725
+ const both = z.record(z.union([z.string(), z.symbol()]), z.number());
1726
+ for (const [schema, effect] of [
1727
+ [
1728
+ both,
1729
+ (o: Record<PropertyKey, unknown>) => {
1730
+ o[sym] = 2;
1731
+ },
1732
+ ],
1733
+ [
1734
+ z.record(z.string(), z.number()),
1735
+ (o: Record<PropertyKey, unknown>) => {
1736
+ o[sym] = "bad";
1737
+ },
1738
+ ],
1739
+ [
1740
+ z.record(z.string(), z.number()),
1741
+ (o: Record<PropertyKey, unknown>) => {
1742
+ o.z = "bad";
1743
+ },
1744
+ ],
1745
+ [
1746
+ z.record(z.string(), z.number()),
1747
+ (o: Record<PropertyKey, unknown>) => Object.defineProperty(o, "b", { enumerable: false }),
1748
+ ],
1749
+ ] as const) {
1750
+ const expected = schema.safeParse(mutating(effect));
1751
+ const actual = compile(schema).safeParse(mutating(effect));
1752
+ expect(actual.success).toBe(expected.success);
1753
+ if (expected.success)
1754
+ expect(Reflect.ownKeys(actual.data as object)).toEqual(Reflect.ownKeys(expected.data as object));
1755
+ else expect(actual.error!.issues).toEqual(expected.error!.issues);
1756
+ }
1757
+ // a getter that defines an own key under an inherited enumerable name mid-walk: the snapshot predates it, so neither walk visits it, and a union that accepts the record cannot be corrected by a fallback
1758
+ const shadowing = () => {
1759
+ const o = Object.create({ z: 0 });
1760
+ Object.defineProperty(o, "a", {
1761
+ enumerable: true,
1762
+ get() {
1763
+ Object.defineProperty(o, "z", { value: 2, enumerable: true });
1764
+ return 1;
1765
+ },
1766
+ });
1767
+ return o;
1768
+ };
1769
+ const inUnion = z.union([z.record(z.string(), z.number()), z.any()]);
1770
+ expect(compile(inUnion).parse(shadowing())).toStrictEqual(inUnion.parse(shadowing()));
1771
+ expect(compile(inUnion).parse(shadowing())).toStrictEqual({ a: 1 });
1772
+ // a key that is non-enumerable at snapshot time and revealed by an earlier getter is in the snapshot and passes the recheck, like the runtime
1773
+ const revealing = () => {
1774
+ const o: Record<string, unknown> = {};
1775
+ Object.defineProperty(o, "a", {
1776
+ enumerable: true,
1777
+ get() {
1778
+ Object.defineProperty(o, "b", { enumerable: true });
1779
+ return 1;
1780
+ },
1781
+ });
1782
+ Object.defineProperty(o, "b", { value: 2, enumerable: false, configurable: true });
1783
+ return o;
1784
+ };
1785
+ const plain = z.record(z.string(), z.number());
1786
+ expect(compile(plain).parse(revealing())).toStrictEqual(plain.parse(revealing()));
1787
+ expect(compile(plain).parse(revealing())).toStrictEqual({ a: 1, b: 2 });
1788
+ });
1789
+
1790
+ test("validate honors custom checks composed with format traits", () => {
1791
+ const postProcessor = z.core.globalConfig.postProcessor;
1792
+ z.core.globalConfig.postProcessor = undefined;
1793
+ try {
1794
+ const CustomEmail = z.core.$constructor<z.core.$ZodEmail>("CustomEmail", (inst, def) => {
1795
+ inst._zod.check = (payload) => {
1796
+ if (payload.value !== "custom") payload.issues.push({ code: "custom", input: payload.value });
1797
+ };
1798
+ z.core.$ZodEmail.init(inst, def);
1799
+ });
1800
+ const schema = new CustomEmail({ type: "string", format: "email", check: "string_format" });
1801
+ for (const [input, valid] of [
1802
+ ["custom", true],
1803
+ ["test@example.com", false],
1804
+ [42, false],
1805
+ ] as const) {
1806
+ expect(z.safeParse(schema, input).success).toBe(valid);
1807
+ expect(z.validate(schema, input)).toBe(valid);
1808
+ }
1809
+ } finally {
1810
+ z.core.globalConfig.postProcessor = postProcessor;
1811
+ }
1812
+ });
1813
+
1814
+ test("validate honors standalone format checks", () => {
1815
+ const cases = [
1816
+ [z.iso.datetime(), "2021-01-01T00:00:00Z"],
1817
+ [z.iso.date(), "2021-01-01"],
1818
+ [z.iso.time(), "00:00:00"],
1819
+ [z.iso.duration(), "P1Y2M3DT4H5M6S"],
1820
+ [z.email(), "test@example.com"],
1821
+ [z.uuid(), "20354d7a-e4fe-47af-8ff6-187bca92f3f9"],
1822
+ [z.ipv4(), "192.168.0.1"],
1823
+ ] as const;
1824
+
1825
+ for (const [schema, valid] of cases) {
1826
+ expect(schema._zod.traits.has("$ZodStringFormat")).toBe(true);
1827
+ expect(schema instanceof z.core.$ZodStringFormat).toBe(true);
1828
+ expect(z.validate(schema, valid)).toBe(true);
1829
+ expect(z.validate(schema, "invalid")).toBe(false);
1830
+ expect(z.validate(schema, 1)).toBe(false);
1831
+ }
1832
+
1833
+ const source = z.email();
1834
+ const refined = source.refine((value) => value.startsWith("x"));
1835
+ const asyncRefined = source.refine(async () => true);
1836
+ const coercedDef = Object.assign(Object.create({ coerce: true }), source._zod.def);
1837
+ const coerced = source.clone(coercedDef);
1838
+ const checkedDef = Object.assign(Object.create({ checks: refined._zod.def.checks }), source._zod.def);
1839
+ const inheritedChecked = source.clone(checkedDef);
1840
+ expect(z.validate(refined, "test@example.com")).toBe(false);
1841
+ expect(z.validate(refined, "x@example.com")).toBe(true);
1842
+ expect(z.validate(inheritedChecked, "test@example.com")).toBe(false);
1843
+ expect(() => z.validate(asyncRefined, "test@example.com")).toThrow($ZodAsyncError);
1844
+ expect(z.validate(coerced, { toString: () => "test@example.com" })).toBe(true);
1845
+ });
1846
+
1847
+ test("runtime validate preserves contexts, getters, errors, and regex state", () => {
1848
+ const postProcessor = z.core.globalConfig.postProcessor;
1849
+ z.core.globalConfig.postProcessor = undefined;
1850
+ try {
1851
+ const source = z.email();
1852
+ expect(z.validate(source, "invalid", { skipChecks: true } as any)).toBe(true);
1853
+
1854
+ let whenReads = 0;
1855
+ const whenProto = Object.defineProperty({}, "when", {
1856
+ enumerable: true,
1857
+ get() {
1858
+ whenReads++;
1859
+ return () => false;
1860
+ },
1861
+ });
1862
+ const whenDef = Object.assign(Object.create(whenProto), source._zod.def);
1863
+ const gated = source.clone(whenDef as typeof source._zod.def);
1864
+ expect(whenReads).toBe(0);
1865
+ expect(z.validate(gated, "invalid")).toBe(true);
1866
+ expect(whenReads).toBeGreaterThan(0);
1867
+
1868
+ let errorReads = 0;
1869
+ const errorDef = Object.defineProperties({}, Object.getOwnPropertyDescriptors(source._zod.def));
1870
+ Object.defineProperty(errorDef, "error", {
1871
+ enumerable: true,
1872
+ get() {
1873
+ errorReads++;
1874
+ return () => "custom";
1875
+ },
1876
+ });
1877
+ const customError = source.clone(errorDef as typeof source._zod.def);
1878
+ expect(z.validate(customError, "invalid")).toBe(false);
1879
+ expect(errorReads).toBe(0);
1880
+ const result = customError.safeParse("invalid");
1881
+ expect(errorReads).toBe(0);
1882
+ if (result.success) expect.unreachable();
1883
+ expect(result.error.issues[0]?.message).toBe("custom");
1884
+ expect(errorReads).toBeGreaterThan(0);
1885
+
1886
+ const pattern = /^a$/g;
1887
+ const cloned = source.clone({ ...source._zod.def, pattern });
1888
+ for (let i = 0; i < 3; i++) expect(z.validate(cloned, "a")).toBe(true);
1889
+ expect(z.validate(cloned, "b")).toBe(false);
1890
+ expect(pattern.lastIndex).toBe(0);
1891
+ const replacement = /^b$/g;
1892
+ cloned._zod.def.pattern = replacement;
1893
+ expect(z.validate(cloned, "a")).toBe(false);
1894
+ expect(z.validate(cloned, "b")).toBe(true);
1895
+ } finally {
1896
+ z.core.globalConfig.postProcessor = postProcessor;
1897
+ }
1898
+ });
1899
+
1900
+ test("validate preserves live pattern accessor reads", () => {
1901
+ const postProcessor = z.core.globalConfig.postProcessor;
1902
+ z.core.globalConfig.postProcessor = undefined;
1903
+ try {
1904
+ const schema = z.email();
1905
+ let reads = 0;
1906
+ Object.defineProperty(schema.def, "pattern", {
1907
+ get: () => (++reads % 2 === 1 ? /^a$/ : /^b$/),
1908
+ });
1909
+ expect(schema.safeParse("b").success).toBe(true);
1910
+ expect(reads).toBe(2);
1911
+ reads = 0;
1912
+ expect(z.validate(schema, "b")).toBe(true);
1913
+ expect(reads).toBe(2);
1914
+ } finally {
1915
+ z.core.globalConfig.postProcessor = postProcessor;
1916
+ }
1917
+ });
1918
+
1919
+ test.each(["when", "coerce"] as const)("runtime validate honors live %s options", (option) => {
1920
+ const postProcessor = z.core.globalConfig.postProcessor;
1921
+ z.core.globalConfig.postProcessor = undefined;
1922
+ try {
1923
+ for (const inherited of [false, true]) {
1924
+ const schema = z.email();
1925
+ const input = option === "when" ? "invalid" : { toString: () => "test@example.com" };
1926
+ expect(z.validate(schema, input)).toBe(false);
1927
+
1928
+ const target = inherited ? Object.create(Object.getPrototypeOf(schema.def)) : schema.def;
1929
+ let reads = 0;
1930
+ Object.defineProperty(target, option, {
1931
+ get() {
1932
+ reads++;
1933
+ return option === "when" ? () => false : true;
1934
+ },
1935
+ });
1936
+ if (inherited) Object.setPrototypeOf(schema.def, target);
1937
+ expect(reads).toBe(0);
1938
+ expect(z.validate(schema, input)).toBe(true);
1939
+ expect(reads).toBeGreaterThan(0);
1940
+ expect(schema.safeParse(input).success).toBe(true);
1941
+ }
1942
+ } finally {
1943
+ z.core.globalConfig.postProcessor = postProcessor;
1944
+ }
1945
+ });
1946
+
1947
+ test("validate uses compiled validators and runtime fallbacks", () => {
1948
+ const compiled = compile(z.email());
1949
+ expect((compiled._zod.bag as { validator?: unknown }).validator).toBeTypeOf("function");
1950
+ expect(z.validate(compiled, "test@example.com")).toBe(true);
1951
+ expect(z.validate(compiled, "invalid")).toBe(false);
1952
+ expect(z.validate(compiled, "invalid", { skipChecks: true } as any)).toBe(true);
1953
+
1954
+ const source = z.email();
1955
+ const installed = withParser(source, () => INVALID);
1956
+ const bag = installed._zod.bag as { fallbackRun: typeof source._zod.run };
1957
+ const originalRun = bag.fallbackRun;
1958
+ let fallbackRuns = 0;
1959
+ bag.fallbackRun = (payload, ctx) => {
1960
+ fallbackRuns++;
1961
+ return originalRun(payload, ctx);
1962
+ };
1963
+ expect(z.validate(installed, "invalid")).toBe(false);
1964
+ expect(fallbackRuns).toBeGreaterThan(0);
1965
+ });
1966
+
1967
+ // withParser: a parser Zod did not generate, installed on the same wrapper compile() uses.
1968
+
1969
+ // tags its output so a test fails loudly if the runtime ran instead of the supplied parser
1970
+ function taggedParser(input: unknown) {
1971
+ if (typeof input !== "object" || input === null) return INVALID;
1972
+ const o = input as Record<string, unknown>;
1973
+ if (typeof o.a !== "string") return INVALID;
1974
+ return { a: o.a, tag: "supplied" };
1975
+ }
1976
+
1977
+ const withParserSchema = z.object({ a: z.string() });
1978
+
1979
+ test("withParser installs the supplied parser", () => {
1980
+ const installed = withParser(withParserSchema, taggedParser);
1981
+ expect(installed.parse({ a: "x" })).toStrictEqual({ a: "x", tag: "supplied" });
1982
+ // the clone is a new schema; the original keeps the runtime
1983
+ expect(installed).not.toBe(withParserSchema);
1984
+ expect(withParserSchema.parse({ a: "x" })).toStrictEqual({ a: "x" });
1985
+ });
1986
+
1987
+ test("withParser hands INVALID to the runtime and gets a real ZodError", () => {
1988
+ const installed = withParser(withParserSchema, taggedParser);
1989
+ const result = installed.safeParse({ a: 1 });
1990
+ expect(result.success).toBe(false);
1991
+ expect(result.error!.issues).toEqual(withParserSchema.safeParse({ a: 1 }).error!.issues);
1992
+ });
1993
+
1994
+ test("withParser answers validate with the supplied parser", () => {
1995
+ const installed = withParser(withParserSchema, taggedParser);
1996
+ expect(z.validate(installed, { a: "x" })).toBe(true);
1997
+ expect(z.validate(installed, { a: 1 })).toBe(false);
1998
+ });
1999
+
2000
+ test("withParser bypasses the fast path on async, like compile()", async () => {
2001
+ const installed = withParser(withParserSchema, taggedParser);
2002
+ // async runs on the runtime, so the tag is absent
2003
+ await expect(installed.parseAsync({ a: "x" })).resolves.toStrictEqual({ a: "x" });
2004
+ });
2005
+
2006
+ test("withParser reaches a parse it does not own the call site of", () => {
2007
+ const installed = withParser(withParserSchema, taggedParser);
2008
+ // installing on _zod.run rather than wrapping a call site is the whole point: a framework holding the schema gets the supplied parser through Standard Schema, and so does z.parse
2009
+ expect((installed["~standard"].validate({ a: "x" }) as { value: unknown }).value).toStrictEqual({
2010
+ a: "x",
2011
+ tag: "supplied",
2012
+ });
2013
+ expect(z.parse(installed, { a: "x" })).toStrictEqual({ a: "x", tag: "supplied" });
2014
+ });
2015
+
2016
+ test("withParser refuses a recursive schema", () => {
2017
+ type Node = { next: Node | null };
2018
+ const Node: z.ZodType<Node> = z.object({ next: z.lazy(() => z.nullable(Node)) });
2019
+ expect(() => withParser(Node, () => INVALID)).toThrow(ZodCompileUnsupportedError);
2020
+ });
2021
+
2022
+ test("withParser leaves encode on the runtime", () => {
2023
+ const codec = z.codec(z.string(), z.number(), {
2024
+ decode: (s) => Number(s),
2025
+ encode: (n) => String(n),
2026
+ });
2027
+ const installed = withParser(codec, () => INVALID);
2028
+ expect(z.encode(installed, 5)).toBe("5");
2029
+ });
2030
+
2031
+ test("withParser rejects a parser whose output contradicts the schema", () => {
2032
+ // the returned schema still claims T, so a parser that succeeds with something else would make parse() lie about its own type
2033
+ // @ts-expect-error a number is not the output of z.string()
2034
+ withParser(z.string(), () => 123);
2035
+ expectTypeOf(withParser(z.string(), () => "ok")).toEqualTypeOf<z.ZodString>();
2036
+ });