@aztec/foundation 0.0.1-commit.993d52e → 0.0.1-commit.9a89641

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 (292) hide show
  1. package/dest/bigint-buffer/index.d.ts +1 -1
  2. package/dest/bigint-buffer/index.d.ts.map +1 -1
  3. package/dest/bigint-buffer/index.js +6 -1
  4. package/dest/branded-types/block_number.d.ts +3 -3
  5. package/dest/branded-types/block_number.d.ts.map +1 -1
  6. package/dest/branded-types/block_number.js +15 -4
  7. package/dest/branded-types/buffer32_hash.d.ts +27 -0
  8. package/dest/branded-types/buffer32_hash.d.ts.map +1 -0
  9. package/dest/branded-types/buffer32_hash.js +12 -0
  10. package/dest/branded-types/checkpoint_number.d.ts +9 -3
  11. package/dest/branded-types/checkpoint_number.d.ts.map +1 -1
  12. package/dest/branded-types/checkpoint_number.js +11 -0
  13. package/dest/branded-types/epoch.d.ts +2 -2
  14. package/dest/branded-types/epoch.d.ts.map +1 -1
  15. package/dest/branded-types/index.d.ts +2 -1
  16. package/dest/branded-types/index.d.ts.map +1 -1
  17. package/dest/branded-types/index.js +1 -0
  18. package/dest/branded-types/index_within_checkpoint.d.ts +2 -2
  19. package/dest/branded-types/index_within_checkpoint.d.ts.map +1 -1
  20. package/dest/branded-types/slot.d.ts +5 -2
  21. package/dest/branded-types/slot.d.ts.map +1 -1
  22. package/dest/branded-types/slot.js +3 -0
  23. package/dest/buffer/buffer16.d.ts +3 -1
  24. package/dest/buffer/buffer16.d.ts.map +1 -1
  25. package/dest/buffer/buffer32.d.ts +28 -61
  26. package/dest/buffer/buffer32.d.ts.map +1 -1
  27. package/dest/buffer/buffer32.js +29 -63
  28. package/dest/buffer/index.d.ts +2 -1
  29. package/dest/buffer/index.d.ts.map +1 -1
  30. package/dest/buffer/index.js +1 -0
  31. package/dest/buffer/utils.d.ts +3 -0
  32. package/dest/buffer/utils.d.ts.map +1 -0
  33. package/dest/buffer/utils.js +7 -0
  34. package/dest/collection/array.d.ts +11 -1
  35. package/dest/collection/array.d.ts.map +1 -1
  36. package/dest/collection/array.js +33 -0
  37. package/dest/collection/index.d.ts +3 -1
  38. package/dest/collection/index.d.ts.map +1 -1
  39. package/dest/collection/index.js +2 -0
  40. package/dest/collection/lru_map.d.ts +41 -0
  41. package/dest/collection/lru_map.d.ts.map +1 -0
  42. package/dest/collection/lru_map.js +119 -0
  43. package/dest/collection/lru_set.d.ts +35 -0
  44. package/dest/collection/lru_set.d.ts.map +1 -0
  45. package/dest/collection/lru_set.js +95 -0
  46. package/dest/committable/committable.js +1 -1
  47. package/dest/config/env_var.d.ts +2 -2
  48. package/dest/config/env_var.d.ts.map +1 -1
  49. package/dest/config/index.d.ts +67 -37
  50. package/dest/config/index.d.ts.map +1 -1
  51. package/dest/config/index.js +72 -71
  52. package/dest/config/network_config.d.ts +13 -45
  53. package/dest/config/network_config.d.ts.map +1 -1
  54. package/dest/config/network_config.js +2 -0
  55. package/dest/config/network_name.d.ts +2 -2
  56. package/dest/config/network_name.d.ts.map +1 -1
  57. package/dest/config/network_name.js +3 -3
  58. package/dest/config/secret_value.d.ts +2 -2
  59. package/dest/config/secret_value.d.ts.map +1 -1
  60. package/dest/crypto/aes128/index.d.ts +2 -1
  61. package/dest/crypto/aes128/index.d.ts.map +1 -1
  62. package/dest/crypto/aes128/index.js +11 -2
  63. package/dest/crypto/bls/bn254_keystore.d.ts +10 -177
  64. package/dest/crypto/bls/bn254_keystore.d.ts.map +1 -1
  65. package/dest/crypto/bls/bn254_keystore.js +22 -34
  66. package/dest/crypto/keys/index.d.ts +3 -2
  67. package/dest/crypto/keys/index.d.ts.map +1 -1
  68. package/dest/crypto/keys/index.js +30 -6
  69. package/dest/crypto/poseidon/index.d.ts +1 -1
  70. package/dest/crypto/poseidon/index.d.ts.map +1 -1
  71. package/dest/crypto/poseidon/index.js +40 -33
  72. package/dest/crypto/schnorr/index.d.ts +8 -7
  73. package/dest/crypto/schnorr/index.d.ts.map +1 -1
  74. package/dest/crypto/schnorr/index.js +6 -6
  75. package/dest/crypto/schnorr/signature.d.ts +9 -29
  76. package/dest/crypto/schnorr/signature.d.ts.map +1 -1
  77. package/dest/crypto/schnorr/signature.js +20 -36
  78. package/dest/curves/bls12/field.d.ts +3 -3
  79. package/dest/curves/bls12/field.d.ts.map +1 -1
  80. package/dest/curves/bls12/field.js +0 -5
  81. package/dest/curves/bls12/point.d.ts +2 -2
  82. package/dest/curves/bls12/point.d.ts.map +1 -1
  83. package/dest/curves/bn254/field.d.ts +23 -19
  84. package/dest/curves/bn254/field.d.ts.map +1 -1
  85. package/dest/curves/bn254/field.js +23 -17
  86. package/dest/curves/grumpkin/point.d.ts +14 -28
  87. package/dest/curves/grumpkin/point.d.ts.map +1 -1
  88. package/dest/curves/grumpkin/point.js +29 -43
  89. package/dest/eth-address/index.d.ts +2 -2
  90. package/dest/eth-address/index.d.ts.map +1 -1
  91. package/dest/eth-address/index.js +0 -3
  92. package/dest/eth-signature/eth_signature.d.ts +2 -2
  93. package/dest/eth-signature/eth_signature.d.ts.map +1 -1
  94. package/dest/fifo/fifo_frame_reader.d.ts +41 -0
  95. package/dest/fifo/fifo_frame_reader.d.ts.map +1 -0
  96. package/dest/fifo/fifo_frame_reader.js +91 -0
  97. package/dest/fifo/index.d.ts +2 -0
  98. package/dest/fifo/index.d.ts.map +1 -0
  99. package/dest/fifo/index.js +1 -0
  100. package/dest/fifo_set/fifo_set.d.ts +15 -0
  101. package/dest/fifo_set/fifo_set.d.ts.map +1 -0
  102. package/dest/fifo_set/fifo_set.js +39 -0
  103. package/dest/fifo_set/index.d.ts +2 -0
  104. package/dest/fifo_set/index.d.ts.map +1 -0
  105. package/dest/fifo_set/index.js +1 -0
  106. package/dest/jest/setup.js +24 -0
  107. package/dest/json-rpc/client/fetch.d.ts +1 -1
  108. package/dest/json-rpc/client/fetch.d.ts.map +1 -1
  109. package/dest/json-rpc/client/fetch.js +4 -3
  110. package/dest/json-rpc/client/safe_json_rpc_client.d.ts +1 -1
  111. package/dest/json-rpc/client/safe_json_rpc_client.d.ts.map +1 -1
  112. package/dest/json-rpc/client/safe_json_rpc_client.js +5 -4
  113. package/dest/json-rpc/client/undici.d.ts +1 -1
  114. package/dest/json-rpc/client/undici.d.ts.map +1 -1
  115. package/dest/json-rpc/client/undici.js +5 -3
  116. package/dest/json-rpc/fixtures/test_state.d.ts +4 -8
  117. package/dest/json-rpc/fixtures/test_state.d.ts.map +1 -1
  118. package/dest/json-rpc/fixtures/test_state.js +57 -17
  119. package/dest/json-rpc/server/safe_json_rpc_server.d.ts +8 -3
  120. package/dest/json-rpc/server/safe_json_rpc_server.d.ts.map +1 -1
  121. package/dest/json-rpc/server/safe_json_rpc_server.js +32 -14
  122. package/dest/log/aws-logger-config.d.ts +8 -0
  123. package/dest/log/aws-logger-config.d.ts.map +1 -0
  124. package/dest/log/aws-logger-config.js +55 -0
  125. package/dest/log/pino-logger.d.ts +1 -1
  126. package/dest/log/pino-logger.d.ts.map +1 -1
  127. package/dest/log/pino-logger.js +29 -8
  128. package/dest/noir/noir_package_config.d.ts +19 -104
  129. package/dest/noir/noir_package_config.d.ts.map +1 -1
  130. package/dest/noir/noir_package_config.js +1 -1
  131. package/dest/promise/running-promise.d.ts +5 -4
  132. package/dest/promise/running-promise.d.ts.map +1 -1
  133. package/dest/promise/running-promise.js +7 -3
  134. package/dest/queue/batch_queue.d.ts +1 -1
  135. package/dest/queue/batch_queue.d.ts.map +1 -1
  136. package/dest/queue/batch_queue.js +1 -0
  137. package/dest/retry/index.d.ts +31 -3
  138. package/dest/retry/index.d.ts.map +1 -1
  139. package/dest/retry/index.js +44 -2
  140. package/dest/schemas/api.d.ts +12 -10
  141. package/dest/schemas/api.d.ts.map +1 -1
  142. package/dest/schemas/api.js +7 -1
  143. package/dest/schemas/parse.d.ts +4 -4
  144. package/dest/schemas/parse.d.ts.map +1 -1
  145. package/dest/schemas/parse.js +6 -5
  146. package/dest/schemas/schemas.d.ts +15 -15
  147. package/dest/schemas/types.d.ts +3 -3
  148. package/dest/schemas/types.d.ts.map +1 -1
  149. package/dest/schemas/utils.d.ts +7 -11
  150. package/dest/schemas/utils.d.ts.map +1 -1
  151. package/dest/schemas/utils.js +2 -18
  152. package/dest/serialize/buffer_reader.d.ts +1 -1
  153. package/dest/serialize/buffer_reader.d.ts.map +1 -1
  154. package/dest/serialize/buffer_reader.js +5 -0
  155. package/dest/serialize/buffer_sink.d.ts +134 -0
  156. package/dest/serialize/buffer_sink.d.ts.map +1 -0
  157. package/dest/serialize/buffer_sink.js +297 -0
  158. package/dest/serialize/index.d.ts +2 -1
  159. package/dest/serialize/index.d.ts.map +1 -1
  160. package/dest/serialize/index.js +1 -0
  161. package/dest/serialize/serialize.d.ts +1 -32
  162. package/dest/serialize/serialize.d.ts.map +1 -1
  163. package/dest/serialize/serialize.js +0 -21
  164. package/dest/sleep/index.d.ts +2 -1
  165. package/dest/sleep/index.d.ts.map +1 -1
  166. package/dest/sleep/index.js +10 -1
  167. package/dest/string/index.d.ts +3 -1
  168. package/dest/string/index.d.ts.map +1 -1
  169. package/dest/string/index.js +13 -1
  170. package/dest/testing/files/index.d.ts +3 -4
  171. package/dest/testing/files/index.d.ts.map +1 -1
  172. package/dest/testing/files/index.js +3 -4
  173. package/dest/timer/date.d.ts +3 -1
  174. package/dest/timer/date.d.ts.map +1 -1
  175. package/dest/timer/date.js +4 -0
  176. package/dest/timer/index.d.ts +2 -2
  177. package/dest/timer/index.d.ts.map +1 -1
  178. package/dest/timer/index.js +1 -1
  179. package/dest/timer/timeout.d.ts +3 -1
  180. package/dest/timer/timeout.d.ts.map +1 -1
  181. package/dest/timer/timeout.js +26 -0
  182. package/dest/transport/dispatch/create_dispatch_proxy.d.ts +11 -2
  183. package/dest/transport/dispatch/create_dispatch_proxy.d.ts.map +1 -1
  184. package/dest/transport/index.d.ts +1 -2
  185. package/dest/transport/index.d.ts.map +1 -1
  186. package/dest/transport/index.js +0 -1
  187. package/dest/trees/balanced_merkle_tree_root.d.ts +2 -3
  188. package/dest/trees/balanced_merkle_tree_root.d.ts.map +1 -1
  189. package/dest/trees/balanced_merkle_tree_root.js +2 -3
  190. package/dest/trees/hasher.d.ts +3 -2
  191. package/dest/trees/hasher.d.ts.map +1 -1
  192. package/dest/trees/hasher.js +5 -5
  193. package/dest/trees/indexed_merkle_tree_calculator.d.ts +1 -1
  194. package/dest/trees/indexed_merkle_tree_calculator.d.ts.map +1 -1
  195. package/dest/trees/indexed_merkle_tree_calculator.js +5 -1
  196. package/dest/trees/membership_witness.d.ts +2 -6
  197. package/dest/trees/membership_witness.d.ts.map +1 -1
  198. package/dest/trees/membership_witness.js +0 -9
  199. package/dest/trees/merkle_tree_calculator.d.ts +4 -2
  200. package/dest/trees/merkle_tree_calculator.d.ts.map +1 -1
  201. package/dest/trees/merkle_tree_calculator.js +1 -5
  202. package/dest/trees/sibling_path.d.ts +13 -14
  203. package/dest/trees/sibling_path.d.ts.map +1 -1
  204. package/dest/trees/sibling_path.js +23 -28
  205. package/dest/trees/unbalanced_merkle_tree_root.d.ts +2 -3
  206. package/dest/trees/unbalanced_merkle_tree_root.d.ts.map +1 -1
  207. package/dest/trees/unbalanced_merkle_tree_root.js +2 -3
  208. package/dest/types/index.d.ts +23 -1
  209. package/dest/types/index.d.ts.map +1 -1
  210. package/dest/types/index.js +15 -0
  211. package/package.json +6 -4
  212. package/src/bigint-buffer/index.ts +6 -1
  213. package/src/branded-types/block_number.ts +20 -2
  214. package/src/branded-types/buffer32_hash.ts +38 -0
  215. package/src/branded-types/checkpoint_number.ts +16 -1
  216. package/src/branded-types/epoch.ts +1 -1
  217. package/src/branded-types/index.ts +1 -0
  218. package/src/branded-types/index_within_checkpoint.ts +1 -1
  219. package/src/branded-types/slot.ts +6 -1
  220. package/src/buffer/buffer16.ts +3 -0
  221. package/src/buffer/buffer32.ts +39 -68
  222. package/src/buffer/index.ts +1 -0
  223. package/src/buffer/utils.ts +8 -0
  224. package/src/collection/array.ts +34 -0
  225. package/src/collection/index.ts +2 -0
  226. package/src/collection/lru_map.ts +143 -0
  227. package/src/collection/lru_set.ts +115 -0
  228. package/src/committable/committable.ts +1 -1
  229. package/src/config/env_var.ts +63 -25
  230. package/src/config/index.ts +143 -122
  231. package/src/config/network_config.ts +2 -0
  232. package/src/config/network_name.ts +6 -6
  233. package/src/config/secret_value.ts +1 -1
  234. package/src/crypto/aes128/index.ts +11 -2
  235. package/src/crypto/bls/bn254_keystore.ts +33 -43
  236. package/src/crypto/keys/index.ts +20 -4
  237. package/src/crypto/poseidon/index.ts +42 -34
  238. package/src/crypto/schnorr/index.ts +9 -8
  239. package/src/crypto/schnorr/signature.ts +17 -46
  240. package/src/curves/bls12/field.ts +0 -7
  241. package/src/curves/bn254/field.ts +35 -34
  242. package/src/curves/grumpkin/point.ts +23 -40
  243. package/src/eth-address/index.ts +0 -4
  244. package/src/fifo/fifo_frame_reader.ts +113 -0
  245. package/src/fifo/index.ts +1 -0
  246. package/src/fifo_set/fifo_set.ts +52 -0
  247. package/src/fifo_set/index.ts +1 -0
  248. package/src/jest/setup.mjs +27 -0
  249. package/src/json-rpc/client/fetch.ts +4 -3
  250. package/src/json-rpc/client/safe_json_rpc_client.ts +5 -4
  251. package/src/json-rpc/client/undici.ts +5 -3
  252. package/src/json-rpc/fixtures/test_state.ts +10 -10
  253. package/src/json-rpc/server/safe_json_rpc_server.ts +36 -14
  254. package/src/log/aws-logger-config.ts +32 -0
  255. package/src/log/pino-logger.ts +33 -6
  256. package/src/noir/noir_package_config.ts +32 -20
  257. package/src/promise/running-promise.ts +8 -5
  258. package/src/queue/batch_queue.ts +1 -0
  259. package/src/retry/index.ts +66 -4
  260. package/src/schemas/api.ts +25 -25
  261. package/src/schemas/parse.ts +9 -6
  262. package/src/schemas/schemas.ts +4 -4
  263. package/src/schemas/types.ts +2 -2
  264. package/src/schemas/utils.ts +4 -38
  265. package/src/serialize/buffer_reader.ts +5 -0
  266. package/src/serialize/buffer_sink.ts +350 -0
  267. package/src/serialize/index.ts +1 -0
  268. package/src/serialize/serialize.ts +0 -50
  269. package/src/sleep/index.ts +10 -1
  270. package/src/string/index.ts +15 -1
  271. package/src/testing/files/index.ts +3 -4
  272. package/src/timer/date.ts +6 -0
  273. package/src/timer/index.ts +1 -1
  274. package/src/timer/timeout.ts +31 -0
  275. package/src/transport/dispatch/create_dispatch_proxy.ts +11 -1
  276. package/src/transport/index.ts +0 -1
  277. package/src/trees/balanced_merkle_tree_root.ts +2 -5
  278. package/src/trees/hasher.ts +6 -3
  279. package/src/trees/indexed_merkle_tree_calculator.ts +5 -1
  280. package/src/trees/membership_witness.ts +0 -8
  281. package/src/trees/merkle_tree_calculator.ts +4 -10
  282. package/src/trees/sibling_path.ts +24 -30
  283. package/src/trees/unbalanced_merkle_tree_root.ts +2 -5
  284. package/src/types/index.ts +47 -0
  285. package/dest/crypto/serialize.d.ts +0 -51
  286. package/dest/crypto/serialize.d.ts.map +0 -1
  287. package/dest/crypto/serialize.js +0 -68
  288. package/dest/transport/dispatch/create_dispatch_fn.d.ts +0 -25
  289. package/dest/transport/dispatch/create_dispatch_fn.d.ts.map +0 -1
  290. package/dest/transport/dispatch/create_dispatch_fn.js +0 -17
  291. package/src/crypto/serialize.ts +0 -85
  292. package/src/transport/dispatch/create_dispatch_fn.ts +0 -35
