@clayroach/effect 3.19.14-source-capture.7 → 3.19.14-source-capture.8

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 (371) hide show
  1. package/dist/cjs/Utils.js +1 -1
  2. package/dist/cjs/Utils.js.map +1 -1
  3. package/dist/cjs/internal/clock.js +1 -1
  4. package/dist/cjs/internal/clock.js.map +1 -1
  5. package/dist/esm/Utils.js +1 -1
  6. package/dist/esm/Utils.js.map +1 -1
  7. package/dist/esm/internal/clock.js +1 -1
  8. package/dist/esm/internal/clock.js.map +1 -1
  9. package/package.json +1 -1
  10. package/src/Arbitrary.ts +0 -1101
  11. package/src/Array.ts +0 -3589
  12. package/src/BigDecimal.ts +0 -1349
  13. package/src/BigInt.ts +0 -643
  14. package/src/Boolean.ts +0 -287
  15. package/src/Brand.ts +0 -360
  16. package/src/Cache.ts +0 -281
  17. package/src/Cause.ts +0 -1555
  18. package/src/Channel.ts +0 -2355
  19. package/src/ChildExecutorDecision.ts +0 -146
  20. package/src/Chunk.ts +0 -1495
  21. package/src/Clock.ts +0 -111
  22. package/src/Config.ts +0 -542
  23. package/src/ConfigError.ts +0 -270
  24. package/src/ConfigProvider.ts +0 -333
  25. package/src/ConfigProviderPathPatch.ts +0 -100
  26. package/src/Console.ts +0 -226
  27. package/src/Context.ts +0 -585
  28. package/src/Cron.ts +0 -706
  29. package/src/Data.ts +0 -596
  30. package/src/DateTime.ts +0 -1686
  31. package/src/DefaultServices.ts +0 -34
  32. package/src/Deferred.ts +0 -301
  33. package/src/Differ.ts +0 -450
  34. package/src/Duration.ts +0 -1000
  35. package/src/Effect.ts +0 -14839
  36. package/src/Effectable.ts +0 -107
  37. package/src/Either.ts +0 -1040
  38. package/src/Encoding.ts +0 -195
  39. package/src/Equal.ts +0 -98
  40. package/src/Equivalence.ts +0 -235
  41. package/src/ExecutionPlan.ts +0 -308
  42. package/src/ExecutionStrategy.ts +0 -119
  43. package/src/Exit.ts +0 -467
  44. package/src/FastCheck.ts +0 -9
  45. package/src/Fiber.ts +0 -744
  46. package/src/FiberHandle.ts +0 -540
  47. package/src/FiberId.ts +0 -195
  48. package/src/FiberMap.ts +0 -656
  49. package/src/FiberRef.ts +0 -431
  50. package/src/FiberRefs.ts +0 -204
  51. package/src/FiberRefsPatch.ts +0 -105
  52. package/src/FiberSet.ts +0 -491
  53. package/src/FiberStatus.ts +0 -108
  54. package/src/Function.ts +0 -1222
  55. package/src/GlobalValue.ts +0 -53
  56. package/src/Graph.ts +0 -3732
  57. package/src/GroupBy.ts +0 -103
  58. package/src/HKT.ts +0 -45
  59. package/src/Hash.ts +0 -195
  60. package/src/HashMap.ts +0 -519
  61. package/src/HashRing.ts +0 -317
  62. package/src/HashSet.ts +0 -2346
  63. package/src/Inspectable.ts +0 -287
  64. package/src/Iterable.ts +0 -1119
  65. package/src/JSONSchema.ts +0 -1044
  66. package/src/KeyedPool.ts +0 -167
  67. package/src/Layer.ts +0 -1251
  68. package/src/LayerMap.ts +0 -436
  69. package/src/List.ts +0 -977
  70. package/src/LogLevel.ts +0 -285
  71. package/src/LogSpan.ts +0 -25
  72. package/src/Logger.ts +0 -702
  73. package/src/Mailbox.ts +0 -268
  74. package/src/ManagedRuntime.ts +0 -180
  75. package/src/Match.ts +0 -1477
  76. package/src/MergeDecision.ts +0 -95
  77. package/src/MergeState.ts +0 -172
  78. package/src/MergeStrategy.ts +0 -107
  79. package/src/Metric.ts +0 -780
  80. package/src/MetricBoundaries.ts +0 -69
  81. package/src/MetricHook.ts +0 -151
  82. package/src/MetricKey.ts +0 -224
  83. package/src/MetricKeyType.ts +0 -262
  84. package/src/MetricLabel.ts +0 -47
  85. package/src/MetricPair.ts +0 -71
  86. package/src/MetricPolling.ts +0 -148
  87. package/src/MetricRegistry.ts +0 -48
  88. package/src/MetricState.ts +0 -257
  89. package/src/Micro.ts +0 -4405
  90. package/src/ModuleVersion.ts +0 -18
  91. package/src/MutableHashMap.ts +0 -411
  92. package/src/MutableHashSet.ts +0 -706
  93. package/src/MutableList.ts +0 -297
  94. package/src/MutableQueue.ts +0 -227
  95. package/src/MutableRef.ts +0 -202
  96. package/src/NonEmptyIterable.ts +0 -32
  97. package/src/Number.ts +0 -1071
  98. package/src/Option.ts +0 -2170
  99. package/src/Order.ts +0 -373
  100. package/src/Ordering.ts +0 -111
  101. package/src/ParseResult.ts +0 -2031
  102. package/src/PartitionedSemaphore.ts +0 -200
  103. package/src/Pipeable.ts +0 -566
  104. package/src/Pool.ts +0 -204
  105. package/src/Predicate.ts +0 -1405
  106. package/src/Pretty.ts +0 -205
  107. package/src/PrimaryKey.ts +0 -23
  108. package/src/PubSub.ts +0 -182
  109. package/src/Queue.ts +0 -644
  110. package/src/Random.ts +0 -204
  111. package/src/RateLimiter.ts +0 -138
  112. package/src/RcMap.ts +0 -141
  113. package/src/RcRef.ts +0 -122
  114. package/src/Readable.ts +0 -93
  115. package/src/Record.ts +0 -1274
  116. package/src/RedBlackTree.ts +0 -421
  117. package/src/Redacted.ts +0 -144
  118. package/src/Ref.ts +0 -180
  119. package/src/RegExp.ts +0 -38
  120. package/src/Reloadable.ts +0 -127
  121. package/src/Request.ts +0 -347
  122. package/src/RequestBlock.ts +0 -118
  123. package/src/RequestResolver.ts +0 -366
  124. package/src/Resource.ts +0 -119
  125. package/src/Runtime.ts +0 -383
  126. package/src/RuntimeFlags.ts +0 -368
  127. package/src/RuntimeFlagsPatch.ts +0 -183
  128. package/src/STM.ts +0 -2045
  129. package/src/Schedule.ts +0 -2219
  130. package/src/ScheduleDecision.ts +0 -62
  131. package/src/ScheduleInterval.ts +0 -151
  132. package/src/ScheduleIntervals.ts +0 -122
  133. package/src/Scheduler.ts +0 -353
  134. package/src/Schema.ts +0 -10914
  135. package/src/SchemaAST.ts +0 -3043
  136. package/src/Scope.ts +0 -204
  137. package/src/ScopedCache.ts +0 -151
  138. package/src/ScopedRef.ts +0 -117
  139. package/src/Secret.ts +0 -88
  140. package/src/SingleProducerAsyncInput.ts +0 -67
  141. package/src/Sink.ts +0 -1461
  142. package/src/SortedMap.ts +0 -287
  143. package/src/SortedSet.ts +0 -390
  144. package/src/Stream.ts +0 -6468
  145. package/src/StreamEmit.ts +0 -136
  146. package/src/StreamHaltStrategy.ts +0 -123
  147. package/src/Streamable.ts +0 -45
  148. package/src/String.ts +0 -778
  149. package/src/Struct.ts +0 -243
  150. package/src/Subscribable.ts +0 -100
  151. package/src/SubscriptionRef.ts +0 -298
  152. package/src/Supervisor.ts +0 -240
  153. package/src/Symbol.ts +0 -29
  154. package/src/SynchronizedRef.ts +0 -270
  155. package/src/TArray.ts +0 -495
  156. package/src/TDeferred.ts +0 -100
  157. package/src/TMap.ts +0 -515
  158. package/src/TPriorityQueue.ts +0 -223
  159. package/src/TPubSub.ts +0 -200
  160. package/src/TQueue.ts +0 -432
  161. package/src/TRandom.ts +0 -129
  162. package/src/TReentrantLock.ts +0 -224
  163. package/src/TRef.ts +0 -178
  164. package/src/TSemaphore.ts +0 -129
  165. package/src/TSet.ts +0 -365
  166. package/src/TSubscriptionRef.ts +0 -192
  167. package/src/Take.ts +0 -258
  168. package/src/TestAnnotation.ts +0 -158
  169. package/src/TestAnnotationMap.ts +0 -119
  170. package/src/TestAnnotations.ts +0 -117
  171. package/src/TestClock.ts +0 -556
  172. package/src/TestConfig.ts +0 -47
  173. package/src/TestContext.ts +0 -36
  174. package/src/TestLive.ts +0 -53
  175. package/src/TestServices.ts +0 -390
  176. package/src/TestSized.ts +0 -55
  177. package/src/Tracer.ts +0 -198
  178. package/src/Trie.ts +0 -840
  179. package/src/Tuple.ts +0 -305
  180. package/src/Types.ts +0 -353
  181. package/src/Unify.ts +0 -113
  182. package/src/UpstreamPullRequest.ts +0 -117
  183. package/src/UpstreamPullStrategy.ts +0 -121
  184. package/src/Utils.ts +0 -809
  185. package/src/index.ts +0 -1561
  186. package/src/internal/array.ts +0 -8
  187. package/src/internal/blockedRequests.ts +0 -520
  188. package/src/internal/cache.ts +0 -733
  189. package/src/internal/cause.ts +0 -1050
  190. package/src/internal/channel/channelExecutor.ts +0 -1200
  191. package/src/internal/channel/channelState.ts +0 -134
  192. package/src/internal/channel/childExecutorDecision.ts +0 -96
  193. package/src/internal/channel/continuation.ts +0 -200
  194. package/src/internal/channel/mergeDecision.ts +0 -113
  195. package/src/internal/channel/mergeState.ts +0 -120
  196. package/src/internal/channel/mergeStrategy.ts +0 -72
  197. package/src/internal/channel/singleProducerAsyncInput.ts +0 -259
  198. package/src/internal/channel/subexecutor.ts +0 -229
  199. package/src/internal/channel/upstreamPullRequest.ts +0 -84
  200. package/src/internal/channel/upstreamPullStrategy.ts +0 -87
  201. package/src/internal/channel.ts +0 -2603
  202. package/src/internal/clock.ts +0 -95
  203. package/src/internal/completedRequestMap.ts +0 -9
  204. package/src/internal/concurrency.ts +0 -54
  205. package/src/internal/config.ts +0 -716
  206. package/src/internal/configError.ts +0 -304
  207. package/src/internal/configProvider/pathPatch.ts +0 -97
  208. package/src/internal/configProvider.ts +0 -799
  209. package/src/internal/console.ts +0 -153
  210. package/src/internal/context.ts +0 -337
  211. package/src/internal/core-effect.ts +0 -2293
  212. package/src/internal/core-stream.ts +0 -998
  213. package/src/internal/core.ts +0 -3273
  214. package/src/internal/data.ts +0 -36
  215. package/src/internal/dataSource.ts +0 -327
  216. package/src/internal/dateTime.ts +0 -1277
  217. package/src/internal/defaultServices/console.ts +0 -100
  218. package/src/internal/defaultServices.ts +0 -163
  219. package/src/internal/deferred.ts +0 -46
  220. package/src/internal/differ/chunkPatch.ts +0 -211
  221. package/src/internal/differ/contextPatch.ts +0 -232
  222. package/src/internal/differ/hashMapPatch.ts +0 -220
  223. package/src/internal/differ/hashSetPatch.ts +0 -176
  224. package/src/internal/differ/orPatch.ts +0 -311
  225. package/src/internal/differ/readonlyArrayPatch.ts +0 -210
  226. package/src/internal/differ.ts +0 -200
  227. package/src/internal/doNotation.ts +0 -80
  228. package/src/internal/effect/circular.ts +0 -905
  229. package/src/internal/effectable.ts +0 -131
  230. package/src/internal/either.ts +0 -110
  231. package/src/internal/encoding/base64.ts +0 -286
  232. package/src/internal/encoding/base64Url.ts +0 -29
  233. package/src/internal/encoding/common.ts +0 -51
  234. package/src/internal/encoding/hex.ts +0 -315
  235. package/src/internal/errors.ts +0 -7
  236. package/src/internal/executionPlan.ts +0 -114
  237. package/src/internal/executionStrategy.ts +0 -74
  238. package/src/internal/fiber.ts +0 -388
  239. package/src/internal/fiberId.ts +0 -267
  240. package/src/internal/fiberMessage.ts +0 -82
  241. package/src/internal/fiberRefs/patch.ts +0 -144
  242. package/src/internal/fiberRefs.ts +0 -297
  243. package/src/internal/fiberRuntime.ts +0 -3915
  244. package/src/internal/fiberScope.ts +0 -71
  245. package/src/internal/fiberStatus.ts +0 -119
  246. package/src/internal/groupBy.ts +0 -530
  247. package/src/internal/hashMap/array.ts +0 -49
  248. package/src/internal/hashMap/bitwise.ts +0 -32
  249. package/src/internal/hashMap/config.ts +0 -14
  250. package/src/internal/hashMap/keySet.ts +0 -8
  251. package/src/internal/hashMap/node.ts +0 -391
  252. package/src/internal/hashMap.ts +0 -586
  253. package/src/internal/hashSet.ts +0 -323
  254. package/src/internal/keyedPool.ts +0 -244
  255. package/src/internal/layer/circular.ts +0 -228
  256. package/src/internal/layer.ts +0 -1487
  257. package/src/internal/logSpan.ts +0 -20
  258. package/src/internal/logger-circular.ts +0 -24
  259. package/src/internal/logger.ts +0 -485
  260. package/src/internal/mailbox.ts +0 -561
  261. package/src/internal/managedRuntime/circular.ts +0 -6
  262. package/src/internal/managedRuntime.ts +0 -134
  263. package/src/internal/matcher.ts +0 -652
  264. package/src/internal/metric/boundaries.ts +0 -75
  265. package/src/internal/metric/hook.ts +0 -483
  266. package/src/internal/metric/key.ts +0 -167
  267. package/src/internal/metric/keyType.ts +0 -238
  268. package/src/internal/metric/label.ts +0 -41
  269. package/src/internal/metric/pair.ts +0 -48
  270. package/src/internal/metric/polling.ts +0 -149
  271. package/src/internal/metric/registry.ts +0 -187
  272. package/src/internal/metric/state.ts +0 -290
  273. package/src/internal/metric.ts +0 -577
  274. package/src/internal/opCodes/cause.ts +0 -35
  275. package/src/internal/opCodes/channel.ts +0 -83
  276. package/src/internal/opCodes/channelChildExecutorDecision.ts +0 -17
  277. package/src/internal/opCodes/channelMergeDecision.ts +0 -11
  278. package/src/internal/opCodes/channelMergeState.ts +0 -17
  279. package/src/internal/opCodes/channelMergeStrategy.ts +0 -11
  280. package/src/internal/opCodes/channelState.ts +0 -23
  281. package/src/internal/opCodes/channelUpstreamPullRequest.ts +0 -11
  282. package/src/internal/opCodes/channelUpstreamPullStrategy.ts +0 -11
  283. package/src/internal/opCodes/config.ts +0 -65
  284. package/src/internal/opCodes/configError.ts +0 -35
  285. package/src/internal/opCodes/continuation.ts +0 -11
  286. package/src/internal/opCodes/deferred.ts +0 -11
  287. package/src/internal/opCodes/effect.ts +0 -89
  288. package/src/internal/opCodes/layer.ts +0 -59
  289. package/src/internal/opCodes/streamHaltStrategy.ts +0 -23
  290. package/src/internal/option.ts +0 -80
  291. package/src/internal/pool.ts +0 -432
  292. package/src/internal/pubsub.ts +0 -1762
  293. package/src/internal/query.ts +0 -204
  294. package/src/internal/queue.ts +0 -766
  295. package/src/internal/random.ts +0 -161
  296. package/src/internal/rateLimiter.ts +0 -93
  297. package/src/internal/rcMap.ts +0 -285
  298. package/src/internal/rcRef.ts +0 -192
  299. package/src/internal/redBlackTree/iterator.ts +0 -200
  300. package/src/internal/redBlackTree/node.ts +0 -68
  301. package/src/internal/redBlackTree.ts +0 -1245
  302. package/src/internal/redacted.ts +0 -73
  303. package/src/internal/ref.ts +0 -171
  304. package/src/internal/reloadable.ts +0 -140
  305. package/src/internal/request.ts +0 -177
  306. package/src/internal/resource.ts +0 -76
  307. package/src/internal/ringBuffer.ts +0 -68
  308. package/src/internal/runtime.ts +0 -558
  309. package/src/internal/runtimeFlags.ts +0 -188
  310. package/src/internal/runtimeFlagsPatch.ts +0 -103
  311. package/src/internal/schedule/decision.ts +0 -47
  312. package/src/internal/schedule/interval.ts +0 -101
  313. package/src/internal/schedule/intervals.ts +0 -180
  314. package/src/internal/schedule.ts +0 -2199
  315. package/src/internal/schema/errors.ts +0 -191
  316. package/src/internal/schema/schemaId.ts +0 -106
  317. package/src/internal/schema/util.ts +0 -50
  318. package/src/internal/scopedCache.ts +0 -644
  319. package/src/internal/scopedRef.ts +0 -118
  320. package/src/internal/secret.ts +0 -89
  321. package/src/internal/singleShotGen.ts +0 -35
  322. package/src/internal/sink.ts +0 -2120
  323. package/src/internal/stack.ts +0 -10
  324. package/src/internal/stm/core.ts +0 -817
  325. package/src/internal/stm/entry.ts +0 -59
  326. package/src/internal/stm/journal.ts +0 -123
  327. package/src/internal/stm/opCodes/stm.ts +0 -71
  328. package/src/internal/stm/opCodes/stmState.ts +0 -17
  329. package/src/internal/stm/opCodes/strategy.ts +0 -17
  330. package/src/internal/stm/opCodes/tExit.ts +0 -29
  331. package/src/internal/stm/opCodes/tryCommit.ts +0 -11
  332. package/src/internal/stm/stm.ts +0 -1453
  333. package/src/internal/stm/stmState.ts +0 -136
  334. package/src/internal/stm/tArray.ts +0 -550
  335. package/src/internal/stm/tDeferred.ts +0 -81
  336. package/src/internal/stm/tExit.ts +0 -190
  337. package/src/internal/stm/tMap.ts +0 -824
  338. package/src/internal/stm/tPriorityQueue.ts +0 -267
  339. package/src/internal/stm/tPubSub.ts +0 -551
  340. package/src/internal/stm/tQueue.ts +0 -393
  341. package/src/internal/stm/tRandom.ts +0 -140
  342. package/src/internal/stm/tReentrantLock.ts +0 -352
  343. package/src/internal/stm/tRef.ts +0 -195
  344. package/src/internal/stm/tSemaphore.ts +0 -113
  345. package/src/internal/stm/tSet.ts +0 -259
  346. package/src/internal/stm/tSubscriptionRef.ts +0 -286
  347. package/src/internal/stm/tryCommit.ts +0 -34
  348. package/src/internal/stm/txnId.ts +0 -14
  349. package/src/internal/stm/versioned.ts +0 -4
  350. package/src/internal/stream/debounceState.ts +0 -57
  351. package/src/internal/stream/emit.ts +0 -123
  352. package/src/internal/stream/haltStrategy.ts +0 -94
  353. package/src/internal/stream/handoff.ts +0 -187
  354. package/src/internal/stream/handoffSignal.ts +0 -59
  355. package/src/internal/stream/pull.ts +0 -34
  356. package/src/internal/stream/sinkEndReason.ts +0 -30
  357. package/src/internal/stream/zipAllState.ts +0 -88
  358. package/src/internal/stream/zipChunksState.ts +0 -56
  359. package/src/internal/stream.ts +0 -8801
  360. package/src/internal/string-utils.ts +0 -107
  361. package/src/internal/subscriptionRef.ts +0 -138
  362. package/src/internal/supervisor/patch.ts +0 -190
  363. package/src/internal/supervisor.ts +0 -303
  364. package/src/internal/synchronizedRef.ts +0 -114
  365. package/src/internal/take.ts +0 -199
  366. package/src/internal/testing/sleep.ts +0 -27
  367. package/src/internal/testing/suspendedWarningData.ts +0 -85
  368. package/src/internal/testing/warningData.ts +0 -94
  369. package/src/internal/tracer.ts +0 -293
  370. package/src/internal/trie.ts +0 -722
  371. package/src/internal/version.ts +0 -7
