@shivaedev/test-story 0.31.4 → 0.33.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 (256) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +89 -15
  3. package/dist/client/adapters/reactRendering.d.ts +7 -0
  4. package/dist/client/adapters/reactRendering.d.ts.map +1 -0
  5. package/dist/client/adapters/reactRendering.js +4 -0
  6. package/dist/client/adapters/reactRendering.js.map +1 -0
  7. package/dist/client/adapters/waitForReact.d.ts +2 -0
  8. package/dist/client/adapters/waitForReact.d.ts.map +1 -0
  9. package/dist/client/adapters/waitForReact.js +8 -0
  10. package/dist/client/adapters/waitForReact.js.map +1 -0
  11. package/dist/client/react.d.ts +5 -4
  12. package/dist/client/react.d.ts.map +1 -1
  13. package/dist/client/react.js +9 -10
  14. package/dist/client/react.js.map +1 -1
  15. package/dist/server/adapters/receiveOtlp.d.ts +4 -0
  16. package/dist/server/adapters/receiveOtlp.d.ts.map +1 -0
  17. package/dist/server/adapters/receiveOtlp.js +39 -0
  18. package/dist/server/adapters/receiveOtlp.js.map +1 -0
  19. package/dist/server/adapters/screenAct.d.ts +4 -0
  20. package/dist/server/adapters/screenAct.d.ts.map +1 -0
  21. package/dist/server/adapters/screenAct.js +14 -0
  22. package/dist/server/adapters/screenAct.js.map +1 -0
  23. package/dist/server/adapters/screenMutations.d.ts +1 -1
  24. package/dist/server/adapters/screenMutations.d.ts.map +1 -1
  25. package/dist/server/adapters/screenMutations.js +1 -1
  26. package/dist/server/adapters/screenMutations.js.map +1 -1
  27. package/dist/server/adapters/screenNavigation.d.ts +1 -1
  28. package/dist/server/adapters/screenNavigation.d.ts.map +1 -1
  29. package/dist/server/adapters/screenNavigation.js +1 -1
  30. package/dist/server/adapters/screenNavigation.js.map +1 -1
  31. package/dist/server/adapters/storyFailure.d.ts +6 -0
  32. package/dist/server/adapters/storyFailure.d.ts.map +1 -0
  33. package/dist/server/adapters/storyFailure.js +13 -0
  34. package/dist/server/adapters/storyFailure.js.map +1 -0
  35. package/dist/server/adapters/visitHttp.d.ts +2 -0
  36. package/dist/server/adapters/visitHttp.d.ts.map +1 -0
  37. package/dist/server/adapters/visitHttp.js +4 -0
  38. package/dist/server/adapters/visitHttp.js.map +1 -0
  39. package/dist/server/browserReads.d.ts +4 -4
  40. package/dist/server/browserReads.d.ts.map +1 -1
  41. package/dist/server/browserReads.js +3 -16
  42. package/dist/server/browserReads.js.map +1 -1
  43. package/dist/server/domPage.d.ts +5 -0
  44. package/dist/server/domPage.d.ts.map +1 -0
  45. package/dist/server/domPage.js +9 -0
  46. package/dist/server/domPage.js.map +1 -0
  47. package/dist/server/fakeHttpService.d.ts +1 -1
  48. package/dist/server/fakeHttpService.d.ts.map +1 -1
  49. package/dist/server/fakeHttpService.js +2 -1
  50. package/dist/server/fakeHttpService.js.map +1 -1
  51. package/dist/server/forwardingProxy.d.ts +1 -1
  52. package/dist/server/forwardingProxy.d.ts.map +1 -1
  53. package/dist/server/forwardingProxy.js +1 -1
  54. package/dist/server/forwardingProxy.js.map +1 -1
  55. package/dist/server/httpVisitor.d.ts +12 -0
  56. package/dist/server/httpVisitor.d.ts.map +1 -0
  57. package/dist/server/httpVisitor.js +29 -0
  58. package/dist/server/httpVisitor.js.map +1 -0
  59. package/dist/server/internal/adapters/pageFetch.d.ts +3 -0
  60. package/dist/server/internal/adapters/pageFetch.d.ts.map +1 -0
  61. package/dist/server/internal/adapters/pageFetch.js +23 -0
  62. package/dist/server/internal/adapters/pageFetch.js.map +1 -0
  63. package/dist/server/internal/browserReadObserver.d.ts +3 -2
  64. package/dist/server/internal/browserReadObserver.d.ts.map +1 -1
  65. package/dist/server/internal/browserReadObserver.js +4 -2
  66. package/dist/server/internal/browserReadObserver.js.map +1 -1
  67. package/dist/server/internal/browserSubscriptions.d.ts +1 -1
  68. package/dist/server/internal/browserSubscriptions.d.ts.map +1 -1
  69. package/dist/server/internal/browserSubscriptions.js +3 -1
  70. package/dist/server/internal/browserSubscriptions.js.map +1 -1
  71. package/dist/server/internal/compose.d.ts.map +1 -1
  72. package/dist/server/internal/compose.js +2 -1
  73. package/dist/server/internal/compose.js.map +1 -1
  74. package/dist/server/internal/domDocument.d.ts +1 -1
  75. package/dist/server/internal/domDocument.d.ts.map +1 -1
  76. package/dist/server/internal/domDocument.js +1 -1
  77. package/dist/server/internal/domDocument.js.map +1 -1
  78. package/dist/server/internal/failureReport.d.ts +1 -0
  79. package/dist/server/internal/failureReport.d.ts.map +1 -1
  80. package/dist/server/internal/failureReport.js +4 -1
  81. package/dist/server/internal/failureReport.js.map +1 -1
  82. package/dist/server/internal/fakeHttpControls.d.ts +1 -1
  83. package/dist/server/internal/fakeHttpControls.d.ts.map +1 -1
  84. package/dist/server/internal/fakeHttpControls.js +1 -1
  85. package/dist/server/internal/fakeHttpControls.js.map +1 -1
  86. package/dist/server/internal/fakeHttpGates.d.ts.map +1 -1
  87. package/dist/server/internal/fakeHttpGates.js +2 -1
  88. package/dist/server/internal/fakeHttpGates.js.map +1 -1
  89. package/dist/server/internal/fakeHttpScripts.js +1 -1
  90. package/dist/server/internal/fakeHttpScripts.js.map +1 -1
  91. package/dist/server/internal/hooked.d.ts +1 -1
  92. package/dist/server/internal/hooked.d.ts.map +1 -1
  93. package/dist/server/internal/hooked.js +1 -1
  94. package/dist/server/internal/hooked.js.map +1 -1
  95. package/dist/server/internal/loadingDeadline.d.ts +3 -0
  96. package/dist/server/internal/loadingDeadline.d.ts.map +1 -0
  97. package/dist/server/internal/loadingDeadline.js +13 -0
  98. package/dist/server/internal/loadingDeadline.js.map +1 -0
  99. package/dist/server/internal/loopback.d.ts +1 -1
  100. package/dist/server/internal/loopback.d.ts.map +1 -1
  101. package/dist/server/internal/loopback.js +1 -1
  102. package/dist/server/internal/loopback.js.map +1 -1
  103. package/dist/server/internal/narration.d.ts +6 -9
  104. package/dist/server/internal/narration.d.ts.map +1 -1
  105. package/dist/server/internal/narration.js +17 -18
  106. package/dist/server/internal/narration.js.map +1 -1
  107. package/dist/server/internal/nextClientHint.d.ts +1 -1
  108. package/dist/server/internal/nextClientHint.d.ts.map +1 -1
  109. package/dist/server/internal/nextClientHint.js +2 -1
  110. package/dist/server/internal/nextClientHint.js.map +1 -1
  111. package/dist/server/internal/observeBrowser.d.ts +61 -0
  112. package/dist/server/internal/observeBrowser.d.ts.map +1 -0
  113. package/dist/server/internal/observeBrowser.js +21 -0
  114. package/dist/server/internal/observeBrowser.js.map +1 -0
  115. package/dist/server/internal/otlpReadout.js +1 -1
  116. package/dist/server/internal/otlpReadout.js.map +1 -1
  117. package/dist/server/internal/otlpReadouts.d.ts +9 -0
  118. package/dist/server/internal/otlpReadouts.d.ts.map +1 -0
  119. package/dist/server/internal/otlpReadouts.js +44 -0
  120. package/dist/server/internal/otlpReadouts.js.map +1 -0
  121. package/dist/server/internal/otlpTracing.d.ts +10 -0
  122. package/dist/server/internal/otlpTracing.d.ts.map +1 -0
  123. package/dist/server/internal/otlpTracing.js +45 -0
  124. package/dist/server/internal/otlpTracing.js.map +1 -0
  125. package/dist/server/internal/otlpValue.d.ts +1 -1
  126. package/dist/server/internal/otlpValue.d.ts.map +1 -1
  127. package/dist/server/internal/otlpValue.js +1 -1
  128. package/dist/server/internal/otlpValue.js.map +1 -1
  129. package/dist/server/internal/recordedSignals.d.ts +1 -1
  130. package/dist/server/internal/recordedSignals.d.ts.map +1 -1
  131. package/dist/server/internal/recordedSignals.js +4 -1
  132. package/dist/server/internal/recordedSignals.js.map +1 -1
  133. package/dist/server/internal/runUntil.d.ts +1 -1
  134. package/dist/server/internal/runUntil.d.ts.map +1 -1
  135. package/dist/server/internal/runUntil.js +1 -1
  136. package/dist/server/internal/runUntil.js.map +1 -1
  137. package/dist/server/internal/screenLoading.d.ts +2 -0
  138. package/dist/server/internal/screenLoading.d.ts.map +1 -0
  139. package/dist/server/internal/screenLoading.js +19 -0
  140. package/dist/server/internal/screenLoading.js.map +1 -0
  141. package/dist/server/internal/screenWaits.d.ts +2 -2
  142. package/dist/server/internal/screenWaits.d.ts.map +1 -1
  143. package/dist/server/internal/screenWaits.js +9 -5
  144. package/dist/server/internal/screenWaits.js.map +1 -1
  145. package/dist/server/internal/seed.d.ts +2 -1
  146. package/dist/server/internal/seed.d.ts.map +1 -1
  147. package/dist/server/internal/seed.js +4 -1
  148. package/dist/server/internal/seed.js.map +1 -1
  149. package/dist/server/internal/start.d.ts +1 -1
  150. package/dist/server/internal/start.d.ts.map +1 -1
  151. package/dist/server/internal/start.js +7 -4
  152. package/dist/server/internal/start.js.map +1 -1
  153. package/dist/server/internal/storyIt.d.ts.map +1 -1
  154. package/dist/server/internal/storyIt.js +3 -2
  155. package/dist/server/internal/storyIt.js.map +1 -1
  156. package/dist/server/internal/visitorCookies.d.ts +5 -0
  157. package/dist/server/internal/visitorCookies.d.ts.map +1 -0
  158. package/dist/server/internal/visitorCookies.js +50 -0
  159. package/dist/server/internal/visitorCookies.js.map +1 -0
  160. package/dist/server/internal/waitForScreen.d.ts +1 -1
  161. package/dist/server/internal/waitForScreen.d.ts.map +1 -1
  162. package/dist/server/internal/waitForScreen.js +7 -3
  163. package/dist/server/internal/waitForScreen.js.map +1 -1
  164. package/dist/server/internal/withWatchedClock.d.ts +1 -1
  165. package/dist/server/internal/withWatchedClock.d.ts.map +1 -1
  166. package/dist/server/internal/withWatchedClock.js +2 -1
  167. package/dist/server/internal/withWatchedClock.js.map +1 -1
  168. package/dist/server/lineSignals.d.ts +1 -1
  169. package/dist/server/lineSignals.d.ts.map +1 -1
  170. package/dist/server/lineSignals.js +1 -1
  171. package/dist/server/lineSignals.js.map +1 -1
  172. package/dist/server/memberScreens.d.ts +3 -2
  173. package/dist/server/memberScreens.d.ts.map +1 -1
  174. package/dist/server/memberScreens.js +4 -5
  175. package/dist/server/memberScreens.js.map +1 -1
  176. package/dist/server/otlpReceiver.d.ts +15 -4
  177. package/dist/server/otlpReceiver.d.ts.map +1 -1
  178. package/dist/server/otlpReceiver.js +9 -40
  179. package/dist/server/otlpReceiver.js.map +1 -1
  180. package/dist/server/outcomes.d.ts +1 -1
  181. package/dist/server/outcomes.d.ts.map +1 -1
  182. package/dist/server/outcomes.js +1 -1
  183. package/dist/server/outcomes.js.map +1 -1
  184. package/dist/server/routeOutbound.d.ts +1 -1
  185. package/dist/server/routeOutbound.d.ts.map +1 -1
  186. package/dist/server/routeOutbound.js +1 -1
  187. package/dist/server/routeOutbound.js.map +1 -1
  188. package/dist/server/screenDriver.d.ts +4 -2
  189. package/dist/server/screenDriver.d.ts.map +1 -1
  190. package/dist/server/screenDriver.js +4 -3
  191. package/dist/server/screenDriver.js.map +1 -1
  192. package/dist/server/seedCookies.d.ts +3 -3
  193. package/dist/server/seedCookies.d.ts.map +1 -1
  194. package/dist/server/seedCookies.js +4 -4
  195. package/dist/server/seedCookies.js.map +1 -1
  196. package/dist/server/until.d.ts +3 -1
  197. package/dist/server/until.d.ts.map +1 -1
  198. package/dist/server/until.js +4 -1
  199. package/dist/server/until.js.map +1 -1
  200. package/dist/server/watchedClock.d.ts +3 -1
  201. package/dist/server/watchedClock.d.ts.map +1 -1
  202. package/dist/server/watchedClock.js +5 -1
  203. package/dist/server/watchedClock.js.map +1 -1
  204. package/package.json +12 -5
  205. package/src/client/adapters/reactRendering.ts +5 -0
  206. package/src/client/adapters/waitForReact.ts +7 -0
  207. package/src/client/react.ts +13 -12
  208. package/src/server/adapters/receiveOtlp.ts +45 -0
  209. package/src/server/adapters/screenAct.ts +20 -0
  210. package/src/server/adapters/screenMutations.ts +1 -1
  211. package/src/server/adapters/screenNavigation.ts +1 -1
  212. package/src/server/adapters/storyFailure.ts +20 -0
  213. package/src/server/adapters/visitHttp.ts +3 -0
  214. package/src/server/browserReads.ts +5 -19
  215. package/src/server/domPage.ts +12 -0
  216. package/src/server/fakeHttpService.ts +2 -1
  217. package/src/server/forwardingProxy.ts +1 -1
  218. package/src/server/httpVisitor.ts +37 -0
  219. package/src/server/internal/adapters/pageFetch.ts +22 -0
  220. package/src/server/internal/browserReadObserver.ts +5 -2
  221. package/src/server/internal/browserSubscriptions.ts +3 -1
  222. package/src/server/internal/compose.ts +2 -1
  223. package/src/server/internal/domDocument.ts +1 -1
  224. package/src/server/internal/failureReport.ts +8 -1
  225. package/src/server/internal/fakeHttpControls.ts +1 -1
  226. package/src/server/internal/fakeHttpGates.ts +2 -1
  227. package/src/server/internal/fakeHttpScripts.ts +1 -1
  228. package/src/server/internal/hooked.ts +1 -1
  229. package/src/server/internal/loadingDeadline.ts +22 -0
  230. package/src/server/internal/loopback.ts +1 -1
  231. package/src/server/internal/narration.ts +26 -25
  232. package/src/server/internal/nextClientHint.ts +2 -1
  233. package/src/server/internal/observeBrowser.ts +25 -0
  234. package/src/server/internal/otlpReadout.ts +1 -1
  235. package/src/server/internal/otlpReadouts.ts +50 -0
  236. package/src/server/internal/otlpTracing.ts +56 -0
  237. package/src/server/internal/otlpValue.ts +1 -1
  238. package/src/server/internal/recordedSignals.ts +4 -1
  239. package/src/server/internal/runUntil.ts +1 -1
  240. package/src/server/internal/screenLoading.ts +21 -0
  241. package/src/server/internal/screenWaits.ts +15 -7
  242. package/src/server/internal/seed.ts +5 -1
  243. package/src/server/internal/start.ts +10 -4
  244. package/src/server/internal/storyIt.ts +3 -2
  245. package/src/server/internal/visitorCookies.ts +62 -0
  246. package/src/server/internal/waitForScreen.ts +7 -3
  247. package/src/server/internal/withWatchedClock.ts +2 -1
  248. package/src/server/lineSignals.ts +1 -1
  249. package/src/server/memberScreens.ts +8 -5
  250. package/src/server/otlpReceiver.ts +13 -46
  251. package/src/server/outcomes.ts +1 -1
  252. package/src/server/routeOutbound.ts +1 -1
  253. package/src/server/screenDriver.ts +9 -3
  254. package/src/server/seedCookies.ts +6 -6
  255. package/src/server/until.ts +5 -1
  256. package/src/server/watchedClock.ts +5 -1