@@ -1,5 +1,5 @@
1
1
  import type { ZodType } from 'zod';
2
- export type ZodFor<T> = ZodType<T, any, any>;
2
+ export type ZodFor<T> = ZodType<T, any>;
3
3
  /**
4
4
  * Creates a schema validator that enforces all properties of type T are present in the schema.
5
5
  * This provides compile-time safety to ensure schemas don't miss optional properties.
@@ -23,11 +23,11 @@ export type ZodFor<T> = ZodType<T, any, any>;
23
23
  * }));
24
24
  * ```
25
25
  */
26
- export declare function zodFor<T>(): <S extends ZodType<any, any, any>>(schema: keyof T extends keyof S["_output"] ? keyof S["_output"] extends keyof T ? S : S & {
26
+ export declare function zodFor<T>(): <S extends ZodType<any, any, import("zod/v4/core").$ZodTypeInternals<any, any>>>(schema: keyof T extends keyof S["_output"] ? keyof S["_output"] extends keyof T ? S : S & {
27
27
  __error__: "Schema has extra keys not in type";
28
28
  __extra__: Exclude<keyof S["_output"], keyof T>;
29
29
  } : S & {
30
30
  __error__: "Schema is missing keys from type";
31
31
  __missing__: Exclude<keyof T, keyof S["_output"]>;
32
32
  }) => S;
33
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zY2hlbWFzL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLEtBQUssQ0FBQztBQUVuQyxNQUFNLE1BQU0sTUFBTSxDQUFDLENBQUMsSUFBSSxPQUFPLENBQUMsQ0FBQyxFQUFFLEdBQUcsRUFBRSxHQUFHLENBQUMsQ0FBQztBQUU3Qzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXNCRztBQUNILHdCQUFnQixNQUFNLENBQUMsQ0FBQyxNQUNRLENBQUM7Ozs7OztRQU9oQyJ9
33
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zY2hlbWFzL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLEtBQUssQ0FBQztBQUVuQyxNQUFNLE1BQU0sTUFBTSxDQUFDLENBQUMsSUFBSSxPQUFPLENBQUMsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxDQUFDO0FBRXhDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBc0JHO0FBQ0gsd0JBQWdCLE1BQU0sQ0FBQyxDQUFDLE1BQ1EsQ0FBQzs7Ozs7O1FBT2hDIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schemas/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,CAAC,MACQ,CAAC;;;;;;QAOhC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schemas/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,CAAC,MACQ,CAAC;;;;;;QAOhC"}
@@ -1,19 +1,15 @@
1
- import { type ParseInput, type ParseReturnType, type ZodObject, ZodOptional, type ZodRawShape, type ZodType, type ZodTypeAny, z } from 'zod';
1
+ import { type ZodObject, type ZodRawShape, type ZodType, type ZodTypeAny, z } from 'zod';
2
2
  import type { ZodFor } from './types.js';
3
- export declare const hexSchema: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
3
+ export declare const hexSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
4
4
  /** Schema for a buffer represented as a base64 string or a Buffer object. */
5
5
  export declare const bufferSchema: ZodFor<Buffer>;
6
- export declare class ZodNullableOptional<T extends ZodTypeAny> extends ZodOptional<T> {
7
- _isNullableOptional: boolean;
8
- _parse(input: ParseInput): ParseReturnType<this['_output']>;
9
- static create<T extends ZodTypeAny>(type: T): ZodNullableOptional<T>;
10
- }
6
+ export type ZodNullableOptional<T extends ZodTypeAny> = ZodType<z.output<T> | undefined, z.input<T> | null | undefined>;
11
7
  /**
12
8
  * Declares a parameter as optional. Use this over z.optional in order to accept nulls as undefineds.
13
9
  * This is required as JSON does not have an undefined type, and null is used to represent it, so we
14
10
  * need to convert nulls to undefineds as we parse.
15
11
  */
16
- export declare function optional<T extends ZodTypeAny>(schema: T): ZodNullableOptional<T>;
12
+ export declare function optional<T extends ZodTypeAny>(schema: T): z.ZodPipe<z.ZodOptional<z.ZodNullable<T>>, z.ZodTransform<Awaited<NonNullable<z.TypeOf<T>>> | undefined, z.TypeOf<T> | null | undefined>>;
17
13
  type ToJsonIs<T, TRet> = T extends {
18
14
  toJSON(): TRet;
19
15
  } ? T : never;
@@ -30,7 +26,7 @@ export declare function hexSchemaFor<TClass extends {
30
26
  fromString(str: string): infer TInstance;
31
27
  } | {
32
28
  fromBuffer(buf: Buffer): infer TInstance;
33
- } ? ToJsonIs<TInstance, string> : never, any, string>;
29
+ } ? ToJsonIs<TInstance, string> : never, string>;
34
30
  /**
35
31
  * Creates a schema that accepts a base64 string and uses it to hydrate an instance.
36
32
  * @param klazz - Class that implements fromBuffer.
@@ -40,7 +36,7 @@ export declare function bufferSchemaFor<TClass extends {
40
36
  fromBuffer(buf: Buffer): any;
41
37
  }>(klazz: TClass, refinement?: (buf: Buffer) => boolean): ZodType<TClass extends {
42
38
  fromBuffer(buf: Buffer): infer TInstance;
43
- } ? ToJsonIs<TInstance, Buffer> : never, any, string>;
39
+ } ? ToJsonIs<TInstance, Buffer> : never, string>;
44
40
  /** Creates a schema for a js Map type that matches the serialization used in jsonStringify. */
45
41
  export declare function mapSchema<TKey, TValue>(key: ZodFor<TKey>, value: ZodFor<TValue>): ZodFor<Map<TKey, TValue>>;
46
42
  /** Creates a schema for a js Set type that matches the serialization used in jsonStringify. */
@@ -48,4 +44,4 @@ export declare function setSchema<T>(value: ZodFor<T>): ZodFor<Set<T>>;
48
44
  /** Given an already parsed and validated object, extracts the keys defined in the given schema. Does not validate again. */
49
45
  export declare function pickFromSchema<T extends object, S extends ZodObject<ZodRawShape>>(obj: T, schema: S): Partial<T>;
50
46
  export {};
51
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zY2hlbWFzL3V0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFFTCxLQUFLLFVBQVUsRUFDZixLQUFLLGVBQWUsRUFFcEIsS0FBSyxTQUFTLEVBQ2QsV0FBVyxFQUVYLEtBQUssV0FBVyxFQUNoQixLQUFLLE9BQU8sRUFDWixLQUFLLFVBQVUsRUFDZixDQUFDLEVBQ0YsTUFBTSxLQUFLLENBQUM7QUFJYixPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFekMsZUFBTyxNQUFNLFNBQVMseUVBQWlGLENBQUM7QUFLeEcsNkVBQTZFO0FBQzdFLGVBQU8sTUFBTSxZQUFZLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FpQnRDLENBQUM7QUFFSCxxQkFBYSxtQkFBbUIsQ0FBQyxDQUFDLFNBQVMsVUFBVSxDQUFFLFNBQVEsV0FBVyxDQUFDLENBQUMsQ0FBQztJQUMzRSxtQkFBbUIsVUFBUTtJQUVsQixNQUFNLENBQUMsS0FBSyxFQUFFLFVBQVUsR0FBRyxlQUFlLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBTW5FO0lBRUQsT0FBZ0IsTUFBTSxDQUFDLENBQUMsU0FBUyxVQUFVLEVBQUUsSUFBSSxFQUFFLENBQUMsR0FBRyxtQkFBbUIsQ0FBQyxDQUFDLENBQUMsQ0FLNUU7Q0FDRjtBQUVEOzs7O0dBSUc7QUFDSCx3QkFBZ0IsUUFBUSxDQUFDLENBQUMsU0FBUyxVQUFVLEVBQUUsTUFBTSxFQUFFLENBQUMsMEJBRXZEO0FBRUQsS0FBSyxRQUFRLENBQUMsQ0FBQyxFQUFFLElBQUksSUFBSSxDQUFDLFNBQVM7SUFBRSxNQUFNLElBQUksSUFBSSxDQUFBO0NBQUUsR0FBRyxDQUFDLEdBQUcsS0FBSyxDQUFDO0FBRWxFOzs7O0dBSUc7QUFDSCx3QkFBZ0IsWUFBWSxDQUFDLE1BQU0sU0FBUztJQUFFLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLEdBQUcsQ0FBQTtDQUFFLEdBQUc7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxHQUFHLENBQUE7Q0FBRSxFQUM3RyxLQUFLLEVBQUUsTUFBTSxFQUNiLFVBQVUsQ0FBQyxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sS0FBSyxPQUFPLEdBQ3RDLE9BQU8sQ0FDUixNQUFNLFNBQVM7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxNQUFNLFNBQVMsQ0FBQTtDQUFFLEdBQUc7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxNQUFNLFNBQVMsQ0FBQTtDQUFFLEdBQ3RHLFFBQVEsQ0FBQyxTQUFTLEVBQUUsTUFBTSxDQUFDLEdBQzNCLEtBQUssRUFDVCxHQUFHLEVBQ0gsTUFBTSxDQUNQLENBTUE7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLGVBQWUsQ0FBQyxNQUFNLFNBQVM7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxHQUFHLENBQUE7Q0FBRSxFQUM3RSxLQUFLLEVBQUUsTUFBTSxFQUNiLFVBQVUsQ0FBQyxFQUFFLENBQUMsR0FBRyxFQUFFLE1BQU0sS0FBSyxPQUFPLEdBQ3BDLE9BQU8sQ0FDUixNQUFNLFNBQVM7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxNQUFNLFNBQVMsQ0FBQTtDQUFFLEdBQUcsUUFBUSxDQUFDLFNBQVMsRUFBRSxNQUFNLENBQUMsR0FBRyxLQUFLLEVBQ2pHLEdBQUcsRUFDSCxNQUFNLENBQ1AsQ0FFQTtBQUVELCtGQUErRjtBQUMvRix3QkFBZ0IsU0FBUyxDQUFDLElBQUksRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLE1BQU0sQ0FBQyxJQUFJLENBQUMsRUFBRSxLQUFLLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxHQUFHLE1BQU0sQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBRTNHO0FBRUQsK0ZBQStGO0FBQy9GLHdCQUFnQixTQUFTLENBQUMsQ0FBQyxFQUFFLEtBQUssRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUU3RDtBQUVELDRIQUE0SDtBQUM1SCx3QkFBZ0IsY0FBYyxDQUFDLENBQUMsU0FBUyxNQUFNLEVBQUUsQ0FBQyxTQUFTLFNBQVMsQ0FBQyxXQUFXLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxFQUFFLE1BQU0sRUFBRSxDQUFDLGNBRW5HIn0=
47
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zY2hlbWFzL3V0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLFNBQVMsRUFBRSxLQUFLLFdBQVcsRUFBRSxLQUFLLE9BQU8sRUFBRSxLQUFLLFVBQVUsRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFJekYsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRXpDLGVBQU8sTUFBTSxTQUFTLHdEQUFpRixDQUFDO0FBS3hHLDZFQUE2RTtBQUM3RSxlQUFPLE1BQU0sWUFBWSxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBaUJ0QyxDQUFDO0FBRUgsTUFBTSxNQUFNLG1CQUFtQixDQUFDLENBQUMsU0FBUyxVQUFVLElBQUksT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEdBQUcsU0FBUyxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxHQUFHLFNBQVMsQ0FBQyxDQUFDO0FBRXhIOzs7O0dBSUc7QUFDSCx3QkFBZ0IsUUFBUSxDQUFDLENBQUMsU0FBUyxVQUFVLEVBQUUsTUFBTSxFQUFFLENBQUMsNklBRXZEO0FBRUQsS0FBSyxRQUFRLENBQUMsQ0FBQyxFQUFFLElBQUksSUFBSSxDQUFDLFNBQVM7SUFBRSxNQUFNLElBQUksSUFBSSxDQUFBO0NBQUUsR0FBRyxDQUFDLEdBQUcsS0FBSyxDQUFDO0FBRWxFOzs7O0dBSUc7QUFDSCx3QkFBZ0IsWUFBWSxDQUFDLE1BQU0sU0FBUztJQUFFLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLEdBQUcsQ0FBQTtDQUFFLEdBQUc7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxHQUFHLENBQUE7Q0FBRSxFQUM3RyxLQUFLLEVBQUUsTUFBTSxFQUNiLFVBQVUsQ0FBQyxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sS0FBSyxPQUFPLEdBQ3RDLE9BQU8sQ0FDUixNQUFNLFNBQVM7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxNQUFNLFNBQVMsQ0FBQTtDQUFFLEdBQUc7SUFBRSxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxNQUFNLFNBQVMsQ0FBQTtDQUFFLEdBQ3RHLFFBQVEsQ0FBQyxTQUFTLEVBQUUsTUFBTSxDQUFDLEdBQzNCLEtBQUssRUFDVCxNQUFNLENBQ1AsQ0FNQTtBQUVEOzs7O0dBSUc7QUFDSCx3QkFBZ0IsZUFBZSxDQUFDLE1BQU0sU0FBUztJQUFFLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLEdBQUcsQ0FBQTtDQUFFLEVBQzdFLEtBQUssRUFBRSxNQUFNLEVBQ2IsVUFBVSxDQUFDLEVBQUUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxLQUFLLE9BQU8sR0FDcEMsT0FBTyxDQUFDLE1BQU0sU0FBUztJQUFFLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLE1BQU0sU0FBUyxDQUFBO0NBQUUsR0FBRyxRQUFRLENBQUMsU0FBUyxFQUFFLE1BQU0sQ0FBQyxHQUFHLEtBQUssRUFBRSxNQUFNLENBQUMsQ0FFcEg7QUFFRCwrRkFBK0Y7QUFDL0Ysd0JBQWdCLFNBQVMsQ0FBQyxJQUFJLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUUsS0FBSyxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsR0FBRyxNQUFNLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUUzRztBQUVELCtGQUErRjtBQUMvRix3QkFBZ0IsU0FBUyxDQUFDLENBQUMsRUFBRSxLQUFLLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQyxHQUFHLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FFN0Q7QUFFRCw0SEFBNEg7QUFDNUgsd0JBQWdCLGNBQWMsQ0FBQyxDQUFDLFNBQVMsTUFBTSxFQUFFLENBQUMsU0FBUyxTQUFTLENBQUMsV0FBVyxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQyxjQUVuRyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/schemas/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,eAAe,EAEpB,KAAK,SAAS,EACd,WAAW,EAEX,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,CAAC,EACF,MAAM,KAAK,CAAC;AAIb,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,SAAS,yEAAiF,CAAC;AAKxG,6EAA6E;AAC7E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,CAiBtC,CAAC;AAEH,qBAAa,mBAAmB,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC3E,mBAAmB,UAAQ;IAElB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAMnE;IAED,OAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAK5E;CACF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,0BAEvD;AAED,KAAK,QAAQ,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,SAAS;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC7G,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GACtC,OAAO,CACR,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,SAAS,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,SAAS,CAAA;CAAE,GACtG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAC3B,KAAK,EACT,GAAG,EACH,MAAM,CACP,CAMA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC7E,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GACpC,OAAO,CACR,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,SAAS,CAAA;CAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,KAAK,EACjG,GAAG,EACH,MAAM,CACP,CAEA;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAE3G;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAE7D;AAED,4HAA4H;AAC5H,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,cAEnG"}
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/schemas/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIzF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,SAAS,wDAAiF,CAAC;AAKxG,6EAA6E;AAC7E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,CAiBtC,CAAC;AAEH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAExH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,6IAEvD;AAED,KAAK,QAAQ,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,SAAS;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC7G,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GACtC,OAAO,CACR,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,SAAS,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,SAAS,CAAA;CAAE,GACtG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAC3B,KAAK,EACT,MAAM,CACP,CAMA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC7E,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GACpC,OAAO,CAAC,MAAM,SAAS;IAAE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,SAAS,CAAA;CAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC,CAEpH;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAE3G;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAE7D;AAED,4HAA4H;AAC5H,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,cAEnG"}
@@ -1,4 +1,4 @@
1
- import { OK, ZodFirstPartyTypeKind, ZodOptional, ZodParsedType, z } from 'zod';
1
+ import { z } from 'zod';
2
2
  import { pick } from '../collection/object.js';
3
3
  import { isHex, withoutHexPrefix } from '../string/index.js';
4
4
  export const hexSchema = z.string().refine(isHex, 'Not a valid hex string').transform(withoutHexPrefix);
@@ -17,28 +17,12 @@ const base64Regex = /^([0-9a-zA-Z+/]{4})*(([0-9a-zA-Z+/]{2}==)|([0-9a-zA-Z+/]{3}
17
17
  // Serialization from Buffer
18
18
  z.instanceof(Buffer)
19
19
  ]);
20
- export class ZodNullableOptional extends ZodOptional {
21
- _isNullableOptional = true;
22
- _parse(input) {
23
- const parsedType = this._getType(input);
24
- if (parsedType === ZodParsedType.undefined || parsedType === ZodParsedType.null) {
25
- return OK(undefined);
26
- }
27
- return this._def.innerType._parse(input);
28
- }
29
- static create(type) {
30
- return new ZodNullableOptional({
31
- innerType: type,
32
- typeName: ZodFirstPartyTypeKind.ZodOptional
33
- });
34
- }
35
- }
36
20
  /**
37
21
  * Declares a parameter as optional. Use this over z.optional in order to accept nulls as undefineds.
38
22
  * This is required as JSON does not have an undefined type, and null is used to represent it, so we
39
23
  * need to convert nulls to undefineds as we parse.
40
24
  */ export function optional(schema) {
41
- return ZodNullableOptional.create(schema);
25
+ return schema.nullish().transform((value)=>value ?? undefined);
42
26
  }
43
27
  /**
44
28
  * Creates a schema that accepts a hex string and uses it to hydrate an instance.
@@ -271,4 +271,4 @@ export interface FromBuffer<T> {
271
271
  */
272
272
  fromBuffer(buffer: Buffer): T;
273
273
  }
