@resultsafe/core-fp-result 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (389) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +273 -0
  3. package/README.ru.md +266 -0
  4. package/dist/LICENSE +21 -0
  5. package/dist/README.md +273 -0
  6. package/dist/cjs/constructors/Err.js +4 -0
  7. package/dist/cjs/constructors/Err.js.map +1 -0
  8. package/dist/cjs/constructors/Ok.js +4 -0
  9. package/dist/cjs/constructors/Ok.js.map +1 -0
  10. package/dist/cjs/guards/isErr.js +4 -0
  11. package/dist/cjs/guards/isErr.js.map +1 -0
  12. package/dist/cjs/guards/isErrAnd.js +5 -0
  13. package/dist/cjs/guards/isErrAnd.js.map +1 -0
  14. package/dist/cjs/guards/isOk.js +4 -0
  15. package/dist/cjs/guards/isOk.js.map +1 -0
  16. package/dist/cjs/guards/isOkAnd.js +5 -0
  17. package/dist/cjs/guards/isOkAnd.js.map +1 -0
  18. package/dist/cjs/index.js +70 -0
  19. package/dist/cjs/index.js.map +1 -0
  20. package/dist/cjs/internal/object.js +6 -0
  21. package/dist/cjs/internal/object.js.map +1 -0
  22. package/dist/cjs/internal/option.js +6 -0
  23. package/dist/cjs/internal/option.js.map +1 -0
  24. package/dist/cjs/methods/andThen.js +5 -0
  25. package/dist/cjs/methods/andThen.js.map +1 -0
  26. package/dist/cjs/methods/err.js +6 -0
  27. package/dist/cjs/methods/err.js.map +1 -0
  28. package/dist/cjs/methods/expect.js +10 -0
  29. package/dist/cjs/methods/expect.js.map +1 -0
  30. package/dist/cjs/methods/expectErr.js +10 -0
  31. package/dist/cjs/methods/expectErr.js.map +1 -0
  32. package/dist/cjs/methods/flatten.js +4 -0
  33. package/dist/cjs/methods/flatten.js.map +1 -0
  34. package/dist/cjs/methods/inspect.js +10 -0
  35. package/dist/cjs/methods/inspect.js.map +1 -0
  36. package/dist/cjs/methods/inspectErr.js +10 -0
  37. package/dist/cjs/methods/inspectErr.js.map +1 -0
  38. package/dist/cjs/methods/map.js +5 -0
  39. package/dist/cjs/methods/map.js.map +1 -0
  40. package/dist/cjs/methods/mapErr.js +5 -0
  41. package/dist/cjs/methods/mapErr.js.map +1 -0
  42. package/dist/cjs/methods/match.js +11 -0
  43. package/dist/cjs/methods/match.js.map +1 -0
  44. package/dist/cjs/methods/ok.js +6 -0
  45. package/dist/cjs/methods/ok.js.map +1 -0
  46. package/dist/cjs/methods/orElse.js +5 -0
  47. package/dist/cjs/methods/orElse.js.map +1 -0
  48. package/dist/cjs/methods/tap.js +9 -0
  49. package/dist/cjs/methods/tap.js.map +1 -0
  50. package/dist/cjs/methods/tapErr.js +10 -0
  51. package/dist/cjs/methods/tapErr.js.map +1 -0
  52. package/dist/cjs/methods/transpose.js +10 -0
  53. package/dist/cjs/methods/transpose.js.map +1 -0
  54. package/dist/cjs/methods/unwrap.js +10 -0
  55. package/dist/cjs/methods/unwrap.js.map +1 -0
  56. package/dist/cjs/methods/unwrapErr.js +10 -0
  57. package/dist/cjs/methods/unwrapErr.js.map +1 -0
  58. package/dist/cjs/methods/unwrapOr.js +5 -0
  59. package/dist/cjs/methods/unwrapOr.js.map +1 -0
  60. package/dist/cjs/methods/unwrapOrElse.js +10 -0
  61. package/dist/cjs/methods/unwrapOrElse.js.map +1 -0
  62. package/dist/cjs/package.json +3 -0
  63. package/dist/cjs/refiners/isTypedVariant.js +9 -0
  64. package/dist/cjs/refiners/isTypedVariant.js.map +1 -0
  65. package/dist/cjs/refiners/isTypedVariantOf.js +14 -0
  66. package/dist/cjs/refiners/isTypedVariantOf.js.map +1 -0
  67. package/dist/cjs/refiners/matchVariant.js +57 -0
  68. package/dist/cjs/refiners/matchVariant.js.map +1 -0
  69. package/dist/cjs/refiners/matchVariantStrict.js +37 -0
  70. package/dist/cjs/refiners/matchVariantStrict.js.map +1 -0
  71. package/dist/cjs/refiners/refineAsyncResult.js +26 -0
  72. package/dist/cjs/refiners/refineAsyncResult.js.map +1 -0
  73. package/dist/cjs/refiners/refineAsyncResultU.js +28 -0
  74. package/dist/cjs/refiners/refineAsyncResultU.js.map +1 -0
  75. package/dist/cjs/refiners/refineResult.js +21 -0
  76. package/dist/cjs/refiners/refineResult.js.map +1 -0
  77. package/dist/cjs/refiners/refineResultU.js +5 -0
  78. package/dist/cjs/refiners/refineResultU.js.map +1 -0
  79. package/dist/cjs/refiners/refineVariantMap.js +25 -0
  80. package/dist/cjs/refiners/refineVariantMap.js.map +1 -0
  81. package/dist/cjs/refiners/utils/getPayloadKeys.js +8 -0
  82. package/dist/cjs/refiners/utils/getPayloadKeys.js.map +1 -0
  83. package/dist/docs/api/README.md +9 -0
  84. package/dist/docs/api/constructors/Err.md +58 -0
  85. package/dist/docs/api/constructors/Ok.md +58 -0
  86. package/dist/docs/api/constructors/index.md +7 -0
  87. package/dist/docs/api/guards/index.md +9 -0
  88. package/dist/docs/api/guards/isErr.md +58 -0
  89. package/dist/docs/api/guards/isErrAnd.md +64 -0
  90. package/dist/docs/api/guards/isOk.md +58 -0
  91. package/dist/docs/api/guards/isOkAnd.md +64 -0
  92. package/dist/docs/api/index.md +9 -0
  93. package/dist/docs/api/methods/andThen.md +73 -0
  94. package/dist/docs/api/methods/err.md +58 -0
  95. package/dist/docs/api/methods/expect.md +68 -0
  96. package/dist/docs/api/methods/expectErr.md +68 -0
  97. package/dist/docs/api/methods/flatten.md +58 -0
  98. package/dist/docs/api/methods/index.md +24 -0
  99. package/dist/docs/api/methods/inspect.md +64 -0
  100. package/dist/docs/api/methods/inspectErr.md +64 -0
  101. package/dist/docs/api/methods/map.md +70 -0
  102. package/dist/docs/api/methods/mapErr.md +70 -0
  103. package/dist/docs/api/methods/match.md +76 -0
  104. package/dist/docs/api/methods/ok.md +58 -0
  105. package/dist/docs/api/methods/orElse.md +70 -0
  106. package/dist/docs/api/methods/tap.md +64 -0
  107. package/dist/docs/api/methods/tapErr.md +64 -0
  108. package/dist/docs/api/methods/transpose.md +58 -0
  109. package/dist/docs/api/methods/unwrap.md +62 -0
  110. package/dist/docs/api/methods/unwrapErr.md +62 -0
  111. package/dist/docs/api/methods/unwrapOr.md +64 -0
  112. package/dist/docs/api/methods/unwrapOrElse.md +64 -0
  113. package/dist/docs/api/modules.md +10 -0
  114. package/dist/docs/api/refiners/index.md +14 -0
  115. package/dist/docs/api/refiners/isTypedVariant.md +62 -0
  116. package/dist/docs/api/refiners/isTypedVariantOf.md +68 -0
  117. package/dist/docs/api/refiners/matchVariant.md +59 -0
  118. package/dist/docs/api/refiners/matchVariantStrict.md +63 -0
  119. package/dist/docs/api/refiners/refineAsyncResult.md +98 -0
  120. package/dist/docs/api/refiners/refineAsyncResultU.md +86 -0
  121. package/dist/docs/api/refiners/refineResult.md +98 -0
  122. package/dist/docs/api/refiners/refineResultU.md +86 -0
  123. package/dist/docs/api/refiners/refineVariantMap.md +79 -0
  124. package/dist/docs/api/type-aliases/Handler.md +49 -0
  125. package/dist/docs/api/type-aliases/MatchBuilder.md +57 -0
  126. package/dist/docs/api/type-aliases/Matcher.md +71 -0
  127. package/dist/docs/api/type-aliases/SyncRefinedResult.md +31 -0
  128. package/dist/docs/api/type-aliases/SyncRefinedResultUnion.md +21 -0
  129. package/dist/docs/api/type-aliases/SyncValidatorMap.md +17 -0
  130. package/dist/docs/api/type-aliases/UniversalAsyncRefinedResult.md +31 -0
  131. package/dist/docs/api/type-aliases/UniversalRefinedResult.md +31 -0
  132. package/dist/docs/api/type-aliases/VariantOf.md +23 -0
  133. package/dist/docs/api/type-aliases/index.md +14 -0
  134. package/dist/esm/constructors/Err.js +7 -0
  135. package/dist/esm/constructors/Err.js.map +1 -0
  136. package/dist/esm/constructors/Ok.js +7 -0
  137. package/dist/esm/constructors/Ok.js.map +1 -0
  138. package/dist/esm/guards/isErr.js +7 -0
  139. package/dist/esm/guards/isErr.js.map +1 -0
  140. package/dist/esm/guards/isErrAnd.js +8 -0
  141. package/dist/esm/guards/isErrAnd.js.map +1 -0
  142. package/dist/esm/guards/isOk.js +7 -0
  143. package/dist/esm/guards/isOk.js.map +1 -0
  144. package/dist/esm/guards/isOkAnd.js +8 -0
  145. package/dist/esm/guards/isOkAnd.js.map +1 -0
  146. package/dist/esm/index.js +71 -0
  147. package/dist/esm/index.js.map +1 -0
  148. package/dist/esm/internal/object.js +9 -0
  149. package/dist/esm/internal/object.js.map +1 -0
  150. package/dist/esm/internal/option.js +9 -0
  151. package/dist/esm/internal/option.js.map +1 -0
  152. package/dist/esm/methods/andThen.js +8 -0
  153. package/dist/esm/methods/andThen.js.map +1 -0
  154. package/dist/esm/methods/err.js +9 -0
  155. package/dist/esm/methods/err.js.map +1 -0
  156. package/dist/esm/methods/expect.js +13 -0
  157. package/dist/esm/methods/expect.js.map +1 -0
  158. package/dist/esm/methods/expectErr.js +13 -0
  159. package/dist/esm/methods/expectErr.js.map +1 -0
  160. package/dist/esm/methods/flatten.js +7 -0
  161. package/dist/esm/methods/flatten.js.map +1 -0
  162. package/dist/esm/methods/inspect.js +13 -0
  163. package/dist/esm/methods/inspect.js.map +1 -0
  164. package/dist/esm/methods/inspectErr.js +13 -0
  165. package/dist/esm/methods/inspectErr.js.map +1 -0
  166. package/dist/esm/methods/map.js +8 -0
  167. package/dist/esm/methods/map.js.map +1 -0
  168. package/dist/esm/methods/mapErr.js +8 -0
  169. package/dist/esm/methods/mapErr.js.map +1 -0
  170. package/dist/esm/methods/match.js +14 -0
  171. package/dist/esm/methods/match.js.map +1 -0
  172. package/dist/esm/methods/ok.js +9 -0
  173. package/dist/esm/methods/ok.js.map +1 -0
  174. package/dist/esm/methods/orElse.js +8 -0
  175. package/dist/esm/methods/orElse.js.map +1 -0
  176. package/dist/esm/methods/tap.js +12 -0
  177. package/dist/esm/methods/tap.js.map +1 -0
  178. package/dist/esm/methods/tapErr.js +13 -0
  179. package/dist/esm/methods/tapErr.js.map +1 -0
  180. package/dist/esm/methods/transpose.js +13 -0
  181. package/dist/esm/methods/transpose.js.map +1 -0
  182. package/dist/esm/methods/unwrap.js +13 -0
  183. package/dist/esm/methods/unwrap.js.map +1 -0
  184. package/dist/esm/methods/unwrapErr.js +13 -0
  185. package/dist/esm/methods/unwrapErr.js.map +1 -0
  186. package/dist/esm/methods/unwrapOr.js +8 -0
  187. package/dist/esm/methods/unwrapOr.js.map +1 -0
  188. package/dist/esm/methods/unwrapOrElse.js +13 -0
  189. package/dist/esm/methods/unwrapOrElse.js.map +1 -0
  190. package/dist/esm/refiners/isTypedVariant.js +12 -0
  191. package/dist/esm/refiners/isTypedVariant.js.map +1 -0
  192. package/dist/esm/refiners/isTypedVariantOf.js +17 -0
  193. package/dist/esm/refiners/isTypedVariantOf.js.map +1 -0
  194. package/dist/esm/refiners/matchVariant.js +60 -0
  195. package/dist/esm/refiners/matchVariant.js.map +1 -0
  196. package/dist/esm/refiners/matchVariantStrict.js +40 -0
  197. package/dist/esm/refiners/matchVariantStrict.js.map +1 -0
  198. package/dist/esm/refiners/refineAsyncResult.js +29 -0
  199. package/dist/esm/refiners/refineAsyncResult.js.map +1 -0
  200. package/dist/esm/refiners/refineAsyncResultU.js +31 -0
  201. package/dist/esm/refiners/refineAsyncResultU.js.map +1 -0
  202. package/dist/esm/refiners/refineResult.js +24 -0
  203. package/dist/esm/refiners/refineResult.js.map +1 -0
  204. package/dist/esm/refiners/refineResultU.js +8 -0
  205. package/dist/esm/refiners/refineResultU.js.map +1 -0
  206. package/dist/esm/refiners/refineVariantMap.js +29 -0
  207. package/dist/esm/refiners/refineVariantMap.js.map +1 -0
  208. package/dist/esm/refiners/utils/getPayloadKeys.js +11 -0
  209. package/dist/esm/refiners/utils/getPayloadKeys.js.map +1 -0
  210. package/dist/package.json +36 -0
  211. package/dist/types/constructors/Err.d.ts +21 -0
  212. package/dist/types/constructors/Err.d.ts.map +1 -0
  213. package/dist/types/constructors/Ok.d.ts +21 -0
  214. package/dist/types/constructors/Ok.d.ts.map +1 -0
  215. package/dist/types/constructors/index.d.ts +3 -0
  216. package/dist/types/constructors/index.d.ts.map +1 -0
  217. package/dist/types/guards/index.d.ts +5 -0
  218. package/dist/types/guards/index.d.ts.map +1 -0
  219. package/dist/types/guards/isErr.d.ts +24 -0
  220. package/dist/types/guards/isErr.d.ts.map +1 -0
  221. package/dist/types/guards/isErrAnd.d.ts +22 -0
  222. package/dist/types/guards/isErrAnd.d.ts.map +1 -0
  223. package/dist/types/guards/isOk.d.ts +24 -0
  224. package/dist/types/guards/isOk.d.ts.map +1 -0
  225. package/dist/types/guards/isOkAnd.d.ts +22 -0
  226. package/dist/types/guards/isOkAnd.d.ts.map +1 -0
  227. package/dist/types/index.d.ts +5 -0
  228. package/dist/types/index.d.ts.map +1 -0
  229. package/dist/types/internal/object.d.ts +5 -0
  230. package/dist/types/internal/object.d.ts.map +1 -0
  231. package/dist/types/internal/option.d.ts +10 -0
  232. package/dist/types/internal/option.d.ts.map +1 -0
  233. package/dist/types/methods/andThen.d.ts +26 -0
  234. package/dist/types/methods/andThen.d.ts.map +1 -0
  235. package/dist/types/methods/err.d.ts +22 -0
  236. package/dist/types/methods/err.d.ts.map +1 -0
  237. package/dist/types/methods/expect.d.ts +23 -0
  238. package/dist/types/methods/expect.d.ts.map +1 -0
  239. package/dist/types/methods/expectErr.d.ts +23 -0
  240. package/dist/types/methods/expectErr.d.ts.map +1 -0
  241. package/dist/types/methods/flatten.d.ts +21 -0
  242. package/dist/types/methods/flatten.d.ts.map +1 -0
  243. package/dist/types/methods/index.d.ts +20 -0
  244. package/dist/types/methods/index.d.ts.map +1 -0
  245. package/dist/types/methods/inspect.d.ts +22 -0
  246. package/dist/types/methods/inspect.d.ts.map +1 -0
  247. package/dist/types/methods/inspectErr.d.ts +22 -0
  248. package/dist/types/methods/inspectErr.d.ts.map +1 -0
  249. package/dist/types/methods/map.d.ts +23 -0
  250. package/dist/types/methods/map.d.ts.map +1 -0
  251. package/dist/types/methods/mapErr.d.ts +23 -0
  252. package/dist/types/methods/mapErr.d.ts.map +1 -0
  253. package/dist/types/methods/match.d.ts +24 -0
  254. package/dist/types/methods/match.d.ts.map +1 -0
  255. package/dist/types/methods/ok.d.ts +22 -0
  256. package/dist/types/methods/ok.d.ts.map +1 -0
  257. package/dist/types/methods/orElse.d.ts +23 -0
  258. package/dist/types/methods/orElse.d.ts.map +1 -0
  259. package/dist/types/methods/tap.d.ts +22 -0
  260. package/dist/types/methods/tap.d.ts.map +1 -0
  261. package/dist/types/methods/tapErr.d.ts +22 -0
  262. package/dist/types/methods/tapErr.d.ts.map +1 -0
  263. package/dist/types/methods/transpose.d.ts +22 -0
  264. package/dist/types/methods/transpose.d.ts.map +1 -0
  265. package/dist/types/methods/unwrap.d.ts +22 -0
  266. package/dist/types/methods/unwrap.d.ts.map +1 -0
  267. package/dist/types/methods/unwrapErr.d.ts +22 -0
  268. package/dist/types/methods/unwrapErr.d.ts.map +1 -0
  269. package/dist/types/methods/unwrapOr.d.ts +22 -0
  270. package/dist/types/methods/unwrapOr.d.ts.map +1 -0
  271. package/dist/types/methods/unwrapOrElse.d.ts +22 -0
  272. package/dist/types/methods/unwrapOrElse.d.ts.map +1 -0
  273. package/dist/types/refiners/index.d.ts +11 -0
  274. package/dist/types/refiners/index.d.ts.map +1 -0
  275. package/dist/types/refiners/isTypedVariant.d.ts +21 -0
  276. package/dist/types/refiners/isTypedVariant.d.ts.map +1 -0
  277. package/dist/types/refiners/isTypedVariantOf.d.ts +22 -0
  278. package/dist/types/refiners/isTypedVariantOf.d.ts.map +1 -0
  279. package/dist/types/refiners/matchVariant.d.ts +27 -0
  280. package/dist/types/refiners/matchVariant.d.ts.map +1 -0
  281. package/dist/types/refiners/matchVariantStrict.d.ts +28 -0
  282. package/dist/types/refiners/matchVariantStrict.d.ts.map +1 -0
  283. package/dist/types/refiners/refineAsyncResult.d.ts +54 -0
  284. package/dist/types/refiners/refineAsyncResult.d.ts.map +1 -0
  285. package/dist/types/refiners/refineAsyncResultU.d.ts +30 -0
  286. package/dist/types/refiners/refineAsyncResultU.d.ts.map +1 -0
  287. package/dist/types/refiners/refineResult.d.ts +54 -0
  288. package/dist/types/refiners/refineResult.d.ts.map +1 -0
  289. package/dist/types/refiners/refineResultU.d.ts +30 -0
  290. package/dist/types/refiners/refineResultU.d.ts.map +1 -0
  291. package/dist/types/refiners/refineVariantMap.d.ts +34 -0
  292. package/dist/types/refiners/refineVariantMap.d.ts.map +1 -0
  293. package/dist/types/refiners/types/Handler.d.ts +9 -0
  294. package/dist/types/refiners/types/Handler.d.ts.map +1 -0
  295. package/dist/types/refiners/types/MatchBuilder.d.ts +9 -0
  296. package/dist/types/refiners/types/MatchBuilder.d.ts.map +1 -0
  297. package/dist/types/refiners/types/Matcher.d.ts +11 -0
  298. package/dist/types/refiners/types/Matcher.d.ts.map +1 -0
  299. package/dist/types/refiners/types/SyncRefinedResult.d.ts +6 -0
  300. package/dist/types/refiners/types/SyncRefinedResult.d.ts.map +1 -0
  301. package/dist/types/refiners/types/SyncRefinedResultUnion.d.ts +8 -0
  302. package/dist/types/refiners/types/SyncRefinedResultUnion.d.ts.map +1 -0
  303. package/dist/types/refiners/types/SyncValidatorMap.d.ts +6 -0
  304. package/dist/types/refiners/types/SyncValidatorMap.d.ts.map +1 -0
  305. package/dist/types/refiners/types/UniversalAsyncRefinedResult.d.ts +6 -0
  306. package/dist/types/refiners/types/UniversalAsyncRefinedResult.d.ts.map +1 -0
  307. package/dist/types/refiners/types/UniversalRefinedResult.d.ts +6 -0
  308. package/dist/types/refiners/types/UniversalRefinedResult.d.ts.map +1 -0
  309. package/dist/types/refiners/types/VariantOf.d.ts +5 -0
  310. package/dist/types/refiners/types/VariantOf.d.ts.map +1 -0
  311. package/dist/types/refiners/types/index.d.ts +10 -0
  312. package/dist/types/refiners/types/index.d.ts.map +1 -0
  313. package/dist/types/refiners/utils/getPayloadKeys.d.ts +19 -0
  314. package/dist/types/refiners/utils/getPayloadKeys.d.ts.map +1 -0
  315. package/dist/types/refiners/utils/index.d.ts +2 -0
  316. package/dist/types/refiners/utils/index.d.ts.map +1 -0
  317. package/dist/types/shared-types.d.ts +22 -0
  318. package/dist/types/shared-types.d.ts.map +1 -0
  319. package/dist/umd/resultsafe-monorepo-core-fp-result.umd.js +2 -0
  320. package/dist/umd/resultsafe-monorepo-core-fp-result.umd.js.map +1 -0
  321. package/docs/_category_.json +6 -0
  322. package/docs/api/README.md +9 -0
  323. package/docs/api/constructors/Err.md +58 -0
  324. package/docs/api/constructors/Ok.md +58 -0
  325. package/docs/api/constructors/index.md +7 -0
  326. package/docs/api/guards/index.md +9 -0
  327. package/docs/api/guards/isErr.md +58 -0
  328. package/docs/api/guards/isErrAnd.md +64 -0
  329. package/docs/api/guards/isOk.md +58 -0
  330. package/docs/api/guards/isOkAnd.md +64 -0
  331. package/docs/api/index.md +9 -0
  332. package/docs/api/methods/andThen.md +73 -0
  333. package/docs/api/methods/err.md +58 -0
  334. package/docs/api/methods/expect.md +68 -0
  335. package/docs/api/methods/expectErr.md +68 -0
  336. package/docs/api/methods/flatten.md +58 -0
  337. package/docs/api/methods/index.md +24 -0
  338. package/docs/api/methods/inspect.md +64 -0
  339. package/docs/api/methods/inspectErr.md +64 -0
  340. package/docs/api/methods/map.md +70 -0
  341. package/docs/api/methods/mapErr.md +70 -0
  342. package/docs/api/methods/match.md +76 -0
  343. package/docs/api/methods/ok.md +58 -0
  344. package/docs/api/methods/orElse.md +70 -0
  345. package/docs/api/methods/tap.md +64 -0
  346. package/docs/api/methods/tapErr.md +64 -0
  347. package/docs/api/methods/transpose.md +58 -0
  348. package/docs/api/methods/unwrap.md +62 -0
  349. package/docs/api/methods/unwrapErr.md +62 -0
  350. package/docs/api/methods/unwrapOr.md +64 -0
  351. package/docs/api/methods/unwrapOrElse.md +64 -0
  352. package/docs/api/modules.md +10 -0
  353. package/docs/api/refiners/index.md +14 -0
  354. package/docs/api/refiners/isTypedVariant.md +62 -0
  355. package/docs/api/refiners/isTypedVariantOf.md +68 -0
  356. package/docs/api/refiners/matchVariant.md +59 -0
  357. package/docs/api/refiners/matchVariantStrict.md +63 -0
  358. package/docs/api/refiners/refineAsyncResult.md +98 -0
  359. package/docs/api/refiners/refineAsyncResultU.md +86 -0
  360. package/docs/api/refiners/refineResult.md +98 -0
  361. package/docs/api/refiners/refineResultU.md +86 -0
  362. package/docs/api/refiners/refineVariantMap.md +79 -0
  363. package/docs/api/type-aliases/Handler.md +49 -0
  364. package/docs/api/type-aliases/MatchBuilder.md +57 -0
  365. package/docs/api/type-aliases/Matcher.md +71 -0
  366. package/docs/api/type-aliases/SyncRefinedResult.md +31 -0
  367. package/docs/api/type-aliases/SyncRefinedResultUnion.md +21 -0
  368. package/docs/api/type-aliases/SyncValidatorMap.md +17 -0
  369. package/docs/api/type-aliases/UniversalAsyncRefinedResult.md +31 -0
  370. package/docs/api/type-aliases/UniversalRefinedResult.md +31 -0
  371. package/docs/api/type-aliases/VariantOf.md +23 -0
  372. package/docs/api/type-aliases/index.md +14 -0
  373. package/docs/assets/logo.svg +153 -0
  374. package/docs/examples/_category_.json +4 -0
  375. package/docs/examples/auth/_category_.json +4 -0
  376. package/docs/examples/auth/index.md +3 -0
  377. package/docs/examples/auth/token.md +5 -0
  378. package/docs/examples/connection/_category_.json +4 -0
  379. package/docs/examples/connection/connect.md +5 -0
  380. package/docs/examples/connection/index.md +3 -0
  381. package/docs/examples/connection/reconnect.md +5 -0
  382. package/docs/examples/errors/_category_.json +4 -0
  383. package/docs/examples/errors/index.md +3 -0
  384. package/docs/examples/errors/retry.md +5 -0
  385. package/docs/examples/index.md +9 -0
  386. package/docs/examples/streaming/_category_.json +4 -0
  387. package/docs/examples/streaming/index.md +3 -0
  388. package/docs/examples/streaming/text.md +5 -0
  389. package/package.json +70 -0
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ const isErr = require("../guards/isErr.js");
3
+ const tapErr = (result, fn) => {
4
+ if (isErr.isErr(result)) {
5
+ fn(result.error);
6
+ }
7
+ return result;
8
+ };
9
+ exports.tapErr = tapErr;
10
+ //# sourceMappingURL=tapErr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tapErr.js","sources":["../../../src/methods/tapErr.ts"],"sourcesContent":["import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Выполняет побочный эффект для значения `Err` и возвращает входной `Result`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Колбэк побочного эффекта для ветки ошибки.\n * @returns Неизмененный `Result`.\n * @since 0.1.0\n * @see {@link tap} - Executes a side effect for the success branch.\n * @example\n * ```ts\n * import { Err, tapErr } from '@resultsafe/core-fp-result';\n *\n * const result = tapErr(Err('boom'), (error) => console.log(error)); // boom\n * console.log(result.ok); // false\n * ```\n * @public\n */\nexport const tapErr = <T, E>(\n result: Result<T, E>,\n fn: (error: E) => void,\n): Result<T, E> => {\n if (isErr(result)) {\n fn(result.error);\n }\n return result;\n};\n\r\n\r\n"],"names":["isErr"],"mappings":";;AAuBO,MAAM,SAAS,CACpB,QACA,OACiB;AACjB,MAAIA,MAAAA,MAAM,MAAM,GAAG;AACjB,OAAG,OAAO,KAAK;AAAA,EACjB;AACA,SAAO;AACT;;"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ const option = require("../internal/option.js");
3
+ const transpose = (result) => {
4
+ if (result.ok) {
5
+ return result.value.some === true ? option.Some({ ok: true, value: result.value.value }) : option.None;
6
+ }
7
+ return option.Some({ ok: false, error: result.error });
8
+ };
9
+ exports.transpose = transpose;
10
+ //# sourceMappingURL=transpose.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transpose.js","sources":["../../../src/methods/transpose.ts"],"sourcesContent":["import { type Option } from '../shared-types.js';\nimport { type Result } from '../shared-types.js';\n\nimport { None, Some } from '../internal/option.js';\n\n/**\n * Преобразует `Result<Option<T>, E>` в `Option<Result<T, E>>`.\n *\n * @typeParam T - The success value type inside `Option`.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`, содержащий `Option`.\n * @returns Транспонированный `Option<Result<T, E>>`.\n * @since 0.1.0\n * @see {@link flatten} - Collapses nested `Result` values.\n * @example\n * ```ts\n * import { Ok, transpose } from '@resultsafe/core-fp-result';\n *\n * const value = transpose(Ok({ some: true, value: 2 }));\n * console.log(value.some); // true\n * ```\n * @public\n */\nexport const transpose = <T, E>(\n result: Result<Option<T>, E>,\n): Option<Result<T, E>> => {\n if (result.ok) {\n return result.value.some === true\n ? Some({ ok: true, value: result.value.value })\n : None;\n }\n return Some({ ok: false, error: result.error });\n};\n\r\n\r\n"],"names":["Some","None"],"mappings":";;AAuBO,MAAM,YAAY,CACvB,WACyB;AACzB,MAAI,OAAO,IAAI;AACb,WAAO,OAAO,MAAM,SAAS,OACzBA,OAAAA,KAAK,EAAE,IAAI,MAAM,OAAO,OAAO,MAAM,MAAA,CAAO,IAC5CC,OAAAA;AAAAA,EACN;AACA,SAAOD,OAAAA,KAAK,EAAE,IAAI,OAAO,OAAO,OAAO,OAAO;AAChD;;"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ const isOk = require("../guards/isOk.js");
3
+ const unwrap = (result) => {
4
+ if (isOk.isOk(result)) {
5
+ return result.value;
6
+ }
7
+ throw new Error("Called unwrap on an Err value");
8
+ };
9
+ exports.unwrap = unwrap;
10
+ //# sourceMappingURL=unwrap.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unwrap.js","sources":["../../../src/methods/unwrap.ts"],"sourcesContent":["import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Возвращает успешное значение или выбрасывает исключение, если результат `Err`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @returns Payload успеха.\n * @throws Error - Выбрасывает исключение при вызове на `Err`.\n * @since 0.1.0\n * @see {@link unwrapOr} - Возвращает fallback вместо выброса исключения.\n * @example\n * ```ts\n * import { Ok, unwrap } from '@resultsafe/core-fp-result';\n *\n * const value = unwrap(Ok(9));\n * console.log(value); // 9\n * ```\n * @public\n */\nexport const unwrap = <T, E>(result: Result<T, E>): T => {\n if (isOk(result)) {\n return result.value;\n }\n throw new Error('Called unwrap on an Err value');\n};\n\r\n\r\n"],"names":["isOk"],"mappings":";;AAuBO,MAAM,SAAS,CAAO,WAA4B;AACvD,MAAIA,KAAAA,KAAK,MAAM,GAAG;AAChB,WAAO,OAAO;AAAA,EAChB;AACA,QAAM,IAAI,MAAM,+BAA+B;AACjD;;"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ const isErr = require("../guards/isErr.js");
3
+ const unwrapErr = (result) => {
4
+ if (isErr.isErr(result)) {
5
+ return result.error;
6
+ }
7
+ throw new Error("Called unwrapErr on an Ok value");
8
+ };
9
+ exports.unwrapErr = unwrapErr;
10
+ //# sourceMappingURL=unwrapErr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unwrapErr.js","sources":["../../../src/methods/unwrapErr.ts"],"sourcesContent":["import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Возвращает значение ошибки или выбрасывает исключение, если результат `Ok`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @returns Payload ошибки.\n * @throws Error - Выбрасывает исключение при вызове на `Ok`.\n * @since 0.1.0\n * @see {@link unwrapOrElse} - Возвращает fallback успеха без выброса исключения.\n * @example\n * ```ts\n * import { Err, unwrapErr } from '@resultsafe/core-fp-result';\n *\n * const error = unwrapErr(Err('boom'));\n * console.log(error); // boom\n * ```\n * @public\n */\nexport const unwrapErr = <T, E>(result: Result<T, E>): E => {\n if (isErr(result)) {\n return result.error;\n }\n throw new Error('Called unwrapErr on an Ok value');\n};\n\r\n\r\n"],"names":["isErr"],"mappings":";;AAuBO,MAAM,YAAY,CAAO,WAA4B;AAC1D,MAAIA,MAAAA,MAAM,MAAM,GAAG;AACjB,WAAO,OAAO;AAAA,EAChB;AACA,QAAM,IAAI,MAAM,iCAAiC;AACnD;;"}
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ const isOk = require("../guards/isOk.js");
3
+ const unwrapOr = (result, defaultValue) => isOk.isOk(result) ? result.value : defaultValue;
4
+ exports.unwrapOr = unwrapOr;
5
+ //# sourceMappingURL=unwrapOr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unwrapOr.js","sources":["../../../src/methods/unwrapOr.ts"],"sourcesContent":["import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Возвращает успешное значение или переданный fallback по умолчанию.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param defaultValue - Fallback-значение для `Err`.\n * @returns Payload успеха или `defaultValue`.\n * @since 0.1.0\n * @see {@link unwrapOrElse} - Вычисляет fallback лениво.\n * @example\n * ```ts\n * import { Err, unwrapOr } from '@resultsafe/core-fp-result';\n *\n * const value = unwrapOr(Err('boom'), 0);\n * console.log(value); // 0\n * ```\n * @public\n */\nexport const unwrapOr = <T, E>(result: Result<T, E>, defaultValue: T): T =>\n isOk(result) ? result.value : defaultValue;\n\r\n\r\n"],"names":["isOk"],"mappings":";;AAuBO,MAAM,WAAW,CAAO,QAAsB,iBACnDA,KAAAA,KAAK,MAAM,IAAI,OAAO,QAAQ;;"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ const unwrapOrElse = (result, fn) => {
3
+ if (result.ok) {
4
+ return result.value;
5
+ } else {
6
+ return fn(result.error);
7
+ }
8
+ };
9
+ exports.unwrapOrElse = unwrapOrElse;
10
+ //# sourceMappingURL=unwrapOrElse.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unwrapOrElse.js","sources":["../../../src/methods/unwrapOrElse.ts"],"sourcesContent":["import { type Result } from '../shared-types.js';\n\n/**\n * Возвращает успешное значение или вычисляет fallback из ошибки.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция-поставщик fallback для `Err`.\n * @returns Payload успеха или вычисленный fallback.\n * @since 0.1.0\n * @see {@link unwrapOr} - Использует eager fallback-значение.\n * @example\n * ```ts\n * import { Err, unwrapOrElse } from '@resultsafe/core-fp-result';\n *\n * const value = unwrapOrElse(Err('fatal'), (error) => error.length);\n * console.log(value); // 5\n * ```\n * @public\n */\nexport const unwrapOrElse = <T, E>(\n result: Result<T, E>,\n fn: (error: E) => T,\n): T => {\n if (result.ok) {\n return result.value;\n } else {\n return fn(result.error);\n }\n};\n\r\n\r\n"],"names":[],"mappings":";AAqBO,MAAM,eAAe,CAC1B,QACA,OACM;AACN,MAAI,OAAO,IAAI;AACb,WAAO,OAAO;AAAA,EAChB,OAAO;AACL,WAAO,GAAG,OAAO,KAAK;AAAA,EACxB;AACF;;"}
@@ -0,0 +1,3 @@
1
+ {
2
+ "type": "commonjs"
3
+ }
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ const isTypedVariant = (variant) => (value) => {
3
+ if (typeof value !== "object" || value === null) return false;
4
+ if (!("type" in value)) return false;
5
+ const obj = value;
6
+ return obj["type"] === variant;
7
+ };
8
+ exports.isTypedVariant = isTypedVariant;
9
+ //# sourceMappingURL=isTypedVariant.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"isTypedVariant.js","sources":["../../../src/refiners/isTypedVariant.ts"],"sourcesContent":["/**\n * Создает runtime type guard для варианта дискриминированного объединения.\n *\n * @typeParam K - The discriminant literal type.\n * @param variant - Значение дискриминанта для сопоставления.\n * @returns A predicate that checks `{ type: K }` shape.\n * @since 0.1.0\n * @see {@link isTypedVariantOf} - Расширяет проверку ключами payload.\n * @example\n * ```ts\n * import { isTypedVariant } from '@resultsafe/core-fp-result';\n *\n * const isCreated = isTypedVariant('created');\n * console.log(isCreated({ type: 'created' })); // true\n * ```\n * @public\n */\nexport const isTypedVariant =\n <K extends string>(variant: K) =>\n (value: unknown): value is { type: K } => {\n if (typeof value !== 'object' || value === null) return false;\n if (!('type' in value)) return false;\n\n const obj = value as Record<string, unknown>;\n return obj['type'] === variant;\n };\n"],"names":[],"mappings":";AAiBO,MAAM,iBACX,CAAmB,YACnB,CAAC,UAAyC;AACxC,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,MAAI,EAAE,UAAU,OAAQ,QAAO;AAE/B,QAAM,MAAM;AACZ,SAAO,IAAI,MAAM,MAAM;AACzB;;"}
@@ -0,0 +1,14 @@
1
+ "use strict";
2
+ const isTypedVariantOf = (variant) => (value) => {
3
+ if (typeof value !== "object" || value === null) return false;
4
+ if (!("type" in value)) return false;
5
+ const obj = value;
6
+ if (obj["type"] !== variant) return false;
7
+ const requiredKeys = Object.keys({});
8
+ for (const key of requiredKeys) {
9
+ if (!(key in obj)) return false;
10
+ }
11
+ return true;
12
+ };
13
+ exports.isTypedVariantOf = isTypedVariantOf;
14
+ //# sourceMappingURL=isTypedVariantOf.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"isTypedVariantOf.js","sources":["../../../src/refiners/isTypedVariantOf.ts"],"sourcesContent":["/**\n * Создает runtime type guard для варианта с дополнительными ключами payload.\n *\n * @typeParam K - The discriminant literal type.\n * @typeParam T - The required payload record shape.\n * @param variant - Значение дискриминанта для сопоставления.\n * @returns A predicate that checks variant and payload key presence.\n * @since 0.1.0\n * @see {@link isTypedVariant} - Проверяет только дискриминант.\n * @example\n * ```ts\n * import { isTypedVariantOf } from '@resultsafe/core-fp-result';\n *\n * const isCreated = isTypedVariantOf<'created', { id: unknown }>('created');\n * console.log(isCreated({ type: 'created', id: 1 })); // true\n * ```\n * @public\n */\nexport const isTypedVariantOf =\n <K extends string, T extends Record<string, unknown>>(variant: K) =>\n (value: unknown): value is { type: K } & T => {\n // Rust-style early returns with Option-like behavior\n if (typeof value !== 'object' || value === null) return false;\n if (!('type' in value)) return false;\n\n const obj = value as Record<string, unknown>;\n if (obj['type'] !== variant) return false;\n\n // Type-safe key checking (like Rust's HashMap.contains_key)\n const requiredKeys = Object.keys({} as T) as Array<keyof T>;\n for (const key of requiredKeys) {\n if (!(key in obj)) return false;\n }\n\n return true;\n };\n"],"names":[],"mappings":";AAkBO,MAAM,mBACX,CAAsD,YACtD,CAAC,UAA6C;AAE5C,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,MAAI,EAAE,UAAU,OAAQ,QAAO;AAE/B,QAAM,MAAM;AACZ,MAAI,IAAI,MAAM,MAAM,QAAS,QAAO;AAGpC,QAAM,eAAe,OAAO,KAAK,EAAO;AACxC,aAAW,OAAO,cAAc;AAC9B,QAAI,EAAE,OAAO,KAAM,QAAO;AAAA,EAC5B;AAEA,SAAO;AACT;;"}
@@ -0,0 +1,57 @@
1
+ "use strict";
2
+ const matchVariant = (value) => {
3
+ const handlers = [];
4
+ const withHandler = (variant, fn) => {
5
+ const newHandlers = [...handlers, { variant, fn }];
6
+ return {
7
+ with: (variant2, fn2) => {
8
+ const newerHandlers = [
9
+ ...newHandlers,
10
+ { variant: variant2, fn: fn2 }
11
+ ];
12
+ return {
13
+ with: withHandler,
14
+ otherwise: (fallback) => ({
15
+ run: () => {
16
+ for (const h of newerHandlers) {
17
+ if (value.type === h.variant) {
18
+ const fn3 = h.fn;
19
+ return fn3(value);
20
+ }
21
+ }
22
+ return fallback(value);
23
+ }
24
+ })
25
+ };
26
+ },
27
+ otherwise: (fallback) => ({
28
+ run: () => {
29
+ for (const h of newHandlers) {
30
+ if (value.type === h.variant) {
31
+ const fn2 = h.fn;
32
+ return fn2(value);
33
+ }
34
+ }
35
+ return fallback(value);
36
+ }
37
+ })
38
+ };
39
+ };
40
+ const matcher = {
41
+ with: withHandler,
42
+ otherwise: (fallback) => ({
43
+ run: () => {
44
+ for (const h of handlers) {
45
+ if (value.type === h.variant) {
46
+ const fn = h.fn;
47
+ return fn(value);
48
+ }
49
+ }
50
+ return fallback(value);
51
+ }
52
+ })
53
+ };
54
+ return matcher;
55
+ };
56
+ exports.matchVariant = matchVariant;
57
+ //# sourceMappingURL=matchVariant.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"matchVariant.js","sources":["../../../src/refiners/matchVariant.ts"],"sourcesContent":["import type { Handler, Matcher, VariantOf } from './types/index.js';\n\n/**\n * Создает цепочный matcher для значения дискриминированного объединения.\n *\n * @typeParam T - Тип дискриминированного объединения.\n * @param value - Значение объединения для сопоставления.\n * @returns Fluent matcher с ветками `with` и `otherwise`.\n * @since 0.1.0\n * @see {@link matchVariantStrict} - Требует исчерпывающего сопоставления во время выполнения.\n * @example\n * ```ts\n * import { matchVariant } from '@resultsafe/core-fp-result';\n *\n * const out = matchVariant<{ type: 'ok'; value: number } | { type: 'err'; error: string }>({\n * type: 'ok',\n * value: 1,\n * })\n * .with('ok', (v) => `ok:${v.value}`)\n * .otherwise(() => 'fallback')\n * .run();\n *\n * console.log(out); // ok:1\n * ```\n * @public\n */\nexport const matchVariant = <T extends VariantOf>(\n value: T,\n): Matcher<T, unknown> => {\n const handlers: readonly Handler<T['type'], T, unknown>[] = [];\n\n const withHandler = <K extends T['type']>(\n variant: K,\n fn: (value: Extract<T, { type: K }>) => unknown,\n ): Matcher<T, unknown> => {\n const newHandlers = [...handlers, { variant, fn }] as const;\n\n return {\n with: <K2 extends T['type']>(\n variant2: K2,\n fn2: (value: Extract<T, { type: K2 }>) => unknown,\n ): Matcher<T, unknown> => {\n const newerHandlers = [\n ...newHandlers,\n { variant: variant2, fn: fn2 },\n ] as const;\n\n return {\n with: withHandler,\n otherwise: (fallback: (value: T) => unknown) => ({\n run: (): unknown => {\n for (const h of newerHandlers) {\n if (value.type === h.variant) {\n const fn = h.fn as (input: T) => unknown;\n return fn(value);\n }\n }\n return fallback(value);\n },\n }),\n } as Matcher<T, unknown>;\n },\n otherwise: (fallback: (value: T) => unknown) => ({\n run: (): unknown => {\n for (const h of newHandlers) {\n if (value.type === h.variant) {\n const fn = h.fn as (input: T) => unknown;\n return fn(value);\n }\n }\n return fallback(value);\n },\n }),\n } as Matcher<T, unknown>;\n };\n\n const matcher: Matcher<T, unknown> = {\n with: withHandler,\n otherwise: (fallback: (value: T) => unknown) => ({\n run: (): unknown => {\n /* v8 ignore start -- unreachable with current immutable root handler list */\n for (const h of handlers) {\n if (value.type === h.variant) {\n const fn = h.fn as (input: T) => unknown;\n return fn(value);\n }\n }\n /* v8 ignore stop */\n return fallback(value);\n },\n }),\n };\n\n return matcher;\n};\n"],"names":["fn"],"mappings":";AA0BO,MAAM,eAAe,CAC1B,UACwB;AACxB,QAAM,WAAsD,CAAA;AAE5D,QAAM,cAAc,CAClB,SACA,OACwB;AACxB,UAAM,cAAc,CAAC,GAAG,UAAU,EAAE,SAAS,IAAI;AAEjD,WAAO;AAAA,MACL,MAAM,CACJ,UACA,QACwB;AACxB,cAAM,gBAAgB;AAAA,UACpB,GAAG;AAAA,UACH,EAAE,SAAS,UAAU,IAAI,IAAA;AAAA,QAAI;AAG/B,eAAO;AAAA,UACL,MAAM;AAAA,UACN,WAAW,CAAC,cAAqC;AAAA,YAC/C,KAAK,MAAe;AAClB,yBAAW,KAAK,eAAe;AAC7B,oBAAI,MAAM,SAAS,EAAE,SAAS;AAC5B,wBAAMA,MAAK,EAAE;AACb,yBAAOA,IAAG,KAAK;AAAA,gBACjB;AAAA,cACF;AACA,qBAAO,SAAS,KAAK;AAAA,YACvB;AAAA,UAAA;AAAA,QACF;AAAA,MAEJ;AAAA,MACA,WAAW,CAAC,cAAqC;AAAA,QAC/C,KAAK,MAAe;AAClB,qBAAW,KAAK,aAAa;AAC3B,gBAAI,MAAM,SAAS,EAAE,SAAS;AAC5B,oBAAMA,MAAK,EAAE;AACb,qBAAOA,IAAG,KAAK;AAAA,YACjB;AAAA,UACF;AACA,iBAAO,SAAS,KAAK;AAAA,QACvB;AAAA,MAAA;AAAA,IACF;AAAA,EAEJ;AAEA,QAAM,UAA+B;AAAA,IACnC,MAAM;AAAA,IACN,WAAW,CAAC,cAAqC;AAAA,MAC/C,KAAK,MAAe;AAElB,mBAAW,KAAK,UAAU;AACxB,cAAI,MAAM,SAAS,EAAE,SAAS;AAC5B,kBAAM,KAAK,EAAE;AACb,mBAAO,GAAG,KAAK;AAAA,UACjB;AAAA,QACF;AAEA,eAAO,SAAS,KAAK;AAAA,MACvB;AAAA,IAAA;AAAA,EACF;AAGF,SAAO;AACT;;"}
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+ const matchVariantStrict = (value) => {
3
+ const handlers = [];
4
+ const builder = () => ({
5
+ with: (variant, fn) => {
6
+ const newHandlers = [...handlers, { variant, fn }];
7
+ return {
8
+ with: builder().with,
9
+ run: (() => {
10
+ for (const h of newHandlers) {
11
+ if (value.type === h.variant) {
12
+ const fn2 = h.fn;
13
+ return fn2(value);
14
+ }
15
+ }
16
+ throw new Error(
17
+ `Unmatched variant: ${String(value.type)}`
18
+ );
19
+ })
20
+ };
21
+ },
22
+ run: (() => {
23
+ for (const h of handlers) {
24
+ if (value.type === h.variant) {
25
+ const fn = h.fn;
26
+ return fn(value);
27
+ }
28
+ }
29
+ throw new Error(
30
+ `Unmatched variant: ${String(value.type)}`
31
+ );
32
+ })
33
+ });
34
+ return builder();
35
+ };
36
+ exports.matchVariantStrict = matchVariantStrict;
37
+ //# sourceMappingURL=matchVariantStrict.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"matchVariantStrict.js","sources":["../../../src/refiners/matchVariantStrict.ts"],"sourcesContent":["import type { Handler, MatchBuilder, VariantOf } from './types/index.js';\n\n/**\n * Создает строгий matcher, выбрасывающий исключение для необработанных вариантов.\n *\n * @typeParam T - Тип дискриминированного объединения.\n * @param value - Значение объединения для сопоставления.\n * @returns Строгий builder сопоставления, требующий явных обработчиков.\n * @throws Error - Выбрасывает исключение, если ни один зарегистрированный обработчик не соответствует `value.type`.\n * @since 0.1.0\n * @see {@link matchVariant} - Использует fallback-ветку вместо выброса исключения.\n * @example\n * ```ts\n * import { matchVariantStrict } from '@resultsafe/core-fp-result';\n *\n * const out = matchVariantStrict<{ type: 'ok'; value: number } | { type: 'err'; error: string }>({\n * type: 'err',\n * error: 'boom',\n * })\n * .with('ok', (v) => `ok:${v.value}`)\n * .with('err', (v) => `err:${v.error}`)\n * .run();\n *\n * console.log(out); // err:boom\n * ```\n * @public\n */\nexport const matchVariantStrict = <T extends VariantOf>(\n value: T,\n): MatchBuilder<T, unknown> => {\n const handlers: readonly Handler<T['type'], T, unknown>[] = [];\n\n const builder = <Handled extends T['type'] = never>(): MatchBuilder<\n T,\n unknown,\n Handled\n > => ({\n with: <K extends Exclude<T['type'], Handled>>(\n variant: K,\n fn: (value: Extract<T, { type: K }>) => unknown,\n ) => {\n const newHandlers = [...handlers, { variant, fn }] as const;\n\n return {\n with: builder<Handled | K>().with,\n run: (() => {\n for (const h of newHandlers) {\n if (value.type === h.variant) {\n const fn = h.fn as (input: T) => unknown;\n return fn(value);\n }\n }\n throw new Error(\n `Unmatched variant: ${String((value as { type: unknown }).type)}`,\n );\n }) as Handled extends T['type'] ? () => unknown : never,\n } as MatchBuilder<T, unknown, Handled | K>;\n },\n\n run: (() => {\n /* v8 ignore start -- unreachable with current immutable root handler list */\n for (const h of handlers) {\n if (value.type === h.variant) {\n const fn = h.fn as (input: T) => unknown;\n return fn(value);\n }\n }\n /* v8 ignore stop */\n throw new Error(\n `Unmatched variant: ${String((value as { type: unknown }).type)}`,\n );\n }) as Handled extends T['type'] ? () => unknown : never,\n });\n\n return builder();\n};\n"],"names":["fn"],"mappings":";AA2BO,MAAM,qBAAqB,CAChC,UAC6B;AAC7B,QAAM,WAAsD,CAAA;AAE5D,QAAM,UAAU,OAIV;AAAA,IACJ,MAAM,CACJ,SACA,OACG;AACH,YAAM,cAAc,CAAC,GAAG,UAAU,EAAE,SAAS,IAAI;AAEjD,aAAO;AAAA,QACL,MAAM,UAAuB;AAAA,QAC7B,MAAM,MAAM;AACV,qBAAW,KAAK,aAAa;AAC3B,gBAAI,MAAM,SAAS,EAAE,SAAS;AAC5B,oBAAMA,MAAK,EAAE;AACb,qBAAOA,IAAG,KAAK;AAAA,YACjB;AAAA,UACF;AACA,gBAAM,IAAI;AAAA,YACR,sBAAsB,OAAQ,MAA4B,IAAI,CAAC;AAAA,UAAA;AAAA,QAEnE;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,MAAM,MAAM;AAEV,iBAAW,KAAK,UAAU;AACxB,YAAI,MAAM,SAAS,EAAE,SAAS;AAC5B,gBAAM,KAAK,EAAE;AACb,iBAAO,GAAG,KAAK;AAAA,QACjB;AAAA,MACF;AAEA,YAAM,IAAI;AAAA,QACR,sBAAsB,OAAQ,MAA4B,IAAI,CAAC;AAAA,MAAA;AAAA,IAEnE;AAAA,EAAA;AAGF,SAAO,QAAA;AACT;;"}
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ const object = require("../internal/object.js");
3
+ const getPayloadKeys = (config) => {
4
+ const p = config.payload;
5
+ if (p === "never") return [];
6
+ return Array.isArray(p) ? p : [p];
7
+ };
8
+ const refineAsyncResult = (variantMap) => (variant) => (validators) => async (value) => {
9
+ if (!object.isObject(value)) return null;
10
+ if (!object.hasOwn(value, "type")) return null;
11
+ const t = value["type"];
12
+ if (t !== variant) return null;
13
+ const config = variantMap[variant];
14
+ if (!config) return null;
15
+ const keys = getPayloadKeys(config);
16
+ for (const key of keys) {
17
+ const check = validators?.[key];
18
+ if (!check) continue;
19
+ const field = value[key];
20
+ const isValid = await check(field);
21
+ if (!isValid) return null;
22
+ }
23
+ return value;
24
+ };
25
+ exports.refineAsyncResult = refineAsyncResult;
26
+ //# sourceMappingURL=refineAsyncResult.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refineAsyncResult.js","sources":["../../../src/refiners/refineAsyncResult.ts"],"sourcesContent":["import type {\n AsyncValidatorFn,\n PayloadKeys,\n VariantConfig,\n} from '../shared-types.js';\n\nimport { hasOwn, isObject } from '../internal/object.js';\nimport type { UniversalAsyncRefinedResult } from './types/index.js';\n\n/** Resolves payload keys from variant configuration. @internal */\nconst getPayloadKeys = <C extends VariantConfig>(\n config: C,\n): readonly PayloadKeys<C>[] => {\n const p = config.payload;\n if (p === 'never') return [];\n return (Array.isArray(p) ? p : [p]) as readonly PayloadKeys<C>[];\n};\n\n/**\n * Создает асинхронный refiner варианта с асинхронными валидаторами payload.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @param variantMap - Карта, описывающая допустимые варианты и поля payload.\n * @returns A curried async refiner factory bound to `variantMap`.\n * @since 0.1.0\n * @see {@link refineAsyncResultU} - Непосредственный (не-curry) вариант helper.\n * @example\n * ```ts\n * import { refineAsyncResult } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const refineOk = refineAsyncResult(map)('ok')({\n * value: async (x: unknown) => typeof x === 'number',\n * });\n *\n * console.log(await refineOk({ type: 'ok', value: 1 })); // { type: 'ok', value: 1 }\n * ```\n * @public\n */\nexport const refineAsyncResult =\n <TMap extends Record<string, VariantConfig>>(variantMap: TMap) =>\n <K extends keyof TMap & string>(variant: K) =>\n <TValidators extends Partial<Record<PayloadKeys<TMap[K]>, AsyncValidatorFn>>>(\n validators: TValidators,\n ) =>\n async (\n value: unknown,\n ): Promise<UniversalAsyncRefinedResult<K, TMap, TValidators> | null> => {\n if (!isObject(value)) return null;\n if (!hasOwn(value, 'type')) return null;\n\n const t = value['type'];\n if (t !== variant) return null;\n\n const config = variantMap[variant];\n if (!config) return null;\n\n const keys = getPayloadKeys(config);\n for (const key of keys) {\n const check = validators?.[key];\n if (!check) continue;\n\n const field = value[key as keyof typeof value];\n const isValid = await check(field); // ✅ Асинхронная валидация\n if (!isValid) return null;\n }\n\n return value as UniversalAsyncRefinedResult<K, TMap, TValidators>;\n };\n\n/**\n * Уточняет значение асинхронно в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта асинхронных валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Асинхронные валидаторы payload.\n * @returns Промис с уточненным значением или `null`.\n * @remarks\n * This export is kept for compatibility. Prefer {@link refineAsyncResultU}\n * from `refineAsyncResultU.ts` как каноническую точку входа без curry.\n * @since 0.1.0\n * @example\n * ```ts\n * import { refineAsyncResultU } from '@resultsafe/core-fp-result/src/refiners/refineAsyncResult.js';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = await refineAsyncResultU({ type: 'ok', value: 1 }, 'ok', map, {\n * value: async (x: unknown) => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @internal\n */\nexport const refineAsyncResultU = <\n TMap extends Record<string, VariantConfig>,\n K extends keyof TMap & string,\n TValidators extends Partial<Record<PayloadKeys<TMap[K]>, AsyncValidatorFn>>,\n>(\n value: unknown,\n variant: K,\n variantMap: TMap,\n validators: TValidators,\n): Promise<UniversalAsyncRefinedResult<K, TMap, TValidators> | null> =>\n refineAsyncResult(variantMap)(variant)(validators)(value);\n\r\n\r\n"],"names":["isObject","hasOwn"],"mappings":";;AAUA,MAAM,iBAAiB,CACrB,WAC8B;AAC9B,QAAM,IAAI,OAAO;AACjB,MAAI,MAAM,QAAS,QAAO,CAAA;AAC1B,SAAQ,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;AACnC;AAuBO,MAAM,oBACX,CAA6C,eAC7C,CAAgC,YAChC,CACE,eAEF,OACE,UACsE;AACtE,MAAI,CAACA,OAAAA,SAAS,KAAK,EAAG,QAAO;AAC7B,MAAI,CAACC,OAAAA,OAAO,OAAO,MAAM,EAAG,QAAO;AAEnC,QAAM,IAAI,MAAM,MAAM;AACtB,MAAI,MAAM,QAAS,QAAO;AAE1B,QAAM,SAAS,WAAW,OAAO;AACjC,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,OAAO,eAAe,MAAM;AAClC,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,aAAa,GAAG;AAC9B,QAAI,CAAC,MAAO;AAEZ,UAAM,QAAQ,MAAM,GAAyB;AAC7C,UAAM,UAAU,MAAM,MAAM,KAAK;AACjC,QAAI,CAAC,QAAS,QAAO;AAAA,EACvB;AAEA,SAAO;AACT;;"}
@@ -0,0 +1,28 @@
1
+ "use strict";
2
+ const object = require("../internal/object.js");
3
+ const getPayloadKeys = (config) => {
4
+ const p = config.payload;
5
+ if (p === "never") return [];
6
+ return Array.isArray(p) ? p : [p];
7
+ };
8
+ const refineAsyncResultU = (value, variant, variantMap, validators) => {
9
+ return (async () => {
10
+ if (!object.isObject(value)) return null;
11
+ if (!object.hasOwn(value, "type")) return null;
12
+ const t = value["type"];
13
+ if (t !== variant) return null;
14
+ const config = variantMap[variant];
15
+ if (!config) return null;
16
+ const keys = getPayloadKeys(config);
17
+ for (const key of keys) {
18
+ const check = validators[key];
19
+ if (!check) continue;
20
+ const field = value[key];
21
+ const isValid = await check(field);
22
+ if (!isValid) return null;
23
+ }
24
+ return value;
25
+ })();
26
+ };
27
+ exports.refineAsyncResultU = refineAsyncResultU;
28
+ //# sourceMappingURL=refineAsyncResultU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refineAsyncResultU.js","sources":["../../../src/refiners/refineAsyncResultU.ts"],"sourcesContent":["import type {\n AsyncValidatorFn,\n PayloadKeys,\n VariantConfig,\n} from '../shared-types.js';\n\nimport { hasOwn, isObject } from '../internal/object.js';\nimport type { UniversalAsyncRefinedResult } from './types/index.js';\n\n/** Resolves payload keys from variant configuration. @internal */\nconst getPayloadKeys = <C extends VariantConfig>(\n config: C,\n): readonly PayloadKeys<C>[] => {\n const p = config.payload;\n if (p === 'never') return [];\n return (Array.isArray(p) ? p : [p]) as readonly PayloadKeys<C>[];\n};\n\n/**\n * Уточняет значение асинхронно в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта асинхронных валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Асинхронные валидаторы payload.\n * @returns Промис с уточненным значением или `null`.\n * @since 0.1.0\n * @see {@link refineAsyncResult} - Curry-конструктор асинхронного refiner.\n * @example\n * ```ts\n * import { refineAsyncResultU } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = await refineAsyncResultU({ type: 'ok', value: 1 }, 'ok', map, {\n * value: async (x: unknown) => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @public\n */\nexport const refineAsyncResultU = <\n TMap extends Record<string, VariantConfig>,\n K extends keyof TMap & string,\n TValidators extends Partial<Record<PayloadKeys<TMap[K]>, AsyncValidatorFn>>,\n>(\n value: unknown,\n variant: K,\n variantMap: TMap,\n validators: TValidators,\n): Promise<UniversalAsyncRefinedResult<K, TMap, TValidators> | null> => {\n // Императивный стиль с early returns (как в Rust)\n return (async () => {\n // Rust-style early returns с Option-like поведением\n if (!isObject(value)) return null;\n if (!hasOwn(value, 'type')) return null;\n\n const t = value['type'];\n if (t !== variant) return null;\n\n const config = variantMap[variant];\n if (!config) return null;\n\n // Payload validation с асинхронными валидаторами\n const keys = getPayloadKeys(config);\n for (const key of keys) {\n const check = validators[key as keyof TValidators];\n if (!check) continue;\n\n const field = value[key as string];\n // Type-safe async validation\n const isValid = await (check as AsyncValidatorFn)(field);\n if (!isValid) return null;\n }\n\n // Safe cast после всех проверок\n return value as UniversalAsyncRefinedResult<K, TMap, TValidators>;\n })();\n};\n\r\n\r\n"],"names":["isObject","hasOwn"],"mappings":";;AAUA,MAAM,iBAAiB,CACrB,WAC8B;AAC9B,QAAM,IAAI,OAAO;AACjB,MAAI,MAAM,QAAS,QAAO,CAAA;AAC1B,SAAQ,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;AACnC;AA4BO,MAAM,qBAAqB,CAKhC,OACA,SACA,YACA,eACsE;AAEtE,UAAQ,YAAY;AAElB,QAAI,CAACA,OAAAA,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAI,CAACC,OAAAA,OAAO,OAAO,MAAM,EAAG,QAAO;AAEnC,UAAM,IAAI,MAAM,MAAM;AACtB,QAAI,MAAM,QAAS,QAAO;AAE1B,UAAM,SAAS,WAAW,OAAO;AACjC,QAAI,CAAC,OAAQ,QAAO;AAGpB,UAAM,OAAO,eAAe,MAAM;AAClC,eAAW,OAAO,MAAM;AACtB,YAAM,QAAQ,WAAW,GAAwB;AACjD,UAAI,CAAC,MAAO;AAEZ,YAAM,QAAQ,MAAM,GAAa;AAEjC,YAAM,UAAU,MAAO,MAA2B,KAAK;AACvD,UAAI,CAAC,QAAS,QAAO;AAAA,IACvB;AAGA,WAAO;AAAA,EACT,GAAA;AACF;;"}
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+ const object = require("../internal/object.js");
3
+ const getPayloadKeys = require("./utils/getPayloadKeys.js");
4
+ const refineResult = (variantMap) => (variant) => (validators) => (value) => {
5
+ if (!object.isObject(value)) return null;
6
+ if (!object.hasOwn(value, "type")) return null;
7
+ const t = value["type"];
8
+ if (t !== variant) return null;
9
+ const config = variantMap[variant];
10
+ if (!config) return null;
11
+ const keys = getPayloadKeys.getPayloadKeys(config);
12
+ for (const key of keys) {
13
+ const check = validators?.[key];
14
+ if (!check) continue;
15
+ const field = value[key];
16
+ if (!check(field)) return null;
17
+ }
18
+ return value;
19
+ };
20
+ exports.refineResult = refineResult;
21
+ //# sourceMappingURL=refineResult.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refineResult.js","sources":["../../../src/refiners/refineResult.ts"],"sourcesContent":["import type {\n PayloadKeys,\n ValidatorFn,\n VariantConfig,\n} from '../shared-types.js';\n\nimport { hasOwn, isObject } from '../internal/object.js';\nimport type { UniversalRefinedResult } from './types/index.js';\nimport { getPayloadKeys } from './utils/index.js';\n\n/**\n * Создает синхронный refiner варианта с валидаторами payload.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @param variantMap - Карта, описывающая допустимые варианты и поля payload.\n * @returns A curried refiner factory bound to `variantMap`.\n * @since 0.1.0\n * @see {@link refineResultU} - Непосредственный (не-curry) вариант helper.\n * @example\n * ```ts\n * import { refineResult } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const refineOk = refineResult(map)('ok')({\n * value: (x: unknown): x is number => typeof x === 'number',\n * });\n *\n * console.log(refineOk({ type: 'ok', value: 1 })); // { type: 'ok', value: 1 }\n * ```\n * @public\n */\nexport const refineResult =\n <TMap extends Record<string, VariantConfig>>(variantMap: TMap) =>\n <K extends keyof TMap & string>(variant: K) =>\n <TValidators extends Partial<Record<PayloadKeys<TMap[K]>, ValidatorFn>>>(\n validators: TValidators,\n ) =>\n (value: unknown): UniversalRefinedResult<K, TMap, TValidators> | null => {\n if (!isObject(value)) return null;\n if (!hasOwn(value, 'type')) return null;\n\n const t = value['type'];\n if (t !== variant) return null;\n\n const config = variantMap[variant];\n if (!config) return null;\n\n const keys = getPayloadKeys(config);\n for (const key of keys) {\n const check = validators?.[key];\n if (!check) continue;\n\n const field = value[key as keyof typeof value];\n if (!check(field)) return null;\n }\n\n return value as UniversalRefinedResult<K, TMap, TValidators>;\n };\n\n/**\n * Уточняет значение по карте вариантов в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Валидаторы payload для целевого варианта.\n * @returns Уточненное значение или `null`.\n * @remarks\n * Этот экспорт сохранен для совместимости. Предпочитайте {@link refineResultU} из\n * `refineResultU.ts` как каноническую точку входа без curry.\n * @since 0.1.0\n * @example\n * ```ts\n * import { refineResultU } from '@resultsafe/core-fp-result/src/refiners/refineResult.js';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = refineResultU({ type: 'ok', value: 1 }, 'ok', map, {\n * value: (x: unknown): x is number => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @internal\n */\nexport const refineResultU = <\n TMap extends Record<string, VariantConfig>,\n K extends keyof TMap & string,\n TValidators extends Partial<Record<PayloadKeys<TMap[K]>, ValidatorFn>>,\n>(\n value: unknown,\n variant: K,\n variantMap: TMap,\n validators: TValidators,\n): UniversalRefinedResult<K, TMap, TValidators> | null =>\n refineResult(variantMap)(variant)(validators)(value);\n\r\n\r\n"],"names":["isObject","hasOwn","getPayloadKeys"],"mappings":";;;AA+BO,MAAM,eACX,CAA6C,eAC7C,CAAgC,YAChC,CACE,eAEF,CAAC,UAAwE;AACvE,MAAI,CAACA,OAAAA,SAAS,KAAK,EAAG,QAAO;AAC7B,MAAI,CAACC,OAAAA,OAAO,OAAO,MAAM,EAAG,QAAO;AAEnC,QAAM,IAAI,MAAM,MAAM;AACtB,MAAI,MAAM,QAAS,QAAO;AAE1B,QAAM,SAAS,WAAW,OAAO;AACjC,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,OAAOC,eAAAA,eAAe,MAAM;AAClC,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,aAAa,GAAG;AAC9B,QAAI,CAAC,MAAO;AAEZ,UAAM,QAAQ,MAAM,GAAyB;AAC7C,QAAI,CAAC,MAAM,KAAK,EAAG,QAAO;AAAA,EAC5B;AAEA,SAAO;AACT;;"}
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ const refineResult = require("./refineResult.js");
3
+ const refineResultU = (value, variant, variantMap, validators) => refineResult.refineResult(variantMap)(variant)(validators)(value);
4
+ exports.refineResultU = refineResultU;
5
+ //# sourceMappingURL=refineResultU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refineResultU.js","sources":["../../../src/refiners/refineResultU.ts"],"sourcesContent":["import type {\n PayloadKeys,\n ValidatorFn,\n VariantConfig,\n} from '../shared-types.js';\n\nimport { refineResult } from './refineResult.js';\nimport type { SyncRefinedResult } from './types/index.js';\n\n/**\n * Уточняет значение по карте вариантов в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Валидаторы payload для целевого варианта.\n * @returns Уточненное значение или `null`.\n * @since 0.1.0\n * @see {@link refineResult} - Curry-конструктор refiner.\n * @example\n * ```ts\n * import { refineResultU } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = refineResultU({ type: 'ok', value: 1 }, 'ok', map, {\n * value: (x: unknown): x is number => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @public\n */\nexport const refineResultU = <\n TMap extends Record<string, VariantConfig>,\n K extends keyof TMap & string,\n TValidators extends Partial<Record<PayloadKeys<TMap[K]>, ValidatorFn>>,\n>(\n value: unknown,\n variant: K,\n variantMap: TMap,\n validators: TValidators,\n): SyncRefinedResult<K, TMap, TValidators> | null =>\n refineResult(variantMap)(variant)(validators)(value);\n\r\n\r\n"],"names":["refineResult"],"mappings":";;AAmCO,MAAM,gBAAgB,CAK3B,OACA,SACA,YACA,eAEAA,0BAAa,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK;;"}
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ function refineVariantMap(value, variantMap, validators) {
3
+ if (typeof value !== "object" || value === null || !("type" in value)) {
4
+ return null;
5
+ }
6
+ const rawType = value.type;
7
+ if (typeof rawType !== "string" || !(rawType in variantMap)) return null;
8
+ const k = rawType;
9
+ const config = variantMap[k];
10
+ if (!config) return null;
11
+ const payload = config.payload;
12
+ const keys = payload === "never" ? [] : Array.isArray(payload) ? payload : [payload];
13
+ const vvs = validators[k];
14
+ if (vvs) {
15
+ const obj = value;
16
+ for (const key of keys) {
17
+ const check = vvs[key];
18
+ if (!check) continue;
19
+ if (!check(obj[key])) return null;
20
+ }
21
+ }
22
+ return value;
23
+ }
24
+ exports.refineVariantMap = refineVariantMap;
25
+ //# sourceMappingURL=refineVariantMap.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refineVariantMap.js","sources":["../../../src/refiners/refineVariantMap.ts"],"sourcesContent":["import type {\n PayloadKeys,\n ValidatorFn,\n VariantConfig,\n} from '../shared-types.js';\n\nimport type { SyncRefinedResultUnion } from './types/SyncRefinedResultUnion.js';\nimport type { SyncValidatorMap } from './types/SyncValidatorMap.js';\n\n/**\n * Уточняет значение дискриминированного объединения по полной карте вариантов.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam TValidators - Тип карты валидаторов по вариантам.\n * @param value - Значение для валидации и уточнения.\n * @param variantMap - Полная карта конфигурации вариантов.\n * @param validators - Валидаторы, сгруппированные по ключу варианта.\n * @returns Уточненный элемент объединения или `null`.\n * @since 0.1.0\n * @see {@link refineResult} - Refines one concrete variant key.\n * @example\n * ```ts\n * import { refineVariantMap } from '@resultsafe/core-fp-result';\n *\n * const map = {\n * created: { payload: 'id' },\n * failed: { payload: 'reason' },\n * } as const;\n *\n * const out = refineVariantMap({ type: 'created', id: '1' }, map, {\n * created: { id: (x: unknown): x is string => typeof x === 'string' },\n * failed: { reason: (x: unknown): x is string => typeof x === 'string' },\n * });\n *\n * console.log(out?.type); // created\n * ```\n * @public\n */\nexport function refineVariantMap<\n TMap extends Record<string, VariantConfig>,\n TValidators extends SyncValidatorMap<TMap>,\n>(\n value: unknown,\n variantMap: TMap,\n validators: TValidators,\n): SyncRefinedResultUnion<TMap, TValidators> | null {\n if (typeof value !== 'object' || value === null || !('type' in value)) {\n return null;\n }\n\n const rawType = (value as { type?: unknown }).type;\n if (typeof rawType !== 'string' || !(rawType in variantMap)) return null;\n\n // фиксируем конкретный ключ варианта\n type K = Extract<keyof TMap, string>;\n const k = rawType as K;\n\n const config = variantMap[k];\n if (!config) return null;\n\n // ключи payload для конкретного K\n const payload = config.payload;\n const keys = (\n payload === 'never' ? [] : Array.isArray(payload) ? payload : [payload]\n ) as readonly PayloadKeys<TMap[typeof k]>[];\n\n // валидаторы, согласованные с конкретным K\n const vvs = validators[k] as\n | Partial<Record<PayloadKeys<TMap[typeof k]>, ValidatorFn>>\n | undefined;\n\n if (vvs) {\n const obj = value as Record<string, unknown>;\n for (const key of keys) {\n const check = vvs[key];\n if (!check) continue;\n if (!check(obj[key as string])) return null;\n }\n }\n\n return value as SyncRefinedResultUnion<TMap, TValidators>;\n}\n\r\n\r\n"],"names":[],"mappings":";AAsCO,SAAS,iBAId,OACA,YACA,YACkD;AAClD,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,EAAE,UAAU,QAAQ;AACrE,WAAO;AAAA,EACT;AAEA,QAAM,UAAW,MAA6B;AAC9C,MAAI,OAAO,YAAY,YAAY,EAAE,WAAW,YAAa,QAAO;AAIpE,QAAM,IAAI;AAEV,QAAM,SAAS,WAAW,CAAC;AAC3B,MAAI,CAAC,OAAQ,QAAO;AAGpB,QAAM,UAAU,OAAO;AACvB,QAAM,OACJ,YAAY,UAAU,KAAK,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,OAAO;AAIxE,QAAM,MAAM,WAAW,CAAC;AAIxB,MAAI,KAAK;AACP,UAAM,MAAM;AACZ,eAAW,OAAO,MAAM;AACtB,YAAM,QAAQ,IAAI,GAAG;AACrB,UAAI,CAAC,MAAO;AACZ,UAAI,CAAC,MAAM,IAAI,GAAa,CAAC,EAAG,QAAO;AAAA,IACzC;AAAA,EACF;AAEA,SAAO;AACT;;"}
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ const getPayloadKeys = (config) => {
3
+ const p = config.payload;
4
+ if (p === "never") return [];
5
+ return Array.isArray(p) ? p : [p];
6
+ };
7
+ exports.getPayloadKeys = getPayloadKeys;
8
+ //# sourceMappingURL=getPayloadKeys.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getPayloadKeys.js","sources":["../../../../src/refiners/utils/getPayloadKeys.ts"],"sourcesContent":["import type {\n PayloadKeys,\n VariantConfig,\n} from '../../shared-types.js';\n\n/**\n * Нормализует конфигурацию payload варианта в список ключей.\n *\n * @typeParam C - Тип конфигурации варианта.\n * @param config - Конфигурация варианта с определением payload.\n * @returns Ключи payload как readonly-массив.\n * @since 0.1.0\n * @example\n * ```ts\n * import { getPayloadKeys } from '@resultsafe/core-fp-result/src/refiners/utils/getPayloadKeys.js';\n *\n * const keys = getPayloadKeys({ payload: ['id', 'meta'] } as const);\n * console.log(keys.length); // 2\n * ```\n * @internal\n */\nexport const getPayloadKeys = <C extends VariantConfig>(\n config: C,\n): readonly PayloadKeys<C>[] => {\n const p = config.payload;\n if (p === 'never') return [];\n return (Array.isArray(p) ? p : [p]) as readonly PayloadKeys<C>[];\n};\n\r\n\r\n"],"names":[],"mappings":";AAqBO,MAAM,iBAAiB,CAC5B,WAC8B;AAC9B,QAAM,IAAI,OAAO;AACjB,MAAI,MAAM,QAAS,QAAO,CAAA;AAC1B,SAAQ,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;AACnC;;"}
@@ -0,0 +1,9 @@
1
+ # API
2
+
3
+ > [Back to package README](../../README.md)
4
+
5
+ Содержание по модулям:
6
+ - [Конструкторы](./constructors/index.md)
7
+ - [Гарды](./guards/index.md)
8
+ - [Методы](./methods/index.md)
9
+ - [Рефайнеры](./refiners/index.md)
@@ -0,0 +1,58 @@
1
+ > [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
2
+
3
+ [**@resultsafe/core-fp-result v0.1.0**](../README.md)
4
+
5
+ ***
6
+
7
+ [@resultsafe/core-fp-result](../README.md) / Err
8
+
9
+ # Функция: Err()
10
+
11
+ > **Err**\<`E`, `T`\>(`error`): `Result`\<`T`, `E`\>
12
+
13
+ Создает ошибочное значение `Result` из переданного payload ошибки.
14
+
15
+ ## Параметры типа
16
+
17
+ ### E
18
+
19
+ `E`
20
+
21
+ Тип значения ошибки.
22
+
23
+ ### T
24
+
25
+ `T` = `never`
26
+
27
+ The success type for the resulting `Result`.
28
+
29
+ ## Параметры
30
+
31
+ ### error
32
+
33
+ `E`
34
+
35
+ Payload ошибки для обёртки.
36
+
37
+ ## Возвращает
38
+
39
+ `Result`\<`T`, `E`\>
40
+
41
+ A `Result` with `ok: false` and the provided `error`.
42
+
43
+ ## Начиная с версии
44
+
45
+ 0.1.0
46
+
47
+ ## См. также
48
+
49
+ [Ok](./Ok.md) - Creates a successful `Result`.
50
+
51
+ ## Пример
52
+
53
+ ```ts
54
+ import { Err } from '@resultsafe/core-fp-result';
55
+
56
+ const result = Err<string, number>('boom');
57
+ console.log(result.ok); // false
58
+ ```
@@ -0,0 +1,58 @@
1
+ > [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
2
+
3
+ [**@resultsafe/core-fp-result v0.1.0**](../README.md)
4
+
5
+ ***
6
+
7
+ [@resultsafe/core-fp-result](../README.md) / Ok
8
+
9
+ # Функция: Ok()
10
+
11
+ > **Ok**\<`T`, `E`\>(`value`): `Result`\<`T`, `E`\>
12
+
13
+ Создает успешное значение `Result` из переданного payload.
14
+
15
+ ## Параметры типа
16
+
17
+ ### T
18
+
19
+ `T`
20
+
21
+ Тип успешного значения.
22
+
23
+ ### E
24
+
25
+ `E` = `never`
26
+
27
+ The error type for the resulting `Result`.
28
+
29
+ ## Параметры
30
+
31
+ ### value
32
+
33
+ `T`
34
+
35
+ Payload успеха для обёртки.
36
+
37
+ ## Возвращает
38
+
39
+ `Result`\<`T`, `E`\>
40
+
41
+ A `Result` with `ok: true` and the provided `value`.
42
+
43
+ ## Начиная с версии
44
+
45
+ 0.1.0
46
+
47
+ ## См. также
48
+
49
+ [Err](./Err.md) - Creates an error `Result`.
50
+
51
+ ## Пример
52
+
53
+ ```ts
54
+ import { Ok } from '@resultsafe/core-fp-result';
55
+
56
+ const result = Ok<number, string>(42);
57
+ console.log(result.ok); // true
58
+ ```
@@ -0,0 +1,7 @@
1
+ # Конструкторы
2
+
3
+ > [Back to package README](../../../README.md) | [Back to API index](../index.md)
4
+
5
+ Символы модуля:
6
+ - [Err](./Err.md)
7
+ - [Ok](./Ok.md)
@@ -0,0 +1,9 @@
1
+ # Гарды
2
+
3
+ > [Back to package README](../../../README.md) | [Back to API index](../index.md)
4
+
5
+ Символы модуля:
6
+ - [isErr](./isErr.md)
7
+ - [isErrAnd](./isErrAnd.md)
8
+ - [isOk](./isOk.md)
9
+ - [isOkAnd](./isOkAnd.md)