@@ -1,4 +1,5 @@
1
- import { Effect, Layer } from "effect";
1
+ import * as Effect from "effect/Effect";
2
+ import * as Layer from "effect/Layer";
2
3
  import type { AnyTestLayer } from "@shivaedev/test/anyTestLayer.ts";
3
4
  import { type KitList, kitDefinition } from "#internal/compositionTypes.ts";
4
5
  import { hooked } from "#internal/hooked.ts";
@@ -1,4 +1,4 @@
1
- import { Effect } from "effect";
1
+ import * as Effect from "effect/Effect";
2
2
 
3
3
  const DOM = Symbol.for("test-story.dom");
4
4
 
@@ -4,7 +4,7 @@ import { locate } from "#internal/callSite.ts";
4
4
  import { engineSnapshot } from "#internal/engineSnapshot.ts";
5
5
  import type { Narration, Subject } from "#internal/narration.ts";
6
6
  import { describeValue } from "#internal/render.ts";
7
- import { WIDTH, wrap } from "#internal/wrap.ts";
7
+ import { explained, WIDTH, wrap } from "#internal/wrap.ts";
8
8
 
9
9
  export interface FailedTest {
10
10
  readonly file: string;
@@ -12,6 +12,13 @@ export interface FailedTest {
12
12
  readonly stack: string | undefined;
13
13
  }
14
14
 
15
+ export function creationReport(name: string, test: FailedTest): string {
16
+ return `${explained(
17
+ `the ${name} story kit failed during create`,
18
+ `create builds the engine before traits and the story run. Fix the create hook in the ${name} story kit or the resources it needs.`,
19
+ )}\n\n${rerun(test)}`;
20
+ }
21
+
15
22
  export function failureReport<TEngine>(narration: Narration, subject: Subject<TEngine>, test: FailedTest): string {
16
23
  try {
17
24
  return [...guide(subject.name), "", ...storyRows(narration, test), "", ...engineSnapshot(subject, test), "", rerun(test)].join("\n");
@@ -1,5 +1,5 @@
1
1
  import type { ServerResponse } from "node:http";
2
- import { Effect } from "effect";
2
+ import * as Effect from "effect/Effect";
3
3
  import type {
4
4
  FakeHttpFault,
5
5
  FakeHttpHoldOptions,
@@ -1,4 +1,5 @@
1
- import { Deferred, Effect } from "effect";
1
+ import * as Deferred from "effect/Deferred";
2
+ import * as Effect from "effect/Effect";
2
3
  import type { FakeHttpHold, FakeHttpRequest, FakeHttpScope } from "#fakeHttpService.ts";
3
4
  import { fakeHttpSelection } from "#internal/fakeHttpSelection.ts";
4
5
 
@@ -1,4 +1,4 @@
1
- import { Effect } from "effect";
1
+ import * as Effect from "effect/Effect";
2
2
  import type { FakeHttpFault, FakeHttpRequest, FakeHttpScript, FakeHttpScriptOptions } from "#fakeHttpService.ts";
3
3
  import { fakeHttpSelection } from "#internal/fakeHttpSelection.ts";
4
4
 
@@ -1,4 +1,4 @@
1
- import { Effect } from "effect";
1
+ import * as Effect from "effect/Effect";
2
2
 
3
3
  export type AnyEffect = Effect.Effect<unknown, unknown, unknown>;
4
4
 
@@ -0,0 +1,22 @@
1
+ import * as Clock from "effect/Clock";
2
+ import * as Effect from "effect/Effect";
3
+ import { waitForScreen } from "./waitForScreen.ts";
4
+
5
+ export const loadingDeadline = Effect.fnUntraced(function* <A>(
6
+ root: () => HTMLElement,
7
+ loading: () => boolean,
8
+ timeout: number,
9
+ loadingTimeout: number,
10
+ expired: () => Effect.Effect<A>,
11
+ ) {
12
+ const started = yield* Clock.currentTimeMillis;
13
+ yield* Effect.sleep(timeout);
14
+ const remaining = loadingTimeout - ((yield* Clock.currentTimeMillis) - started);
15
+ if (!loading() || remaining <= 0) {
16
+ return yield* expired();
17
+ }
18
+ return yield* waitForScreen(
19
+ { act: (action) => action(), pending: undefined, root },
20
+ Effect.suspend(() => (loading() ? Effect.fail(undefined) : Effect.void)),
21
+ ).pipe(Effect.andThen(expired), Effect.timeoutOrElse({ duration: remaining, orElse: expired }));
22
+ });
@@ -1,5 +1,5 @@
1
1
  import type { Server } from "node:http";
2
- import { Effect } from "effect";
2
+ import * as Effect from "effect/Effect";
3
3
 
4
4
  export const loopbackServer = Effect.fnUntraced(function* (server: Server, options: { readonly host?: string; readonly port?: number } = {}) {
5
5
  yield* Effect.acquireRelease(
@@ -1,9 +1,9 @@
1
- import { Cause, Effect } from "effect";
2
- import type { TestContext } from "vitest";
1
+ import * as Cause from "effect/Cause";
2
+ import * as Effect from "effect/Effect";
3
+ import { type FailureContext, reportOnFailure } from "#adapters/storyFailure.ts";
3
4
  import { callSite } from "#internal/callSite.ts";
4
- import { failureReport } from "#internal/failureReport.ts";
5
+ import { creationReport, failureReport } from "#internal/failureReport.ts";
5
6
  import { hooked } from "#internal/hooked.ts";
6
- import { describeFailure } from "#internal/render.ts";
7
7
 
8
8
  export interface Refusal {
9
9
  readonly cause: unknown;
@@ -27,7 +27,11 @@ export interface Subject<TEngine> {
27
27
  readonly snapshot?: { readonly value: unknown } | { readonly threw: unknown };
28
28
  }
29
29
 
30
- export function narrate<TEngine>(subject: Subject<TEngine>, { onTestFailed, task }: Pick<TestContext, "onTestFailed" | "task">) {
30
+ export function narrateCreation(name: string, context: FailureContext) {
31
+ return reportOnFailure(context, (test) => Effect.sync(() => creationReport(name, test)));
32
+ }
33
+
34
+ export const narrate = Effect.fnUntraced(function* <TEngine>(subject: Subject<TEngine>, context: FailureContext) {
31
35
  let captured: string | undefined;
32
36
  const narration: Narration = {
33
37
  at: undefined,
@@ -44,28 +48,25 @@ export function narrate<TEngine>(subject: Subject<TEngine>, { onTestFailed, task
44
48
  narration.at = site;
45
49
  },
46
50
  };
47
- onTestFailed(({ task: failedTask }) => {
48
- const failure = failedTask.result?.errors?.[0];
49
- if (failure !== undefined) {
50
- failure.message = `${failure.message === "" ? describeFailure(failure) : failure.message}\n\n${captured ?? failureReport(narration, subject, { file: task.file.filepath, name: task.name, stack: failure.stack })}`;
51
- }
52
- });
53
- return {
54
- captureFailure: (stack: string | undefined) =>
55
- hooked(() => (subject.inspect === undefined ? subject.engine : subject.inspect(subject.engine))).pipe(
56
- Effect.matchCause({
57
- onFailure: (cause) => ({ threw: Cause.squash(cause) }),
58
- onSuccess: (value) => ({ value }),
51
+ function captureFailure(stack: string | undefined) {
52
+ return hooked(() => (subject.inspect === undefined ? subject.engine : subject.inspect(subject.engine))).pipe(
53
+ Effect.matchCause({
54
+ onFailure: (cause) => ({ threw: Cause.squash(cause) }),
55
+ onSuccess: (value) => ({ value }),
56
+ }),
57
+ Effect.map((snapshot) =>
58
+ failureReport(narration, { ...subject, snapshot }, { file: context.task.file.filepath, name: context.task.name, stack }),
59
+ ),
60
+ Effect.tap((report) =>
61
+ Effect.sync(() => {
62
+ captured = report;
59
63
  }),
60
- Effect.tap((snapshot) =>
61
- Effect.sync(() => {
62
- captured = failureReport(narration, { ...subject, snapshot }, { file: task.file.filepath, name: task.name, stack });
63
- }),
64
- ),
65
64
  ),
66
- narration,
67
- };
68
- }
65
+ );
66
+ }
67
+ yield* reportOnFailure(context, (test) => (captured === undefined ? captureFailure(test.stack) : Effect.succeed(captured)));
68
+ return { captureFailure, narration };
69
+ });
69
70
 
70
71
  export function tellGiven(narration: Narration, given: readonly { readonly line: string; readonly site: Error }[]): void {
71
72
  for (const part of given) {
@@ -1,4 +1,5 @@
1
- import { Effect, Stream } from "effect";
1
+ import * as Effect from "effect/Effect";
2
+ import * as Stream from "effect/Stream";
2
3
  import type { ClientActivity } from "@shivaedev/contract/clientActivity.ts";
3
4
 
4
5
  export const nextClientHint = Effect.fnUntraced(function* (activity: ClientActivity) {
@@ -0,0 +1,25 @@
1
+ import * as Effect from "effect/Effect";
2
+ import * as Layer from "effect/Layer";
3
+ import * as Atom from "effect/reactivity/Atom";
4
+ import * as RpcClient from "effect/rpc/RpcClient";
5
+ import * as RpcSerialization from "effect/rpc/RpcSerialization";
6
+ import * as Socket from "effect/socket/Socket";
7
+ import type { BrowserReadsOptions } from "#browserReads.ts";
8
+ import { browserReadObserver } from "./browserReadObserver.ts";
9
+
10
+ export const observeBrowser = Effect.fnUntraced(function* (options: BrowserReadsOptions) {
11
+ const { observeProtocol, ...observed } = yield* browserReadObserver(options.contracts);
12
+ const memoMap = yield* Layer.makeMemoMap;
13
+ const protocol = Atom.family((_identity: string | undefined) => {
14
+ const layer = Layer.effect(RpcClient.Protocol, observeProtocol).pipe(Layer.provide(socketProtocol(options)));
15
+ return Layer.effectContext(Effect.flatMap(Effect.scope, (scope) => Layer.buildWithMemoMap(layer, memoMap, scope)));
16
+ });
17
+ return { ...observed, protocol };
18
+ });
19
+
20
+ function socketProtocol(options: BrowserReadsOptions) {
21
+ const socket = Socket.layerWebSocket(options.url.replace(/^http/u, "ws"), { headers: options.headers }).pipe(
22
+ Layer.provide(options.webSocketConstructor ?? Socket.layerWebSocketConstructorGlobal),
23
+ );
24
+ return RpcClient.layerProtocolSocket().pipe(Layer.provide(socket), Layer.provide(RpcSerialization.layerNdjson));
25
+ }
@@ -1,4 +1,4 @@
1
- import { Schema } from "effect";
1
+ import * as Schema from "effect/Schema";
2
2
  import { otlpProtobuf } from "#internal/otlpProtobuf.ts";
3
3
  import { Attribute } from "#internal/otlpValue.ts";
4
4
 
@@ -0,0 +1,50 @@
1
+ import * as Option from "effect/Option";
2
+ import * as Schema from "effect/Schema";
3
+ import type { OtlpExport, OtlpSpan } from "#otlpReceiver.ts";
4
+
5
+ const parseJson = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Unknown));
6
+
7
+ function contains(value: unknown, secret: string): boolean {
8
+ if (typeof value === "object" && value !== null) {
9
+ return Object.entries(value).some(([key, item]) => key.includes(secret) || contains(item, secret));
10
+ }
11
+ return String(value).includes(secret);
12
+ }
13
+
14
+ export function exportsSecret(requests: readonly OtlpExport[], secret: string) {
15
+ return requests.some(({ body, headers }) => {
16
+ if (body.includes(Buffer.from(secret))) {
17
+ return true;
18
+ }
19
+ if (headers["content-type"]?.split(";")[0]?.trim() === "application/json") {
20
+ return Option.exists(parseJson(body.toString()), (value) => contains(value, secret));
21
+ }
22
+ return false;
23
+ });
24
+ }
25
+
26
+ function text(attributes: OtlpSpan["attributes"], key: string) {
27
+ return attributes.find((attribute) => attribute.key === key)?.value.stringValue;
28
+ }
29
+
30
+ export function queries(spans: readonly OtlpSpan[]) {
31
+ return spans.flatMap((span) => {
32
+ const query = text(span.attributes, "db.query.text") ?? text(span.attributes, "db.statement");
33
+ return query === undefined ? [] : [query];
34
+ });
35
+ }
36
+
37
+ export function errors(spans: readonly OtlpSpan[]) {
38
+ return spans.flatMap((span) => {
39
+ const exceptions = span.events
40
+ .filter((event) => event.name === "exception")
41
+ .map((event) => ({
42
+ message: text(event.attributes, "exception.message") ?? span.status.message ?? span.name,
43
+ operation: span.name,
44
+ type: text(event.attributes, "exception.type"),
45
+ }));
46
+ return exceptions.length > 0 || span.status.code !== 2
47
+ ? exceptions
48
+ : [{ message: span.status.message ?? span.name, operation: span.name, type: undefined }];
49
+ });
50
+ }
@@ -0,0 +1,56 @@
1
+ import * as Effect from "effect/Effect";
2
+ import * as Layer from "effect/Layer";
3
+ import * as Logger from "effect/Logger";
4
+ import { OtlpExporter, OtlpTracer } from "effect/observability";
5
+ import * as Stream from "effect/Stream";
6
+ import * as Tracer from "effect/Tracer";
7
+ import type { OtlpSpan, OtlpTracerOptions } from "#otlpReceiver.ts";
8
+
9
+ function recordEnds(tracer: Tracer.Tracer, ended: Set<string>) {
10
+ return Tracer.make({
11
+ context: tracer.context,
12
+ span: (options) => {
13
+ const span = tracer.span(options);
14
+ const end = span.end.bind(span);
15
+ span.end = (time, exit) => {
16
+ end(time, exit);
17
+ if (span.sampled) {
18
+ ended.add(span.spanId);
19
+ }
20
+ };
21
+ return span;
22
+ },
23
+ });
24
+ }
25
+
26
+ export function otlpTracing(url: string, received: Stream.Stream<OtlpSpan>) {
27
+ const ended = new Set<string>();
28
+ const flushers = new Set<OtlpExporter.Flusher["Service"]>();
29
+ return {
30
+ flush: Effect.gen(function* () {
31
+ const pending = new Set(ended);
32
+ yield* Effect.forEach(flushers, (flusher) => flusher.flush, { discard: true });
33
+ if (pending.size > 0) {
34
+ yield* Stream.runForEachWhile(received, (span) =>
35
+ Effect.sync(() => {
36
+ pending.delete(span.spanId);
37
+ return pending.size > 0;
38
+ }),
39
+ );
40
+ }
41
+ }),
42
+ tracerLayer: (options: OtlpTracerOptions = {}) =>
43
+ Layer.effect(
44
+ Tracer.Tracer,
45
+ Effect.gen(function* () {
46
+ const flusher = yield* OtlpExporter.Flusher;
47
+ yield* Effect.acquireRelease(
48
+ Effect.sync(() => flushers.add(flusher)),
49
+ () => Effect.sync(() => flushers.delete(flusher)),
50
+ );
51
+ const tracer = yield* OtlpTracer.make({ ...options, url });
52
+ return recordEnds(tracer, ended);
53
+ }),
54
+ ).pipe(Layer.provideMerge(OtlpExporter.layerFlusher), Layer.merge(Logger.layer([Logger.tracerLogger], { mergeWithExisting: true }))),
55
+ };
56
+ }
@@ -1,4 +1,4 @@
1
- import { Schema } from "effect";
1
+ import * as Schema from "effect/Schema";
2
2
 
3
3
  export interface OtlpValue {
4
4
  readonly arrayValue?: { readonly values?: readonly OtlpValue[] };
@@ -1,4 +1,7 @@
1
- import { Cause, Effect, Queue, Stream } from "effect";
1
+ import * as Cause from "effect/Cause";
2
+ import * as Effect from "effect/Effect";
3
+ import * as Queue from "effect/Queue";
4
+ import * as Stream from "effect/Stream";
2
5
 
3
6
  export function recordedSignals<A, E = never>() {
4
7
  const values: A[] = [];
@@ -1,4 +1,4 @@
1
- import { Effect } from "effect";
1
+ import * as Effect from "effect/Effect";
2
2
  import { broken, cannotRun, unfinished } from "#internal/errors.ts";
3
3
  import { type AnyEffect, type Hook, hooked } from "#internal/hooked.ts";
4
4
  import type { RunUntilOptions } from "#storyKit.ts";
@@ -0,0 +1,21 @@
1
+ import { isInaccessible } from "dom-accessibility-api";
2
+ import { screenQueries } from "#adapters/screenQueries.ts";
3
+ import { isRendered } from "./screenAccessibility.ts";
4
+ import { screenText } from "./screenText.ts";
5
+
6
+ export function screenLoading(root: () => HTMLElement, dialogs: boolean) {
7
+ const queries = screenQueries(root, dialogs);
8
+ const indicators = '[role~="status"],[aria-busy="true"],dialog[open],[role~="dialog"],[role~="alertdialog"]';
9
+ function visible(element: HTMLElement) {
10
+ return element.isConnected && element.closest("dialog:not([open])") === null && isRendered(element) && !isInaccessible(element);
11
+ }
12
+ return () => {
13
+ const current = root();
14
+ if ([current, ...queries.query(indicators)].some((element) => element.matches(indicators) && visible(element))) {
15
+ return true;
16
+ }
17
+ return [current, ...queries.query("*")].some(
18
+ (element) => visible(element) && /^Loading(?:…|\.{3})$/iu.test(screenText(element).replace(/\s+/gu, " ").trim()),
19
+ );
20
+ };
21
+ }
@@ -1,9 +1,11 @@
1
- import { Effect } from "effect";
1
+ import * as Effect from "effect/Effect";
2
2
  import { withLive } from "@shivaedev/test/withLive.ts";
3
3
  import type { screenElements } from "#adapters/screenElements.ts";
4
4
  import { screenNavigation } from "#adapters/screenNavigation.ts";
5
5
  import type { ScreenDriverOptions, ScreenTarget } from "#screenDriver.ts";
6
+ import { loadingDeadline } from "./loadingDeadline.ts";
6
7
  import { targetName } from "./screenAccessibility.ts";
8
+ import { screenLoading } from "./screenLoading.ts";
7
9
  import { waitForScreen } from "./waitForScreen.ts";
8
10
 
9
11
  type Options = Omit<ScreenDriverOptions, "act" | "root" | "timeoutMs" | "pending"> & {
@@ -13,18 +15,24 @@ type Options = Omit<ScreenDriverOptions, "act" | "root" | "timeoutMs" | "pending
13
15
  readonly timeoutMs: number;
14
16
  };
15
17
 
16
- export function screenWaits(options: Options, elements: ReturnType<typeof screenElements>) {
18
+ export function screenWaits(options: Options, elements: ReturnType<typeof screenElements>, dialogs: boolean) {
17
19
  const { act, pending, root, tell, timeoutMs } = options;
20
+ const loading = screenLoading(root, dialogs);
18
21
  function unsettled(limit: number) {
19
22
  return new Error(
20
23
  `The screen did not settle within ${limit}ms.\nhelp: Release held requests and check the app's pending signal and renderer act adapter.\nScreen: ${root().textContent}`,
21
24
  );
22
25
  }
23
- function wait<A>(line: string, read: () => A, timeout: number, expired: () => Effect.Effect<A>) {
26
+ function wait<A>(line: string, read: () => A, timeout: number | undefined, expired: () => Effect.Effect<A>) {
27
+ const limit = timeout ?? timeoutMs;
24
28
  return withLive(
25
29
  Effect.sync(() => tell(line)).pipe(
26
- Effect.andThen(waitForScreen({ act, pending, root }, Effect.try(read))),
27
- Effect.timeoutOrElse({ duration: timeout, orElse: expired }),
30
+ Effect.andThen(
31
+ Effect.raceFirst(
32
+ waitForScreen({ act, pending, root }, Effect.try(read)),
33
+ loadingDeadline(root, loading, limit, timeout === undefined ? (options.loadingTimeoutMs ?? 10_000) : limit, expired),
34
+ ),
35
+ ),
28
36
  ),
29
37
  );
30
38
  }
@@ -34,7 +42,7 @@ export function screenWaits(options: Options, elements: ReturnType<typeof screen
34
42
  return wait(
35
43
  `find ${targetName(target)}`,
36
44
  () => elements.element(target),
37
- limit,
45
+ settings.timeout,
38
46
  () => {
39
47
  const lookup = Effect.sync(() => elements.element(target));
40
48
  return pending === undefined ? lookup : lookup.pipe(Effect.andThen(Effect.die(unsettled(limit))));
@@ -47,7 +55,7 @@ export function screenWaits(options: Options, elements: ReturnType<typeof screen
47
55
  return wait(
48
56
  `find text ${name}`,
49
57
  () => elements.textElement(text),
50
- limit,
58
+ settings.timeout,
51
59
  () =>
52
60
  Effect.sync(() => elements.textElement(text)).pipe(
53
61
  Effect.andThen(
@@ -1,4 +1,8 @@
1
- import { Cause, Context, Effect, type Scope, Tracer } from "effect";
1
+ import * as Cause from "effect/Cause";
2
+ import * as Context from "effect/Context";
3
+ import * as Effect from "effect/Effect";
4
+ import type * as Scope from "effect/Scope";
5
+ import * as Tracer from "effect/Tracer";
2
6
  import type { AnyTestLayer } from "@shivaedev/test/anyTestLayer.ts";
3
7
  import type { EffectClock } from "@shivaedev/test/types.ts";
4
8
  import { refusal } from "#internal/errors.ts";
@@ -1,8 +1,11 @@
1
- import { Cause, Context, Effect, Tracer } from "effect";
1
+ import * as Cause from "effect/Cause";
2
+ import * as Context from "effect/Context";
3
+ import * as Effect from "effect/Effect";
4
+ import * as Tracer from "effect/Tracer";
2
5
  import type { TestContext } from "vitest";
3
6
  import { callSite } from "#internal/callSite.ts";
4
7
  import { hooked } from "#internal/hooked.ts";
5
- import { narrate } from "#internal/narration.ts";
8
+ import { narrate, narrateCreation } from "#internal/narration.ts";
6
9
  import { runUntil } from "#internal/runUntil.ts";
7
10
  import { type LooseDefinition, type LooseStory, type LooseTrait, seed } from "#internal/seed.ts";
8
11
 
@@ -12,8 +15,11 @@ export const start = Effect.fnUntraced(function* (
12
15
  context: TestContext,
13
16
  body: (told: object) => Effect.Effect<unknown, unknown, unknown>,
14
17
  ) {
15
- const engine = yield* hooked(definition.create).pipe(Effect.updateContext(Context.omit(Tracer.ParentSpan)));
16
- const { narration, captureFailure } = narrate({ engine, inspect: definition.inspect, name: definition.name }, context);
18
+ const engine = yield* hooked(definition.create).pipe(
19
+ Effect.updateContext(Context.omit(Tracer.ParentSpan)),
20
+ Effect.tapCause(() => narrateCreation(definition.name, context)),
21
+ );
22
+ const { narration, captureFailure } = yield* narrate({ engine, inspect: definition.inspect, name: definition.name }, context);
17
23
  return yield* Effect.gen(function* () {
18
24
  yield* seed(definition, engine, narration, given);
19
25
  const story: LooseStory = {
@@ -1,6 +1,7 @@
1
- import { NodeCrypto } from "@effect/platform-node";
1
+ import * as NodeCrypto from "@effect/platform-node/NodeCrypto";
2
2
  import type { TestContext } from "@effect/vitest";
3
- import { Effect, Layer } from "effect";
3
+ import * as Effect from "effect/Effect";
4
+ import * as Layer from "effect/Layer";
4
5
  import * as TestCrypto from "effect/testing/TestCrypto";
5
6
  import { makeEffectIt } from "@shivaedev/test/makeEffectIt.ts";
6
7
  import type { EffectTest, EffectTestOptions } from "@shivaedev/test/types.ts";
@@ -0,0 +1,62 @@
1
+ import * as Duration from "effect/Duration";
2
+ import * as Cookies from "effect/http/Cookies";
3
+
4
+ interface StoredCookie {
5
+ readonly cookie: Cookies.Cookie;
6
+ readonly domain: string;
7
+ readonly expires: number;
8
+ readonly hostOnly: boolean;
9
+ readonly path: string;
10
+ }
11
+
12
+ function matchesDomain(host: string, domain: string, hostOnly: boolean) {
13
+ return host === domain || (!hostOnly && host.endsWith(`.${domain}`));
14
+ }
15
+
16
+ function scopeCookie(cookie: Cookies.Cookie, url: URL, now: number): StoredCookie | undefined {
17
+ const options = cookie.options;
18
+ const domain = options?.domain?.toLowerCase() ?? url.hostname;
19
+ const hostOnly = options?.domain === undefined;
20
+ if (!matchesDomain(url.hostname, domain, hostOnly) || (options?.secure && url.protocol !== "https:")) {
21
+ return undefined;
22
+ }
23
+ const defaultPath = url.pathname.slice(0, url.pathname.lastIndexOf("/")) || "/";
24
+ const path = options?.path?.startsWith("/") ? options.path : defaultPath;
25
+ const expires = options?.maxAge === undefined ? (options?.expires?.getTime() ?? Number.POSITIVE_INFINITY) : now + Duration.toMillis(options.maxAge);
26
+ return { cookie, domain, expires, hostOnly, path };
27
+ }
28
+
29
+ export function visitorCookies() {
30
+ const stored = new Map<string, StoredCookie>();
31
+ return {
32
+ header(url: URL, now: number) {
33
+ return [...stored.values()]
34
+ .filter(
35
+ ({ cookie, domain, expires, hostOnly, path }) =>
36
+ expires > now
37
+ && matchesDomain(url.hostname, domain, hostOnly)
38
+ && (!cookie.options?.secure || url.protocol === "https:")
39
+ && (url.pathname === path || url.pathname.startsWith(path.endsWith("/") ? path : `${path}/`)),
40
+ )
41
+ .sort((left, right) => right.path.length - left.path.length)
42
+ .map(({ cookie }) => `${cookie.name}=${cookie.valueEncoded}`)
43
+ .join("; ");
44
+ },
45
+ keep(headers: readonly string[], url: URL, now: number) {
46
+ for (const header of headers) {
47
+ for (const cookie of Object.values(Cookies.fromSetCookie(header).cookies)) {
48
+ const scoped = scopeCookie(cookie, url, now);
49
+ if (scoped === undefined) {
50
+ continue;
51
+ }
52
+ const key = JSON.stringify([scoped.domain, scoped.path, cookie.name]);
53
+ if (scoped.expires <= now) {
54
+ stored.delete(key);
55
+ } else {
56
+ stored.set(key, scoped);
57
+ }
58
+ }
59
+ }
60
+ },
61
+ };
62
+ }
@@ -1,5 +1,9 @@
1
- import { Effect, Queue, Result, Stream } from "effect";
1
+ import * as Effect from "effect/Effect";
2
+ import * as Queue from "effect/Queue";
3
+ import * as Result from "effect/Result";
4
+ import * as Stream from "effect/Stream";
2
5
  import { isClientIdle } from "@shivaedev/contract/clientActivity.ts";
6
+ import { screenAct } from "#adapters/screenAct.ts";
3
7
  import { screenMutations } from "#adapters/screenMutations.ts";
4
8
  import type { ScreenDriverOptions } from "#screenDriver.ts";
5
9
 
@@ -35,7 +39,7 @@ export const waitForScreen = Effect.fnUntraced(function* <A, E>({ act, pending,
35
39
  const isBusy = yield* observePending(pending, changes);
36
40
  do {
37
41
  if (pending !== undefined) {
38
- yield* Effect.promise(() => act(() => Promise.resolve()));
42
+ yield* screenAct(act, Effect.void);
39
43
  }
40
44
  if (!(yield* isBusy)) {
41
45
  const result = yield* Effect.result(read);
@@ -43,6 +47,6 @@ export const waitForScreen = Effect.fnUntraced(function* <A, E>({ act, pending,
43
47
  return result.success;
44
48
  }
45
49
  }
46
- yield* pending === undefined ? Queue.take(changes) : Effect.promise((signal) => act(() => Effect.runPromise(Queue.take(changes), { signal })));
50
+ yield* pending === undefined ? Queue.take(changes) : screenAct(act, Queue.take(changes));
47
51
  } while (true);
48
52
  }, Effect.scoped);
@@ -1,4 +1,5 @@
1
- import { Clock, Effect } from "effect";
1
+ import * as Clock from "effect/Clock";
2
+ import * as Effect from "effect/Effect";
2
3
  import { watchedClock } from "#watchedClock.ts";
3
4
 
4
5
  export function withWatchedClock<A, E, R>(effect: Effect.Effect<A, E, R>) {
@@ -1,6 +1,6 @@
1
1
  import { createInterface } from "node:readline";
2
2
  import type { Readable } from "node:stream";
3
- import { Effect } from "effect";
3
+ import * as Effect from "effect/Effect";
4
4
  import { recordedSignals } from "#internal/recordedSignals.ts";
5
5
  import { type UntilOptions, until } from "#until.ts";
6
6
 
@@ -1,9 +1,9 @@
1
- import { Effect, Option, type Scope } from "effect";
2
- import * as AtomRegistry from "effect/reactivity/AtomRegistry";
3
- import { GlobalWindow } from "happy-dom";
1
+ import * as Effect from "effect/Effect";
2
+ import * as Option from "effect/Option";
3
+ import type * as AtomRegistry from "effect/reactivity/AtomRegistry";
4
+ import type * as Scope from "effect/Scope";
4
5
  import { domFetch } from "#domFetch.ts";
5
6
  import { memberFetch } from "#internal/adapters/memberFetch.ts";
6
- import { documentTransport } from "#internal/documentTransport.ts";
7
7
  import { type DomCookie, seedCookies } from "#seedCookies.ts";
8
8
 
9
9
  export interface MemberScreen {
@@ -21,6 +21,9 @@ export function memberScreens<E, R, TVerbs>(options: {
21
21
  const members = new Map<string, MemberScreen>();
22
22
  return {
23
23
  open: Effect.fnUntraced(function* (name: string, cookies: readonly DomCookie[]) {
24
+ const [{ GlobalWindow }, registryModule, { documentTransport }] = yield* Effect.promise(() =>
25
+ Promise.all([import("happy-dom"), import("effect/reactivity/AtomRegistry"), import("#internal/documentTransport.ts")]),
26
+ );
24
27
  const browser = yield* Effect.acquireRelease(
25
28
  Effect.sync(() => new GlobalWindow({ url: options.baseUrl })),
26
29
  (target) => Effect.promise(() => target.happyDOM.abort()).pipe(Effect.andThen(Effect.sync(() => target.close()))),
@@ -34,7 +37,7 @@ export function memberScreens<E, R, TVerbs>(options: {
34
37
  return {
35
38
  fetch: domFetch(options.baseUrl, { fetch: memberFetch(browser), location: browser.location }),
36
39
  name,
37
- registry: AtomRegistry.make(),
40
+ registry: registryModule.make(),
38
41
  root,
39
42
  };
40
43
  }),