274
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyX3JlYWRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcmlhbGl6ZS9idWZmZXJfcmVhZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV4Qzs7Ozs7Ozs7Ozs7Ozs7OztHQWdCRztBQUNILHFCQUFhLFlBQVk7O0lBR3JCLE9BQU8sQ0FBQyxNQUFNO0lBRmhCLE9BQU8sQ0FBQyxLQUFLLENBQVM7SUFDdEIsWUFDVSxNQUFNLEVBQUUsTUFBTSxFQUN0QixNQUFNLFNBQUksRUFHWDtJQUVEOzs7Ozs7O09BT0c7SUFDSCxPQUFjLFFBQVEsQ0FBQyxjQUFjLEVBQUUsVUFBVSxHQUFHLE1BQU0sR0FBRyxZQUFZLEdBQUcsWUFBWSxDQVV2RjtJQUVELDBFQUEwRTtJQUNuRSxPQUFPLElBQUksT0FBTyxDQUV4QjtJQUVEOzs7OztPQUtHO0lBQ0ksVUFBVSxJQUFJLE1BQU0sQ0FJMUI7SUFFRDs7OztPQUlHO0lBQ0ksV0FBVyxDQUFDLENBQUMsU0FBUyxNQUFNLEVBQUUsS0FBSyxFQUFFLENBQUMsR0FBRyxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUcvRDtJQUVEOzs7Ozs7O09BT0c7SUFDSSxVQUFVLElBQUksTUFBTSxDQU8xQjtJQUVEOzs7Ozs7O09BT0c7SUFDSSxXQUFXLElBQUksTUFBTSxDQVUzQjtJQUVEOzs7Ozs7O09BT0c7SUFDSSxXQUFXLElBQUksTUFBTSxDQVUzQjtJQUVEOzs7OztPQUtHO0lBQ0ksVUFBVSxJQUFJLE1BQU0sQ0FNMUI7SUFFRCw0QkFBNEI7SUFDckIsVUFBVSxJQUFJLE1BQU0sQ0FFMUI7SUFFRDs7Ozs7T0FLRztJQUNJLFVBQVUsSUFBSSxNQUFNLENBSTFCO0lBRUQ7Ozs7O09BS0c7SUFDSSxTQUFTLElBQUksTUFBTSxDQUl6QjtJQUVEOzs7Ozs7T0FNRztJQUNJLFdBQVcsSUFBSSxPQUFPLENBSTVCO0lBRUQ7Ozs7Ozs7T0FPRztJQUNJLFNBQVMsQ0FBQyxDQUFDLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FJbEM7SUFFRCx5Q0FBeUM7SUFDbEMsU0FBUyxJQUFJLE1BQU0sQ0FJekI7SUFFRDs7Ozs7T0FLRztJQUNJLGdCQUFnQixJQUFJLE1BQU0sRUFBRSxDQUlsQztJQUVEOzs7OztPQUtHO0lBQ0ksaUJBQWlCLElBQUksTUFBTSxFQUFFLENBSW5DO0lBRUQ7Ozs7Ozs7OztPQVNHO0lBQ0ksVUFBVSxDQUFDLENBQUMsRUFDakIsZ0JBQWdCLEVBQUU7UUFDaEI7O1dBRUc7UUFDSCxVQUFVLEVBQUUsQ0FBQyxNQUFNLEVBQUUsWUFBWSxLQUFLLENBQUMsQ0FBQztLQUN6QyxFQUNELE9BQU8sQ0FBQyxFQUFFLE1BQU0sR0FDZixDQUFDLEVBQUUsQ0FVTDtJQUVEOzs7Ozs7OztPQVFHO0lBQ0kscUJBQXFCLENBQUMsQ0FBQyxFQUFFLGdCQUFnQixFQUFFO1FBQ2hEOztXQUVHO1FBQ0gsVUFBVSxFQUFFLENBQUMsTUFBTSxFQUFFLFlBQVksS0FBSyxDQUFDLENBQUM7S0FDekMsR0FBRyxDQUFDLEVBQUUsQ0FPTjtJQUVEOzs7Ozs7Ozs7T0FTRztJQUNJLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxTQUFTLE1BQU0sRUFDbEMsSUFBSSxFQUFFLENBQUMsRUFDUCxnQkFBZ0IsRUFBRTtRQUNoQjs7V0FFRztRQUNILFVBQVUsRUFBRSxDQUFDLE1BQU0sRUFBRSxZQUFZLEtBQUssQ0FBQyxDQUFDO0tBQ3pDLEdBQ0EsS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FHYjtJQUVEOzs7Ozs7O09BT0c7SUFDSSxlQUFlLENBQUMsSUFBSSxTQUFLLEdBQUcsTUFBTSxFQUFFLENBZTFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0ksVUFBVSxDQUFDLENBQUMsRUFBRSxZQUFZLEVBQUU7UUFDakM7O1dBRUc7UUFDSCxVQUFVLEVBQUUsQ0FBQyxNQUFNLEVBQUUsWUFBWSxLQUFLLENBQUMsQ0FBQztLQUN6QyxHQUFHLENBQUMsQ0FFSjtJQUVEOzs7Ozs7T0FNRztJQUNJLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQUduQztJQUVEOzs7Ozs7O09BT0c7SUFDSSxVQUFVLENBQUMsT0FBTyxDQUFDLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FFMUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNJLFVBQVUsQ0FBQyxPQUFPLENBQUMsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQU8xQztJQUVEOzs7Ozs7O09BT0c7SUFDSSxjQUFjLElBQUksVUFBVSxDQUlsQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksT0FBTyxDQUFDLENBQUMsRUFBRSxZQUFZLEVBQUU7UUFDOUI7O1dBRUc7UUFDSCxVQUFVLEVBQUUsQ0FBQyxNQUFNLEVBQUUsWUFBWSxLQUFLLENBQUMsQ0FBQztLQUN6QyxHQUFHO1FBQUUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLENBQUMsQ0FBQTtLQUFFLENBU3ZCO0lBRUQ7OztPQUdHO0lBQ0ksU0FBUyxJQUFJLE1BQU0sQ0FFekI7SUFFRDs7O09BR0c7SUFDSSxjQUFjLElBQUksTUFBTSxDQUU5QjtDQVNGO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsVUFBVSxDQUFDLENBQUM7SUFDM0I7OztPQUdHO0lBQ0gsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsQ0FBQyxDQUFDO0NBQy9CIn0=
274
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyX3JlYWRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcmlhbGl6ZS9idWZmZXJfcmVhZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV4Qzs7Ozs7Ozs7Ozs7Ozs7OztHQWdCRztBQUNILHFCQUFhLFlBQVk7O0lBR3JCLE9BQU8sQ0FBQyxNQUFNO0lBRmhCLE9BQU8sQ0FBQyxLQUFLLENBQVM7SUFDdEIsWUFDVSxNQUFNLEVBQUUsTUFBTSxFQUN0QixNQUFNLFNBQUksRUFHWDtJQUVEOzs7Ozs7O09BT0c7SUFDSCxPQUFjLFFBQVEsQ0FBQyxjQUFjLEVBQUUsVUFBVSxHQUFHLE1BQU0sR0FBRyxZQUFZLEdBQUcsWUFBWSxDQVV2RjtJQUVELDBFQUEwRTtJQUNuRSxPQUFPLElBQUksT0FBTyxDQUV4QjtJQUVEOzs7OztPQUtHO0lBQ0ksVUFBVSxJQUFJLE1BQU0sQ0FJMUI7SUFFRDs7OztPQUlHO0lBQ0ksV0FBVyxDQUFDLENBQUMsU0FBUyxNQUFNLEVBQUUsS0FBSyxFQUFFLENBQUMsR0FBRyxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUcvRDtJQUVEOzs7Ozs7O09BT0c7SUFDSSxVQUFVLElBQUksTUFBTSxDQU8xQjtJQUVEOzs7Ozs7O09BT0c7SUFDSSxXQUFXLElBQUksTUFBTSxDQVUzQjtJQUVEOzs7Ozs7O09BT0c7SUFDSSxXQUFXLElBQUksTUFBTSxDQVUzQjtJQUVEOzs7OztPQUtHO0lBQ0ksVUFBVSxJQUFJLE1BQU0sQ0FNMUI7SUFFRCw0QkFBNEI7SUFDckIsVUFBVSxJQUFJLE1BQU0sQ0FFMUI7SUFFRDs7Ozs7T0FLRztJQUNJLFVBQVUsSUFBSSxNQUFNLENBSTFCO0lBRUQ7Ozs7O09BS0c7SUFDSSxTQUFTLElBQUksTUFBTSxDQUl6QjtJQUVEOzs7Ozs7T0FNRztJQUNJLFdBQVcsSUFBSSxP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
@@ -1 +1 @@
1
- {"version":3,"file":"buffer_reader.d.ts","sourceRoot":"","sources":["../../src/serialize/buffer_reader.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"buffer_reader.d.ts","sourceRoot":"","sources":["../../src/serialize/buffer_reader.ts"],"names":[],"mappings":"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"}
@@ -201,6 +201,11 @@ import { toBigIntBE } from '../bigint-buffer/index.js';
201
201
  if (maxSize !== undefined && size > maxSize) {
202
202
  throw new Error(`Vector size ${size} exceeds maximum allowed ${maxSize}`);
203
203
  }
204
+ // Every element consumes at least one byte, so a size beyond the bytes left is unsatisfiable. Reject it
205
+ // up front rather than relying on each item deserializer to bounds-check as the loop runs out of input.
206
+ if (size > this.remainingBytes()) {
207
+ throw new Error(`Vector size ${size} exceeds remaining buffer length ${this.remainingBytes()}`);
208
+ }
204
209
  const result = new Array(size);
205
210
  for(let i = 0; i < size; i++){
206
211
  result[i] = itemDeserializer.fromBuffer(this);
@@ -0,0 +1,134 @@
1
+ /**
2
+ * A value that can be appended to a {@link BufferSink}. Mirrors `Bufferable`, but the object arm allows the
3
+ * optional-sink overload of `toBuffer` so a legacy `toBuffer(): Buffer` and a migrated `toBuffer(sink?)` both fit.
4
+ */
5
+ export type Sinkable = boolean | Buffer | Uint8Array | number | bigint | string | {
6
+ toBuffer(sink?: BufferSink): Buffer | void;
7
+ } | Sinkable[];
8
+ /**
9
+ * A growable, append-only binary sink backed by a single `ArrayBuffer`.
10
+ *
11
+ * It exists to replace the recursive `toBuffer()` chain — which allocates a `Buffer` at every node and
12
+ * `Buffer.concat`s at every level — with one buffer that the whole object graph streams into and that is sliced
13
+ * exactly once at the root. Encodings are big-endian, matching `serializeToBuffer` byte-for-byte.
14
+ *
15
+ * The migration contract is the optional-sink `toBuffer`:
16
+ *
17
+ * ```ts
18
+ * toBuffer(): Buffer;
19
+ * toBuffer(sink: BufferSink): void;
20
+ * toBuffer(sink?: BufferSink): Buffer | void {
21
+ * if (!sink) return BufferSink.serialize(this); // own a sink, fill it, slice once
22
+ * serializeToSink(sink, this.a, this.b, this.c); // stream into the caller's sink
23
+ * }
24
+ * ```
25
+ *
26
+ * When a sink is passed it writes and returns `undefined`; otherwise it returns its own buffer. Nodes that have
27
+ * not been migrated keep their plain `toBuffer(): Buffer` and are folded in via the return-value fallback in
28
+ * {@link serializeToSink}, so the tree stays valid at every step of an incremental migration.
29
+ *
30
+ * Performance note: bigints are written via `DataView.setBigUint64` limbs ({@link writeBigInt},
31
+ * {@link writeField}), NOT a per-byte shift loop. The limb form is ~16x faster than the legacy hex round-trip
32
+ * on field-heavy structures, and faster than the legacy path at every width — a naive per-byte shift loop is
33
+ * actually the slowest option, since each byte allocates a fresh BigInt. See the spike benchmark.
34
+ */
35
+ export declare class BufferSink {
36
+ private buffer;
37
+ private view;
38
+ private offset;
39
+ constructor(initialCapacity?: number);
40
+ /** Number of bytes written so far. */
41
+ get length(): number;
42
+ /**
43
+ * Serialize a migrated value into a fresh sink and return the single resulting buffer. This is the no-sink
44
+ * branch of every migrated `toBuffer`: one allocation, one slice, only at the root.
45
+ *
46
+ * @param obj - The value to serialize via its sink-aware `toBuffer`.
47
+ * @param initialCapacity - Optional size hint (e.g. from `getSize()`) to skip reallocations on hot paths.
48
+ */
49
+ static serialize(obj: {
50
+ toBuffer(sink: BufferSink): void;
51
+ }, initialCapacity?: number): Buffer;
52
+ private ensure;
53
+ /** Append a single byte (0/1) for a boolean, matching `boolToBuffer`. */
54
+ writeBool(value: boolean): void;
55
+ /** Append an unsigned 8-bit integer. */
56
+ writeUInt8(value: number): void;
57
+ /** Append a big-endian unsigned 16-bit integer. */
58
+ writeUInt16(value: number): void;
59
+ /** Append a big-endian unsigned 32-bit integer, matching `numToUInt32BE`. */
60
+ writeNumber(value: number): void;
61
+ /** Append a big-endian unsigned 64-bit integer, matching `bigintToUInt64BE`. */
62
+ writeUInt64(value: bigint): void;
63
+ /**
64
+ * Append a non-negative bigint as a big-endian unsigned integer of `width` bytes (default 32), matching
65
+ * `serializeBigInt` / `toBufferBE`. Every width is written limb-wise via `setBigUint64` rather than the
66
+ * legacy per-byte BigInt shift loop — that loop allocated a fresh BigInt per byte and benchmarked as the
67
+ * *slowest* option (slower even than the legacy hex round-trip); the limb form is faster at every width.
68
+ *
69
+ * The bulk of the value is written as 64-bit big-endian limbs from the least-significant tail upward, and
70
+ * a final `width % 8` (at most 7) high bytes that don't fill a whole limb are written individually. The
71
+ * common widths (8/16/32) are exact multiples of 8, so they take the pure-limb path with no remainder.
72
+ * `width === 32` keeps its own straight-line four-limb form (shared with {@link writeField}) since it is
73
+ * the `Fr`/`Fq`/Chonk-proof hot path and the unrolled body is marginally faster than the loop.
74
+ *
75
+ * @param value - The non-negative bigint to serialize.
76
+ * @param width - Output width in bytes.
77
+ */
78
+ writeBigInt(value: bigint, width?: number): void;
79
+ /**
80
+ * Append a 32-byte (256-bit) big-endian non-negative bigint. Specialized form of {@link writeBigInt}
81
+ * with no width parameter and no width-branch, so V8 can inline the four `setBigUint64` limb writes
82
+ * without the wider branchy form's instability. This is the Fr/Fq leaf hot path; prefer it over
83
+ * `writeBigInt(value, 32)` in callers that always serialize 32-byte fields.
84
+ */
85
+ writeField(value: bigint): void;
86
+ /**
87
+ * Append an array of field elements (or any objects exposing `toBigInt(): bigint`) as a contiguous
88
+ * sequence of 32-byte big-endian limbs. Iterates inline — no per-element `toBuffer` dispatch and no
89
+ * per-element function-call indirection through the generic sinkable dispatcher. Use this in classes
90
+ * that hold large flat field arrays (e.g. the 1632-element ChonkProof field list).
91
+ */
92
+ writeFields(fields: ReadonlyArray<{
93
+ toBigInt(): bigint;
94
+ }>): void;
95
+ /** Append raw bytes verbatim (no length prefix), matching how a `Buffer`/`Uint8Array` is serialized inline. */
96
+ writeBytes(bytes: Uint8Array): void;
97
+ /** Append a string as a 4-byte big-endian length prefix followed by its UTF-8 bytes, matching the string case. */
98
+ writeString(value: string): void;
99
+ /**
100
+ * Reset the write cursor without releasing the backing buffer. Lets the same sink be reused across many
101
+ * serializations without reallocating — the per-call cost drops to the bytes written (no `new ArrayBuffer`).
102
+ * Any `Buffer` previously returned by {@link toBuffer} is a fresh copy and remains valid; any view from
103
+ * {@link asUint8Array} aliases the buffer and is invalidated.
104
+ */
105
+ reset(): void;
106
+ /** Copy the written region into a freshly allocated `Buffer`. The single allocation of the whole serialization. */
107
+ toBuffer(): Buffer;
108
+ /** A zero-copy view of the written region. Valid only until the next write (which may reallocate). */
109
+ asUint8Array(): Uint8Array;
110
+ }
111
+ /**
112
+ * Streaming counterpart to `serializeToBufferArray`: walk a list of {@link Sinkable}s and append each to the sink.
113
+ * Dispatch matches `serializeToBufferArray` byte-for-byte. An object is serialized via `obj.toBuffer(sink)`; a
114
+ * migrated node writes into the sink and returns `undefined`, while a not-yet-migrated node ignores the argument
115
+ * and returns its `Buffer`, which we copy in. That return-value fallback is what makes the migration incremental.
116
+ *
117
+ * Dispatch is hot-pathed for the common case of objects exposing `toBuffer` (Fr/Fq and every other migrated leaf),
118
+ * and arrays recurse via an inner-array helper to avoid the per-call rest-args allocation that a spread-recurse
119
+ * would force on large flat arrays like the 1632-element ChonkProof field list.
120
+ *
121
+ * @param sink - The destination sink.
122
+ * @param objs - The values to serialize, in order.
123
+ */
124
+ export declare function serializeToSink(sink: BufferSink, ...objs: Sinkable[]): void;
125
+ /**
126
+ * Streaming counterpart to `serializeArrayOfBufferableToVector`: write a length prefix (1 or 4 bytes) giving the
127
+ * number of serialized elements, then each element. Byte-identical to the buffer version.
128
+ *
129
+ * @param sink - The destination sink.
130
+ * @param objs - The vector elements.
131
+ * @param prefixLength - Width of the count prefix in bytes (1 or 4).
132
+ */
133
+ export declare function serializeArrayToSink(sink: BufferSink, objs: Sinkable[], prefixLength?: number): void;
134
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyX3NpbmsuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJpYWxpemUvYnVmZmVyX3NpbmsudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBQ0gsTUFBTSxNQUFNLFFBQVEsR0FDaEIsT0FBTyxHQUNQLE1BQU0sR0FDTixVQUFVLEdBQ1YsTUFBTSxHQUNOLE1BQU0sR0FDTixNQUFNLEdBQ047SUFBRSxRQUFRLENBQUMsSUFBSSxDQUFDLEVBQUUsVUFBVSxHQUFHLE1BQU0sR0FBRyxJQUFJLENBQUE7Q0FBRSxHQUM5QyxRQUFRLEVBQUUsQ0FBQztBQUtmOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQTBCRztBQUNILHFCQUFhLFVBQVU7SUFDckIsT0FBTyxDQUFDLE1BQU0sQ0FBYTtJQUMzQixPQUFPLENBQUMsSUFBSSxDQUFXO0lBQ3ZCLE9BQU8sQ0FBQyxNQUFNLENBQUs7SUFFbkIsWUFBWSxlQUFlLEdBQUUsTUFBaUMsRUFJN0Q7SUFFRCxzQ0FBc0M7SUFDdEMsSUFBVyxNQUFNLElBQUksTUFBTSxDQUUxQjtJQUVEOzs7Ozs7T0FNRztJQUNILE9BQWMsU0FBUyxDQUFDLEdBQUcsRUFBRTtRQUFFLFFBQVEsQ0FBQyxJQUFJLEVBQUUsVUFBVSxHQUFHLElBQUksQ0FBQTtLQUFFLEVBQUUsZUFBZSxDQUFDLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FJbkc7SUFFRCxPQUFPLENBQUMsTUFBTTtJQWVkLHlFQUF5RTtJQUNsRSxTQUFTLENBQUMsS0FBSyxFQUFFLE9BQU8sR0FBRyxJQUFJLENBR3JDO0lBRUQsd0NBQXdDO0lBQ2pDLFVBQVUsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLElBQUksQ0FHckM7SUFFRCxtREFBbUQ7SUFDNUMsV0FBVyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsSUFBSSxDQUl0QztJQUVELDZFQUE2RTtJQUN0RSxXQUFXLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxJQUFJLENBSXRDO0lBRUQsZ0ZBQWdGO0lBQ3pFLFdBQVcsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLElBQUksQ0FJdEM7SUFFRDs7Ozs7Ozs7Ozs7Ozs7T0FjRztJQUNJLFdBQVcsQ0FBQyxLQUFLLEVBQUUsTUFBTSxFQUFFLEtBQUssU0FBSyxHQUFHLElBQUksQ0FxQ2xEO0lBRUQ7Ozs7O09BS0c7SUFDSSxVQUFVLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxJQUFJLENBa0JyQztJQUVEOzs7OztPQUtHO0lBQ0ksV0FBVyxDQUFDLE1BQU0sRUFBRSxhQUFhLENBQUM7UUFBRSxRQUFRLElBQUksTUFBTSxDQUFBO0tBQUUsQ0FBQyxHQUFHLElBQUksQ0FxQnRFO0lBRUQsK0dBQStHO0lBQ3hHLFVBQVUsQ0FBQyxLQUFLLEVBQUUsVUFBVSxHQUFHLElBQUksQ0FJekM7SUFFRCxrSEFBa0g7SUFDM0csV0FBVyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsSUFBSSxDQUl0QztJQUVEOzs7OztPQUtHO0lBQ0ksS0FBSyxJQUFJLElBQUksQ0FFbkI7SUFFRCxtSEFBbUg7SUFDNUcsUUFBUSxJQUFJLE1BQU0sQ0FFeEI7SUFFRCxzR0FBc0c7SUFDL0YsWUFBWSxJQUFJLFVBQVUsQ0FFaEM7Q0FDRjtBQUVEOzs7Ozs7Ozs7Ozs7R0FZRztBQUNILHdCQUFnQixlQUFlLENBQUMsSUFBSSxFQUFFLFVBQVUsRUFBRSxHQUFHLElBQUksRUFBRSxRQUFRLEVBQUUsR0FBRyxJQUFJLENBRTNFO0FBMENEOzs7Ozs7O0dBT0c7QUFDSCx3QkFBZ0Isb0JBQW9CLENBQUMsSUFBSSxFQUFFLFVBQVUsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLEVBQUUsWUFBWSxTQUFJLEdBQUcsSUFBSSxDQVUvRiJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"buffer_sink.d.ts","sourceRoot":"","sources":["../../src/serialize/buffer_sink.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9C,QAAQ,EAAE,CAAC;AAKf;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,MAAM,CAAK;IAEnB,YAAY,eAAe,GAAE,MAAiC,EAI7D;IAED,sCAAsC;IACtC,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;;;;;OAMG;IACH,OAAc,SAAS,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAInG;IAED,OAAO,CAAC,MAAM;IAed,yEAAyE;IAClE,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAGrC;IAED,wCAAwC;IACjC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGrC;IAED,mDAAmD;IAC5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAItC;IAED,6EAA6E;IACtE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAItC;IAED,gFAAgF;IACzE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAItC;IAED;;;;;;;;;;;;;;OAcG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,IAAI,CAqClD;IAED;;;;;OAKG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAkBrC;IAED;;;;;OAKG;IACI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAqBtE;IAED,+GAA+G;IACxG,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAIzC;IAED,kHAAkH;IAC3G,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAItC;IAED;;;;;OAKG;IACI,KAAK,IAAI,IAAI,CAEnB;IAED,mHAAmH;IAC5G,QAAQ,IAAI,MAAM,CAExB;IAED,sGAAsG;IAC/F,YAAY,IAAI,UAAU,CAEhC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAE3E;AA0CD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,SAAI,GAAG,IAAI,CAU/F"}
@@ -0,0 +1,297 @@
1
+ /**
2
+ * A value that can be appended to a {@link BufferSink}. Mirrors `Bufferable`, but the object arm allows the
3
+ * optional-sink overload of `toBuffer` so a legacy `toBuffer(): Buffer` and a migrated `toBuffer(sink?)` both fit.
4
+ */ const DEFAULT_INITIAL_CAPACITY = 1024;
5
+ const MASK_64 = (1n << 64n) - 1n;
6
+ /**
7
+ * A growable, append-only binary sink backed by a single `ArrayBuffer`.
8
+ *
9
+ * It exists to replace the recursive `toBuffer()` chain — which allocates a `Buffer` at every node and
10
+ * `Buffer.concat`s at every level — with one buffer that the whole object graph streams into and that is sliced
11
+ * exactly once at the root. Encodings are big-endian, matching `serializeToBuffer` byte-for-byte.
12
+ *
13
+ * The migration contract is the optional-sink `toBuffer`:
14
+ *
15
+ * ```ts
16
+ * toBuffer(): Buffer;
17
+ * toBuffer(sink: BufferSink): void;
18
+ * toBuffer(sink?: BufferSink): Buffer | void {
19
+ * if (!sink) return BufferSink.serialize(this); // own a sink, fill it, slice once
20
+ * serializeToSink(sink, this.a, this.b, this.c); // stream into the caller's sink
21
+ * }
22
+ * ```
23
+ *
24
+ * When a sink is passed it writes and returns `undefined`; otherwise it returns its own buffer. Nodes that have
25
+ * not been migrated keep their plain `toBuffer(): Buffer` and are folded in via the return-value fallback in
26
+ * {@link serializeToSink}, so the tree stays valid at every step of an incremental migration.
27
+ *
28
+ * Performance note: bigints are written via `DataView.setBigUint64` limbs ({@link writeBigInt},
29
+ * {@link writeField}), NOT a per-byte shift loop. The limb form is ~16x faster than the legacy hex round-trip
30
+ * on field-heavy structures, and faster than the legacy path at every width — a naive per-byte shift loop is
31
+ * actually the slowest option, since each byte allocates a fresh BigInt. See the spike benchmark.
32
+ */ export class BufferSink {
33
+ buffer;
34
+ view;
35
+ offset = 0;
36
+ constructor(initialCapacity = DEFAULT_INITIAL_CAPACITY){
37
+ const ab = new ArrayBuffer(initialCapacity);
38
+ this.buffer = new Uint8Array(ab);
39
+ this.view = new DataView(ab);
40
+ }
41
+ /** Number of bytes written so far. */ get length() {
42
+ return this.offset;
43
+ }
44
+ /**
45
+ * Serialize a migrated value into a fresh sink and return the single resulting buffer. This is the no-sink
46
+ * branch of every migrated `toBuffer`: one allocation, one slice, only at the root.
47
+ *
48
+ * @param obj - The value to serialize via its sink-aware `toBuffer`.
49
+ * @param initialCapacity - Optional size hint (e.g. from `getSize()`) to skip reallocations on hot paths.
50
+ */ static serialize(obj, initialCapacity) {
51
+ const sink = new BufferSink(initialCapacity);
52
+ obj.toBuffer(sink);
53
+ return sink.toBuffer();
54
+ }
55
+ ensure(extra) {
56
+ const required = this.offset + extra;
57
+ if (required <= this.buffer.length) {
58
+ return;
59
+ }
60
+ let next = this.buffer.length * 2;
61
+ while(next < required){
62
+ next *= 2;
63
+ }
64
+ const grown = new Uint8Array(next);
65
+ grown.set(this.buffer.subarray(0, this.offset));
66
+ this.buffer = grown;
67
+ this.view = new DataView(grown.buffer);
68
+ }
69
+ /** Append a single byte (0/1) for a boolean, matching `boolToBuffer`. */ writeBool(value) {
70
+ this.ensure(1);
71
+ this.buffer[this.offset++] = value ? 1 : 0;
72
+ }
73
+ /** Append an unsigned 8-bit integer. */ writeUInt8(value) {
74
+ this.ensure(1);
75
+ this.buffer[this.offset++] = value & 0xff;
76
+ }
77
+ /** Append a big-endian unsigned 16-bit integer. */ writeUInt16(value) {
78
+ this.ensure(2);
79
+ this.view.setUint16(this.offset, value, false);
80
+ this.offset += 2;
81
+ }
82
+ /** Append a big-endian unsigned 32-bit integer, matching `numToUInt32BE`. */ writeNumber(value) {
83
+ this.ensure(4);
84
+ this.view.setUint32(this.offset, value, false);
85
+ this.offset += 4;
86
+ }
87
+ /** Append a big-endian unsigned 64-bit integer, matching `bigintToUInt64BE`. */ writeUInt64(value) {
88
+ this.ensure(8);
89
+ this.view.setBigUint64(this.offset, value, false);
90
+ this.offset += 8;
91
+ }
92
+ /**
93
+ * Append a non-negative bigint as a big-endian unsigned integer of `width` bytes (default 32), matching
94
+ * `serializeBigInt` / `toBufferBE`. Every width is written limb-wise via `setBigUint64` rather than the
95
+ * legacy per-byte BigInt shift loop — that loop allocated a fresh BigInt per byte and benchmarked as the
96
+ * *slowest* option (slower even than the legacy hex round-trip); the limb form is faster at every width.
97
+ *
98
+ * The bulk of the value is written as 64-bit big-endian limbs from the least-significant tail upward, and
99
+ * a final `width % 8` (at most 7) high bytes that don't fill a whole limb are written individually. The
100
+ * common widths (8/16/32) are exact multiples of 8, so they take the pure-limb path with no remainder.
101
+ * `width === 32` keeps its own straight-line four-limb form (shared with {@link writeField}) since it is
102
+ * the `Fr`/`Fq`/Chonk-proof hot path and the unrolled body is marginally faster than the loop.
103
+ *
104
+ * @param value - The non-negative bigint to serialize.
105
+ * @param width - Output width in bytes.
106
+ */ writeBigInt(value, width = 32) {
107
+ if (value < 0n) {
108
+ throw new Error(`Cannot serialize negative bigint ${value}`);
109
+ }
110
+ this.ensure(width);
111
+ const o = this.offset;
112
+ if (width === 32) {
113
+ let x = value;
114
+ this.view.setBigUint64(o + 24, x & MASK_64, false);
115
+ x >>= 64n;
116
+ this.view.setBigUint64(o + 16, x & MASK_64, false);
117
+ x >>= 64n;
118
+ this.view.setBigUint64(o + 8, x & MASK_64, false);
119
+ x >>= 64n;
120
+ this.view.setBigUint64(o, x & MASK_64, false);
121
+ x >>= 64n;
122
+ if (x !== 0n) {
123
+ throw new Error(`BigInt ${value} does not fit into 32 bytes`);
124
+ }
125
+ this.offset += 32;
126
+ return;
127
+ }
128
+ let x = value;
129
+ let pos = o + width;
130
+ while(pos - 8 >= o){
131
+ pos -= 8;
132
+ this.view.setBigUint64(pos, x & MASK_64, false);
133
+ x >>= 64n;
134
+ }
135
+ for(let i = pos - 1; i >= o; i--){
136
+ this.buffer[i] = Number(x & 0xffn);
137
+ x >>= 8n;
138
+ }
139
+ if (x !== 0n) {
140
+ throw new Error(`BigInt ${value} does not fit into ${width} bytes`);
141
+ }
142
+ this.offset += width;
143
+ }
144
+ /**
145
+ * Append a 32-byte (256-bit) big-endian non-negative bigint. Specialized form of {@link writeBigInt}
146
+ * with no width parameter and no width-branch, so V8 can inline the four `setBigUint64` limb writes
147
+ * without the wider branchy form's instability. This is the Fr/Fq leaf hot path; prefer it over
148
+ * `writeBigInt(value, 32)` in callers that always serialize 32-byte fields.
149
+ */ writeField(value) {
150
+ if (value < 0n) {
151
+ throw new Error(`Cannot serialize negative bigint ${value}`);
152
+ }
153
+ this.ensure(32);
154
+ const o = this.offset;
155
+ let x = value;
156
+ this.view.setBigUint64(o + 24, x & MASK_64, false);
157
+ x >>= 64n;
158
+ this.view.setBigUint64(o + 16, x & MASK_64, false);
159
+ x >>= 64n;
160
+ this.view.setBigUint64(o + 8, x & MASK_64, false);
161
+ x >>= 64n;
162
+ this.view.setBigUint64(o, x & MASK_64, false);
163
+ if (x >> 64n !== 0n) {
164
+ throw new Error(`BigInt ${value} does not fit into 32 bytes`);
165
+ }
166
+ this.offset = o + 32;
167
+ }
168
+ /**
169
+ * Append an array of field elements (or any objects exposing `toBigInt(): bigint`) as a contiguous
170
+ * sequence of 32-byte big-endian limbs. Iterates inline — no per-element `toBuffer` dispatch and no
171
+ * per-element function-call indirection through the generic sinkable dispatcher. Use this in classes
172
+ * that hold large flat field arrays (e.g. the 1632-element ChonkProof field list).
173
+ */ writeFields(fields) {
174
+ this.ensure(32 * fields.length);
175
+ for(let i = 0, n = fields.length; i < n; i++){
176
+ const value = fields[i].toBigInt();
177
+ if (value < 0n) {
178
+ throw new Error(`Cannot serialize negative bigint ${value}`);
179
+ }
180
+ const o = this.offset;
181
+ let x = value;
182
+ this.view.setBigUint64(o + 24, x & MASK_64, false);
183
+ x >>= 64n;
184
+ this.view.setBigUint64(o + 16, x & MASK_64, false);
185
+ x >>= 64n;
186
+ this.view.setBigUint64(o + 8, x & MASK_64, false);
187
+ x >>= 64n;
188
+ this.view.setBigUint64(o, x & MASK_64, false);
189
+ if (x >> 64n !== 0n) {
190
+ throw new Error(`BigInt ${value} does not fit into 32 bytes`);
191
+ }
192
+ this.offset = o + 32;
193
+ }
194
+ }
195
+ /** Append raw bytes verbatim (no length prefix), matching how a `Buffer`/`Uint8Array` is serialized inline. */ writeBytes(bytes) {
196
+ this.ensure(bytes.length);
197
+ this.buffer.set(bytes, this.offset);
198
+ this.offset += bytes.length;
199
+ }
200
+ /** Append a string as a 4-byte big-endian length prefix followed by its UTF-8 bytes, matching the string case. */ writeString(value) {
201
+ const bytes = Buffer.from(value);
202
+ this.writeNumber(bytes.length);
203
+ this.writeBytes(bytes);
204
+ }
205
+ /**
206
+ * Reset the write cursor without releasing the backing buffer. Lets the same sink be reused across many
207
+ * serializations without reallocating — the per-call cost drops to the bytes written (no `new ArrayBuffer`).
208
+ * Any `Buffer` previously returned by {@link toBuffer} is a fresh copy and remains valid; any view from
209
+ * {@link asUint8Array} aliases the buffer and is invalidated.
210
+ */ reset() {
211
+ this.offset = 0;
212
+ }
213
+ /** Copy the written region into a freshly allocated `Buffer`. The single allocation of the whole serialization. */ toBuffer() {
214
+ return Buffer.from(this.buffer.subarray(0, this.offset));
215
+ }
216
+ /** A zero-copy view of the written region. Valid only until the next write (which may reallocate). */ asUint8Array() {
217
+ return this.buffer.subarray(0, this.offset);
218
+ }
219
+ }
220
+ /**
221
+ * Streaming counterpart to `serializeToBufferArray`: walk a list of {@link Sinkable}s and append each to the sink.
222
+ * Dispatch matches `serializeToBufferArray` byte-for-byte. An object is serialized via `obj.toBuffer(sink)`; a
223
+ * migrated node writes into the sink and returns `undefined`, while a not-yet-migrated node ignores the argument
224
+ * and returns its `Buffer`, which we copy in. That return-value fallback is what makes the migration incremental.
225
+ *
226
+ * Dispatch is hot-pathed for the common case of objects exposing `toBuffer` (Fr/Fq and every other migrated leaf),
227
+ * and arrays recurse via an inner-array helper to avoid the per-call rest-args allocation that a spread-recurse
228
+ * would force on large flat arrays like the 1632-element ChonkProof field list.
229
+ *
230
+ * @param sink - The destination sink.
231
+ * @param objs - The values to serialize, in order.
232
+ */ export function serializeToSink(sink, ...objs) {
233
+ serializeArrayToSinkInner(sink, objs);
234
+ }
235
+ function serializeArrayToSinkInner(sink, objs) {
236
+ for(let i = 0, n = objs.length; i < n; i++){
237
+ serializeOneToSink(sink, objs[i]);
238
+ }
239
+ }
240
+ function serializeOneToSink(sink, obj) {
241
+ if (typeof obj === 'object' && obj !== null) {
242
+ // Hot path: migrated nodes (anything implementing toBuffer, including Fr/Fq via BaseField). This branch
243
+ // is taken for the vast majority of recursive serialization, so it is checked before the typeof primitives.
244
+ if (obj.toBuffer !== undefined) {
245
+ const ret = obj.toBuffer(sink);
246
+ if (ret !== undefined) {
247
+ sink.writeBytes(ret);
248
+ }
249
+ return;
250
+ }
251
+ if (Array.isArray(obj)) {
252
+ serializeArrayToSinkInner(sink, obj);
253
+ return;
254
+ }
255
+ if (Buffer.isBuffer(obj) || obj instanceof Uint8Array) {
256
+ sink.writeBytes(obj);
257
+ return;
258
+ }
259
+ throw new Error(`Cannot serialize input to sink: ${typeof obj} ${obj.constructor?.name}`);
260
+ }
261
+ if (typeof obj === 'boolean') {
262
+ sink.writeBool(obj);
263
+ } else if (typeof obj === 'bigint') {
264
+ sink.writeBigInt(obj);
265
+ } else if (typeof obj === 'number') {
266
+ sink.writeNumber(obj);
267
+ } else if (typeof obj === 'string') {
268
+ sink.writeString(obj);
269
+ } else {
270
+ throw new Error(`Cannot serialize input to sink: ${typeof obj}`);
271
+ }
272
+ }
273
+ /**
274
+ * Streaming counterpart to `serializeArrayOfBufferableToVector`: write a length prefix (1 or 4 bytes) giving the
275
+ * number of serialized elements, then each element. Byte-identical to the buffer version.
276
+ *
277
+ * @param sink - The destination sink.
278
+ * @param objs - The vector elements.
279
+ * @param prefixLength - Width of the count prefix in bytes (1 or 4).
280
+ */ export function serializeArrayToSink(sink, objs, prefixLength = 4) {
281
+ const count = countSinkables(objs);
282
+ if (prefixLength === 1) {
283
+ sink.writeUInt8(count);
284
+ } else if (prefixLength === 4) {
285
+ sink.writeNumber(count);
286
+ } else {
287
+ throw new Error(`Unsupported prefix length. Got ${prefixLength}, expected 1 or 4`);
288
+ }
289
+ serializeArrayToSinkInner(sink, objs);
290
+ }
291
+ /** Count how many top-level buffers `serializeToBufferArray` would emit, flattening nested arrays as it does. */ function countSinkables(objs) {
292
+ let count = 0;
293
+ for (const obj of objs){
294
+ count += Array.isArray(obj) ? countSinkables(obj) : 1;
295
+ }
296
+ return count;
297
+ }
@@ -1,7 +1,8 @@
1
1
  export * from './free_funcs.js';
2
2
  export * from './buffer_reader.js';
3
+ export * from './buffer_sink.js';
3
4
  export * from './field_reader.js';
4
5
  export * from './types.js';
5
6
  export * from './serialize.js';
6
7
  export * from './type_registry.js';
7
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJpYWxpemUvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsY0FBYyxZQUFZLENBQUM7QUFDM0IsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLG9CQUFvQixDQUFDIn0=
8
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJpYWxpemUvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsa0JBQWtCLENBQUM7QUFDakMsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLFlBQVksQ0FBQztBQUMzQixjQUFjLGdCQUFnQixDQUFDO0FBQy9CLGNBQWMsb0JBQW9CLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serialize/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serialize/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}