package/src/TestClock.ts DELETED
@@ -1,556 +0,0 @@
1
- /**
2
- * @since 2.0.0
3
- */
4
- import * as Chunk from "./Chunk.js"
5
- import type * as Clock from "./Clock.js"
6
- import * as Context from "./Context.js"
7
- import * as DateTime from "./DateTime.js"
8
- import type * as Deferred from "./Deferred.js"
9
- import * as Duration from "./Duration.js"
10
- import type * as Effect from "./Effect.js"
11
- import * as Equal from "./Equal.js"
12
- import type * as Fiber from "./Fiber.js"
13
- import type * as FiberId from "./FiberId.js"
14
- import * as FiberStatus from "./FiberStatus.js"
15
- import { constVoid, dual, identity, pipe } from "./Function.js"
16
- import * as HashMap from "./HashMap.js"
17
- import * as clock from "./internal/clock.js"
18
- import * as effect from "./internal/core-effect.js"
19
- import * as core from "./internal/core.js"
20
- import * as defaultServices from "./internal/defaultServices.js"
21
- import * as circular from "./internal/effect/circular.js"
22
- import * as fiberRuntime from "./internal/fiberRuntime.js"
23
- import * as layer from "./internal/layer.js"
24
- import * as ref from "./internal/ref.js"
25
- import * as synchronized from "./internal/synchronizedRef.js"
26
- import * as SuspendedWarningData from "./internal/testing/suspendedWarningData.js"
27
- import * as WarningData from "./internal/testing/warningData.js"
28
- import type * as Layer from "./Layer.js"
29
- import * as number from "./Number.js"
30
- import * as Option from "./Option.js"
31
- import * as Order from "./Order.js"
32
- import type * as Ref from "./Ref.js"
33
- import type * as SortedSet from "./SortedSet.js"
34
- import type * as Synchronized from "./SynchronizedRef.js"
35
- import * as Annotations from "./TestAnnotations.js"
36
- import * as Live from "./TestLive.js"
37
-
38
- /**
39
- * A `TestClock` makes it easy to deterministically and efficiently test effects
40
- * involving the passage of time.
41
- *
42
- * Instead of waiting for actual time to pass, `sleep` and methods implemented
43
- * in terms of it schedule effects to take place at a given clock time. Users
44
- * can adjust the clock time using the `adjust` and `setTime` methods, and all
45
- * effects scheduled to take place on or before that time will automatically be
46
- * run in order.
47
- *
48
- * For example, here is how we can test `Effect.timeout` using `TestClock`:
49
- *
50
- * ```ts
51
- * import * as assert from "node:assert"
52
- * import { Duration, Effect, Fiber, TestClock, Option, pipe } from "effect"
53
- *
54
- * Effect.gen(function*() {
55
- * const fiber = yield* pipe(
56
- * Effect.sleep(Duration.minutes(5)),
57
- * Effect.timeout(Duration.minutes(1)),
58
- * Effect.fork
59
- * )
60
- * yield* TestClock.adjust(Duration.minutes(1))
61
- * const result = yield* Fiber.join(fiber)
62
- * assert.deepStrictEqual(result, Option.none())
63
- * })
64
- * ```
65
- *
66
- * Note how we forked the fiber that `sleep` was invoked on. Calls to `sleep`
67
- * and methods derived from it will semantically block until the time is set to
68
- * on or after the time they are scheduled to run. If we didn't fork the fiber
69
- * on which we called sleep we would never get to set the time on the line
70
- * below. Thus, a useful pattern when using `TestClock` is to fork the effect
71
- * being tested, then adjust the clock time, and finally verify that the
72
- * expected effects have been performed.
73
- *
74
- * @since 2.0.0
75
- */
76
- export interface TestClock extends Clock.Clock {
77
- adjust(duration: Duration.DurationInput): Effect.Effect<void>
78
- adjustWith(duration: Duration.DurationInput): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>
79
- readonly save: Effect.Effect<Effect.Effect<void>>
80
- setTime(time: number): Effect.Effect<void>
81
- readonly sleeps: Effect.Effect<Chunk.Chunk<number>>
82
- }
83
-
84
- /**
85
- * `Data` represents the state of the `TestClock`, including the clock time.
86
- *
87
- * @since 2.0.1
88
- */
89
- export interface Data {
90
- readonly instant: number
91
- readonly sleeps: Chunk.Chunk<readonly [number, Deferred.Deferred<void>]>
92
- }
93
-
94
- /**
95
- * @since 2.0.0
96
- */
97
- export const makeData = (
98
- instant: number,
99
- sleeps: Chunk.Chunk<readonly [number, Deferred.Deferred<void>]>
100
- ): Data => ({
101
- instant,
102
- sleeps
103
- })
104
-
105
- /**
106
- * @since 2.0.0
107
- */
108
- export const TestClock: Context.Tag<TestClock, TestClock> = Context.GenericTag<TestClock>("effect/TestClock")
109
-
110
- /**
111
- * The warning message that will be displayed if a test is using time but is
112
- * not advancing the `TestClock`.
113
- *
114
- * @internal
115
- */
116
- const warning = "Warning: A test is using time, but is not advancing " +
117
- "the test clock, which may result in the test hanging. Use TestClock.adjust to " +
118
- "manually advance the time."
119
-
120
- /**
121
- * The warning message that will be displayed if a test is advancing the clock
122
- * but a fiber is still running.
123
- *
124
- * @internal
125
- */
126
- const suspendedWarning = "Warning: A test is advancing the test clock, " +
127
- "but a fiber is not suspending, which may result in the test hanging. Use " +
128
- "TestAspect.diagnose to identity the fiber that is not suspending."
129
-
130
- /** @internal */
131
- export class TestClockImpl implements TestClock {
132
- [clock.ClockTypeId]: Clock.ClockTypeId = clock.ClockTypeId
133
- constructor(
134
- readonly clockState: Ref.Ref<Data>,
135
- readonly live: Live.TestLive,
136
- readonly annotations: Annotations.TestAnnotations,
137
- readonly warningState: Synchronized.SynchronizedRef<WarningData.WarningData>,
138
- readonly suspendedWarningState: Synchronized.SynchronizedRef<SuspendedWarningData.SuspendedWarningData>
139
- ) {
140
- this.currentTimeMillis = core.map(
141
- ref.get(this.clockState),
142
- (data) => data.instant
143
- )
144
- this.currentTimeNanos = core.map(
145
- ref.get(this.clockState),
146
- (data) => BigInt(data.instant * 1000000)
147
- )
148
- }
149
-
150
- /**
151
- * Unsafely returns the current time in milliseconds.
152
- */
153
- unsafeCurrentTimeMillis(): number {
154
- return ref.unsafeGet(this.clockState).instant
155
- }
156
-
157
- /**
158
- * Unsafely returns the current time in nanoseconds.
159
- */
160
- unsafeCurrentTimeNanos(): bigint {
161
- return BigInt(ref.unsafeGet(this.clockState).instant * 1000000)
162
- }
163
-
164
- /**
165
- * Returns the current clock time in milliseconds.
166
- */
167
- currentTimeMillis: Effect.Effect<number>
168
-
169
- /**
170
- * Returns the current clock time in nanoseconds.
171
- */
172
- currentTimeNanos: Effect.Effect<bigint>
173
-
174
- /**
175
- * Saves the `TestClock`'s current state in an effect which, when run, will
176
- * restore the `TestClock` state to the saved state.
177
- */
178
- get save(): Effect.Effect<Effect.Effect<void>> {
179
- return core.map(ref.get(this.clockState), (data) => ref.set(this.clockState, data))
180
- }
181
- /**
182
- * Sets the current clock time to the specified instant. Any effects that
183
- * were scheduled to occur on or before the new time will be run in order.
184
- */
185
- setTime(instant: number): Effect.Effect<void> {
186
- return core.zipRight(this.warningDone(), this.run(() => instant))
187
- }
188
- /**
189
- * Semantically blocks the current fiber until the clock time is equal to or
190
- * greater than the specified duration. Once the clock time is adjusted to
191
- * on or after the duration, the fiber will automatically be resumed.
192
- */
193
- sleep(durationInput: Duration.DurationInput): Effect.Effect<void> {
194
- const duration = Duration.decode(durationInput)
195
- return core.flatMap(core.deferredMake<void>(), (deferred) =>
196
- pipe(
197
- ref.modify(this.clockState, (data) => {
198
- const end = data.instant + Duration.toMillis(duration)
199
- if (end > data.instant) {
200
- return [
201
- true,
202
- makeData(data.instant, pipe(data.sleeps, Chunk.prepend([end, deferred] as const)))
203
- ] as const
204
- }
205
- return [false, data] as const
206
- }),
207
- core.flatMap((shouldAwait) =>
208
- shouldAwait ?
209
- pipe(this.warningStart(), core.zipRight(core.deferredAwait(deferred))) :
210
- pipe(core.deferredSucceed(deferred, void 0), core.asVoid)
211
- )
212
- ))
213
- }
214
- /**
215
- * Returns a list of the times at which all queued effects are scheduled to
216
- * resume.
217
- */
218
- get sleeps(): Effect.Effect<Chunk.Chunk<number>> {
219
- return core.map(
220
- ref.get(this.clockState),
221
- (data) => Chunk.map(data.sleeps, (_) => _[0])
222
- )
223
- }
224
- /**
225
- * Increments the current clock time by the specified duration. Any effects
226
- * that were scheduled to occur on or before the new time will be run in
227
- * order.
228
- */
229
- adjust(durationInput: Duration.DurationInput): Effect.Effect<void> {
230
- const duration = Duration.decode(durationInput)
231
- return core.zipRight(this.warningDone(), this.run((n) => n + Duration.toMillis(duration)))
232
- }
233
- /**
234
- * Increments the current clock time by the specified duration. Any effects
235
- * that were scheduled to occur on or before the new time will be run in
236
- * order.
237
- */
238
- adjustWith(durationInput: Duration.DurationInput) {
239
- const duration = Duration.decode(durationInput)
240
- return <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>
241
- fiberRuntime.zipLeftOptions(effect, this.adjust(duration), { concurrent: true })
242
- }
243
- /**
244
- * Returns a set of all fibers in this test.
245
- */
246
- supervisedFibers(): Effect.Effect<SortedSet.SortedSet<Fiber.RuntimeFiber<unknown, unknown>>> {
247
- return this.annotations.supervisedFibers
248
- }
249
- /**
250
- * Captures a "snapshot" of the identifier and status of all fibers in this
251
- * test other than the current fiber. Fails with the `void` value if any of
252
- * these fibers are not done or suspended. Note that because we cannot
253
- * synchronize on the status of multiple fibers at the same time this
254
- * snapshot may not be fully consistent.
255
- */
256
- freeze(): Effect.Effect<HashMap.HashMap<FiberId.FiberId, FiberStatus.FiberStatus>, void> {
257
- return core.flatMap(this.supervisedFibers(), (fibers) =>
258
- pipe(
259
- fibers,
260
- effect.reduce(HashMap.empty<FiberId.FiberId, FiberStatus.FiberStatus>(), (map, fiber) =>
261
- pipe(
262
- fiber.status,
263
- core.flatMap((status) => {
264
- if (FiberStatus.isDone(status)) {
265
- return core.succeed(HashMap.set(map, fiber.id() as FiberId.FiberId, status as FiberStatus.FiberStatus))
266
- }
267
- if (FiberStatus.isSuspended(status)) {
268
- return core.succeed(HashMap.set(map, fiber.id() as FiberId.FiberId, status as FiberStatus.FiberStatus))
269
- }
270
- return core.fail(void 0)
271
- })
272
- ))
273
- ))
274
- }
275
- /**
276
- * Forks a fiber that will display a warning message if a test is using time
277
- * but is not advancing the `TestClock`.
278
- */
279
- warningStart(): Effect.Effect<void> {
280
- return synchronized.updateSomeEffect(this.warningState, (data) =>
281
- WarningData.isStart(data) ?
282
- Option.some(
283
- pipe(
284
- this.live.provide(
285
- pipe(effect.logWarning(warning), effect.delay(Duration.seconds(5)))
286
- ),
287
- core.interruptible,
288
- fiberRuntime.fork,
289
- core.map((fiber) => WarningData.pending(fiber))
290
- )
291
- ) :
292
- Option.none())
293
- }
294
- /**
295
- * Cancels the warning message that is displayed if a test is using time but
296
- * is not advancing the `TestClock`.
297
- */
298
- warningDone(): Effect.Effect<void> {
299
- return synchronized.updateSomeEffect(this.warningState, (warningData) => {
300
- if (WarningData.isStart(warningData)) {
301
- return Option.some(core.succeed(WarningData.done))
302
- }
303
- if (WarningData.isPending(warningData)) {
304
- return Option.some(pipe(core.interruptFiber(warningData.fiber), core.as(WarningData.done)))
305
- }
306
- return Option.none()
307
- })
308
- }
309
-
310
- private yieldTimer = core.async<void>((resume) => {
311
- const timer = setTimeout(() => {
312
- resume(core.void)
313
- }, 0)
314
- return core.sync(() => clearTimeout(timer))
315
- })
316
-
317
- /**
318
- * Returns whether all descendants of this fiber are done or suspended.
319
- */
320
- suspended(): Effect.Effect<HashMap.HashMap<FiberId.FiberId, FiberStatus.FiberStatus>, void> {
321
- return pipe(
322
- this.freeze(),
323
- core.zip(pipe(this.yieldTimer, core.zipRight(this.freeze()))),
324
- core.flatMap(([first, last]) =>
325
- Equal.equals(first, last) ?
326
- core.succeed(first) :
327
- core.fail(void 0)
328
- )
329
- )
330
- }
331
- /**
332
- * Polls until all descendants of this fiber are done or suspended.
333
- */
334
- awaitSuspended(): Effect.Effect<void> {
335
- return pipe(
336
- this.suspendedWarningStart(),
337
- core.zipRight(
338
- pipe(
339
- this.suspended(),
340
- core.zipWith(
341
- pipe(this.yieldTimer, core.zipRight(this.suspended())),
342
- Equal.equals
343
- ),
344
- effect.filterOrFail(identity, constVoid),
345
- effect.eventually
346
- )
347
- ),
348
- core.zipRight(this.suspendedWarningDone())
349
- )
350
- }
351
- /**
352
- * Forks a fiber that will display a warning message if a test is advancing
353
- * the `TestClock` but a fiber is not suspending.
354
- */
355
- suspendedWarningStart(): Effect.Effect<void> {
356
- return synchronized.updateSomeEffect(this.suspendedWarningState, (suspendedWarningData) => {
357
- if (SuspendedWarningData.isStart(suspendedWarningData)) {
358
- return Option.some(
359
- pipe(
360
- this.live.provide(
361
- pipe(
362
- effect.logWarning(suspendedWarning),
363
- core.zipRight(ref.set(this.suspendedWarningState, SuspendedWarningData.done)),
364
- effect.delay(Duration.seconds(5))
365
- )
366
- ),
367
- core.interruptible,
368
- fiberRuntime.fork,
369
- core.map((fiber) => SuspendedWarningData.pending(fiber))
370
- )
371
- )
372
- }
373
- return Option.none()
374
- })
375
- }
376
- /**
377
- * Cancels the warning message that is displayed if a test is advancing the
378
- * `TestClock` but a fiber is not suspending.
379
- */
380
- suspendedWarningDone(): Effect.Effect<void> {
381
- return synchronized.updateSomeEffect(this.suspendedWarningState, (suspendedWarningData) => {
382
- if (SuspendedWarningData.isPending(suspendedWarningData)) {
383
- return Option.some(pipe(core.interruptFiber(suspendedWarningData.fiber), core.as(SuspendedWarningData.start)))
384
- }
385
- return Option.none()
386
- })
387
- }
388
- /**
389
- * Runs all effects scheduled to occur on or before the specified instant,
390
- * which may depend on the current time, in order.
391
- */
392
- run(f: (instant: number) => number): Effect.Effect<void> {
393
- return pipe(
394
- this.awaitSuspended(),
395
- core.zipRight(pipe(
396
- ref.modify(this.clockState, (data) => {
397
- const end = f(data.instant)
398
- const sorted = pipe(
399
- data.sleeps,
400
- Chunk.sort<readonly [number, Deferred.Deferred<void>]>(
401
- pipe(number.Order, Order.mapInput((_) => _[0]))
402
- )
403
- )
404
- if (Chunk.isNonEmpty(sorted)) {
405
- const [instant, deferred] = Chunk.headNonEmpty(sorted)
406
- if (instant <= end) {
407
- return [
408
- Option.some([end, deferred] as const),
409
- makeData(instant, Chunk.tailNonEmpty(sorted))
410
- ] as const
411
- }
412
- }
413
- return [Option.none(), makeData(end, data.sleeps)] as const
414
- }),
415
- core.flatMap((option) => {
416
- switch (option._tag) {
417
- case "None": {
418
- return core.void
419
- }
420
- case "Some": {
421
- const [end, deferred] = option.value
422
- return pipe(
423
- core.deferredSucceed(deferred, void 0),
424
- core.zipRight(core.yieldNow()),
425
- core.zipRight(this.run(() => end))
426
- )
427
- }
428
- }
429
- })
430
- ))
431
- )
432
- }
433
- }
434
-
435
- /**
436
- * @since 2.0.0
437
- */
438
- export const live = (data: Data): Layer.Layer<TestClock, never, Annotations.TestAnnotations | Live.TestLive> =>
439
- layer.scoped(
440
- TestClock,
441
- core.gen(function*() {
442
- const live = yield* Live.TestLive
443
- const annotations = yield* Annotations.TestAnnotations
444
- const clockState = yield* core.sync(() => ref.unsafeMake(data))
445
- const warningState = yield* circular.makeSynchronized(WarningData.start)
446
- const suspendedWarningState = yield* circular.makeSynchronized(SuspendedWarningData.start)
447
- const testClock = new TestClockImpl(clockState, live, annotations, warningState, suspendedWarningState)
448
- yield* fiberRuntime.withClockScoped(testClock)
449
- yield* fiberRuntime.addFinalizer(
450
- () => core.zipRight(testClock.warningDone(), testClock.suspendedWarningDone())
451
- )
452
- return testClock
453
- })
454
- )
455
-
456
- /**
457
- * @since 2.0.0
458
- */
459
- export const defaultTestClock: Layer.Layer<TestClock, never, Annotations.TestAnnotations | Live.TestLive> = live(
460
- makeData(new Date(0).getTime(), Chunk.empty())
461
- )
462
-
463
- /**
464
- * Accesses a `TestClock` instance in the context and increments the time
465
- * by the specified duration, running any actions scheduled for on or before
466
- * the new time in order.
467
- *
468
- * @since 2.0.0
469
- */
470
- export const adjust = (durationInput: Duration.DurationInput): Effect.Effect<void> => {
471
- const duration = Duration.decode(durationInput)
472
- return testClockWith((testClock) => testClock.adjust(duration))
473
- }
474
-
475
- /**
476
- * @since 2.0.0
477
- */
478
- export const adjustWith = dual<
479
- (duration: Duration.DurationInput) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>,
480
- <A, E, R>(effect: Effect.Effect<A, E, R>, duration: Duration.DurationInput) => Effect.Effect<A, E, R>
481
- >(2, (effect, durationInput) => {
482
- const duration = Duration.decode(durationInput)
483
- return testClockWith((testClock) => testClock.adjustWith(duration)(effect))
484
- })
485
-
486
- /**
487
- * Accesses a `TestClock` instance in the context and saves the clock
488
- * state in an effect which, when run, will restore the `TestClock` to the
489
- * saved state.
490
- *
491
- * @since 2.0.0
492
- */
493
- export const save = (): Effect.Effect<Effect.Effect<void>> => testClockWith((testClock) => testClock.save)
494
-
495
- /**
496
- * Accesses a `TestClock` instance in the context and sets the clock time
497
- * to the specified `Instant` or `Date`, running any actions scheduled for on or before
498
- * the new time in order.
499
- *
500
- * @since 2.0.0
501
- */
502
- export const setTime = (input: DateTime.DateTime.Input): Effect.Effect<void> =>
503
- testClockWith((testClock) =>
504
- testClock.setTime(
505
- typeof input === "number"
506
- ? input
507
- : DateTime.unsafeMake(input).epochMillis
508
- )
509
- )
510
-
511
- /**
512
- * Semantically blocks the current fiber until the clock time is equal to or
513
- * greater than the specified duration. Once the clock time is adjusted to
514
- * on or after the duration, the fiber will automatically be resumed.
515
- *
516
- * @since 2.0.0
517
- */
518
- export const sleep = (durationInput: Duration.DurationInput): Effect.Effect<void> => {
519
- const duration = Duration.decode(durationInput)
520
- return testClockWith((testClock) => testClock.sleep(duration))
521
- }
522
-
523
- /**
524
- * Accesses a `TestClock` instance in the context and returns a list of
525
- * times that effects are scheduled to run.
526
- *
527
- * @since 2.0.0
528
- */
529
- export const sleeps = (): Effect.Effect<Chunk.Chunk<number>> => testClockWith((testClock) => testClock.sleeps)
530
-
531
- /**
532
- * Retrieves the `TestClock` service for this test.
533
- *
534
- * @since 2.0.0
535
- */
536
- export const testClock = (): Effect.Effect<TestClock> => testClockWith(core.succeed)
537
-
538
- /**
539
- * Retrieves the `TestClock` service for this test and uses it to run the
540
- * specified workflow.
541
- *
542
- * @since 2.0.0
543
- */
544
- export const testClockWith = <A, E, R>(f: (testClock: TestClock) => Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>
545
- core.fiberRefGetWith(
546
- defaultServices.currentServices,
547
- (services) => f(pipe(services, Context.get(clock.clockTag)) as TestClock)
548
- )
549
-
550
- /**
551
- * Accesses the current time of a `TestClock` instance in the context in
552
- * milliseconds.
553
- *
554
- * @since 2.0.0
555
- */
556
- export const currentTimeMillis: Effect.Effect<number> = testClockWith((testClock) => testClock.currentTimeMillis)
package/src/TestConfig.ts DELETED
@@ -1,47 +0,0 @@
1
- /**
2
- * @since 2.0.0
3
- */
4
- import * as Context from "./Context.js"
5
-
6
- /**
7
- * The `TestConfig` service provides access to default configuration settings
8
- * used by tests, including the number of times to repeat tests to ensure
9
- * they are stable, the number of times to retry flaky tests, the sufficient
10
- * number of samples to check from a random variable, and the maximum number of
11
- * shrinkings to minimize large failures.
12
- *
13
- * @since 2.0.0
14
- */
15
- export interface TestConfig {
16
- /**
17
- * The number of times to repeat tests to ensure they are stable.
18
- */
19
- readonly repeats: number
20
- /**
21
- * The number of times to retry flaky tests.
22
- */
23
- readonly retries: number
24
- /**
25
- * The number of sufficient samples to check for a random variable.
26
- */
27
- readonly samples: number
28
- /**
29
- * The maximum number of shrinkings to minimize large failures
30
- */
31
- readonly shrinks: number
32
- }
33
-
34
- /**
35
- * @since 2.0.0
36
- */
37
- export const TestConfig: Context.Tag<TestConfig, TestConfig> = Context.GenericTag<TestConfig>("effect/TestConfig")
38
-
39
- /**
40
- * @since 2.0.0
41
- */
42
- export const make = (params: {
43
- readonly repeats: number
44
- readonly retries: number
45
- readonly samples: number
46
- readonly shrinks: number
47
- }): TestConfig => params
@@ -1,36 +0,0 @@
1
- /**
2
- * @since 2.0.0
3
- */
4
- import type * as DefaultServices from "./DefaultServices.js"
5
- import { pipe } from "./Function.js"
6
- import * as defaultServices from "./internal/defaultServices.js"
7
- import * as layer from "./internal/layer.js"
8
- import type * as Layer from "./Layer.js"
9
- import * as TestClock from "./TestClock.js"
10
- import * as TestServices from "./TestServices.js"
11
-
12
- /** @internal */
13
- export const live: Layer.Layer<TestServices.TestServices, never, DefaultServices.DefaultServices> = pipe(
14
- TestServices.annotationsLayer(),
15
- layer.merge(TestServices.liveLayer()),
16
- layer.merge(TestServices.sizedLayer(100)),
17
- layer.merge(pipe(
18
- TestClock.defaultTestClock,
19
- layer.provideMerge(
20
- layer.merge(TestServices.liveLayer(), TestServices.annotationsLayer())
21
- )
22
- )),
23
- layer.merge(TestServices.testConfigLayer({ repeats: 100, retries: 100, samples: 200, shrinks: 1000 }))
24
- )
25
-
26
- /**
27
- * @since 2.0.0
28
- */
29
- export const LiveContext: Layer.Layer<DefaultServices.DefaultServices> = layer.syncContext(() =>
30
- defaultServices.liveServices
31
- )
32
-
33
- /**
34
- * @since 2.0.0
35
- */
36
- export const TestContext: Layer.Layer<TestServices.TestServices> = layer.provideMerge(live, LiveContext)
package/src/TestLive.ts DELETED
@@ -1,53 +0,0 @@
1
- /**
2
- * @since 2.0.0
3
- */
4
- import * as Context from "./Context.js"
5
- import type * as DefaultServices from "./DefaultServices.js"
6
- import type * as Effect from "./Effect.js"
7
- import * as core from "./internal/core.js"
8
- import * as defaultServices from "./internal/defaultServices.js"
9
-
10
- /**
11
- * @since 2.0.0
12
- */
13
- export const TestLiveTypeId: unique symbol = Symbol.for("effect/TestLive")
14
-
15
- /**
16
- * @since 2.0.0
17
- */
18
- export type TestLiveTypeId = typeof TestLiveTypeId
19
-
20
- /**
21
- * The `Live` trait provides access to the "live" default Effect services from
22
- * within tests for workflows such as printing test results to the console or
23
- * timing out tests where it is necessary to access the real implementations of
24
- * these services.
25
- *
26
- * @since 2.0.0
27
- */
28
- export interface TestLive {
29
- readonly [TestLiveTypeId]: TestLiveTypeId
30
- provide<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>
31
- }
32
-
33
- /**
34
- * @since 2.0.0
35
- */
36
- export const TestLive: Context.Tag<TestLive, TestLive> = Context.GenericTag<TestLive>("effect/TestLive")
37
-
38
- /** @internal */
39
- class LiveImpl implements TestLive {
40
- readonly [TestLiveTypeId]: TestLiveTypeId = TestLiveTypeId
41
- constructor(readonly services: Context.Context<DefaultServices.DefaultServices>) {}
42
- provide<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> {
43
- return core.fiberRefLocallyWith(
44
- defaultServices.currentServices,
45
- Context.merge(this.services)
46
- )(effect)
47
- }
48
- }
49
-
50
- /**
51
- * @since 2.0.0
52
- */
53
- export const make = (services: Context.Context<DefaultServices.DefaultServices>): TestLive => new LiveImpl(services)