@shivaedev/test-story 0.35.0 → 0.37.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 (154) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/README.md +30 -7
  3. package/dist/server/{internal → adapters}/callSite.d.ts.map +1 -1
  4. package/dist/server/{internal → adapters}/callSite.js.map +1 -1
  5. package/dist/server/adapters/declareGenre.d.ts +3 -0
  6. package/dist/server/adapters/declareGenre.d.ts.map +1 -0
  7. package/dist/server/adapters/declareGenre.js +20 -0
  8. package/dist/server/adapters/declareGenre.js.map +1 -0
  9. package/dist/server/{internal → adapters}/engineSnapshot.d.ts +1 -1
  10. package/dist/server/{internal → adapters}/engineSnapshot.d.ts.map +1 -1
  11. package/dist/server/{internal → adapters}/engineSnapshot.js +5 -1
  12. package/dist/server/adapters/engineSnapshot.js.map +1 -0
  13. package/dist/server/adapters/engineSummary.d.ts +2 -0
  14. package/dist/server/adapters/engineSummary.d.ts.map +1 -0
  15. package/dist/server/adapters/engineSummary.js +14 -0
  16. package/dist/server/adapters/engineSummary.js.map +1 -0
  17. package/dist/server/{internal → adapters}/failureReport.d.ts.map +1 -1
  18. package/dist/server/{internal → adapters}/failureReport.js +2 -2
  19. package/dist/server/{internal → adapters}/failureReport.js.map +1 -1
  20. package/dist/server/{internal → adapters}/fakeHttpAnswer.d.ts.map +1 -1
  21. package/dist/server/{internal → adapters}/fakeHttpAnswer.js +1 -1
  22. package/dist/server/{internal → adapters}/fakeHttpAnswer.js.map +1 -1
  23. package/dist/server/{internal → adapters}/fakeHttpReceive.d.ts.map +1 -1
  24. package/dist/server/{internal → adapters}/fakeHttpReceive.js +2 -2
  25. package/dist/server/{internal → adapters}/fakeHttpReceive.js.map +1 -1
  26. package/dist/server/adapters/fakeHttpRuntime.d.ts +34 -0
  27. package/dist/server/adapters/fakeHttpRuntime.d.ts.map +1 -0
  28. package/dist/server/adapters/fakeHttpRuntime.js +19 -0
  29. package/dist/server/adapters/fakeHttpRuntime.js.map +1 -0
  30. package/dist/server/{internal → adapters}/fakeHttpSend.d.ts +1 -0
  31. package/dist/server/{internal → adapters}/fakeHttpSend.d.ts.map +1 -1
  32. package/dist/server/{internal → adapters}/fakeHttpSend.js +5 -0
  33. package/dist/server/{internal → adapters}/fakeHttpSend.js.map +1 -1
  34. package/dist/server/{internal → adapters}/loopback.d.ts.map +1 -1
  35. package/dist/server/{internal → adapters}/loopback.js.map +1 -1
  36. package/dist/server/adapters/makeForwardingProxy.d.ts +2 -0
  37. package/dist/server/adapters/makeForwardingProxy.d.ts.map +1 -1
  38. package/dist/server/adapters/makeForwardingProxy.js +5 -0
  39. package/dist/server/adapters/makeForwardingProxy.js.map +1 -1
  40. package/dist/server/adapters/otlpProtobuf.d.ts.map +1 -0
  41. package/dist/server/{internal → adapters}/otlpProtobuf.js +1 -1
  42. package/dist/server/{internal → adapters}/otlpProtobuf.js.map +1 -1
  43. package/dist/server/{internal → adapters}/otlpWire.d.ts.map +1 -1
  44. package/dist/server/{internal → adapters}/otlpWire.js.map +1 -1
  45. package/dist/server/adapters/receiveOtlp.d.ts +3 -1
  46. package/dist/server/adapters/receiveOtlp.d.ts.map +1 -1
  47. package/dist/server/adapters/receiveOtlp.js +5 -0
  48. package/dist/server/adapters/receiveOtlp.js.map +1 -1
  49. package/dist/server/adapters/recordLines.d.ts +9 -0
  50. package/dist/server/adapters/recordLines.d.ts.map +1 -0
  51. package/dist/server/adapters/recordLines.js +15 -0
  52. package/dist/server/adapters/recordLines.js.map +1 -0
  53. package/dist/server/adapters/screenAct.d.ts +2 -0
  54. package/dist/server/adapters/screenAct.d.ts.map +1 -1
  55. package/dist/server/adapters/screenAct.js +7 -0
  56. package/dist/server/adapters/screenAct.js.map +1 -1
  57. package/dist/server/adapters/screenMutations.js +1 -1
  58. package/dist/server/adapters/screenMutations.js.map +1 -1
  59. package/dist/server/adapters/storyFailure.d.ts +1 -1
  60. package/dist/server/adapters/writeSnapshot.d.ts +1 -1
  61. package/dist/server/fakeHttpService.d.ts +9 -3
  62. package/dist/server/fakeHttpService.d.ts.map +1 -1
  63. package/dist/server/fakeHttpService.js +12 -24
  64. package/dist/server/fakeHttpService.js.map +1 -1
  65. package/dist/server/forwardingProxy.d.ts.map +1 -1
  66. package/dist/server/forwardingProxy.js +3 -4
  67. package/dist/server/forwardingProxy.js.map +1 -1
  68. package/dist/server/internal/compose.d.ts.map +1 -1
  69. package/dist/server/internal/compose.js +2 -1
  70. package/dist/server/internal/compose.js.map +1 -1
  71. package/dist/server/internal/fakeHttpControls.d.ts +10 -4
  72. package/dist/server/internal/fakeHttpControls.d.ts.map +1 -1
  73. package/dist/server/internal/fakeHttpControls.js +9 -12
  74. package/dist/server/internal/fakeHttpControls.js.map +1 -1
  75. package/dist/server/internal/fakeHttpGates.d.ts +6 -2
  76. package/dist/server/internal/fakeHttpGates.d.ts.map +1 -1
  77. package/dist/server/internal/fakeHttpGates.js +3 -3
  78. package/dist/server/internal/fakeHttpGates.js.map +1 -1
  79. package/dist/server/internal/narration.d.ts.map +1 -1
  80. package/dist/server/internal/narration.js +6 -4
  81. package/dist/server/internal/narration.js.map +1 -1
  82. package/dist/server/internal/otlpReadout.js +1 -1
  83. package/dist/server/internal/seed.d.ts +4 -9
  84. package/dist/server/internal/seed.d.ts.map +1 -1
  85. package/dist/server/internal/seed.js +11 -3
  86. package/dist/server/internal/seed.js.map +1 -1
  87. package/dist/server/internal/start.d.ts +6 -2
  88. package/dist/server/internal/start.d.ts.map +1 -1
  89. package/dist/server/internal/start.js +16 -8
  90. package/dist/server/internal/start.js.map +1 -1
  91. package/dist/server/internal/storyIt.d.ts.map +1 -1
  92. package/dist/server/internal/storyIt.js +2 -21
  93. package/dist/server/internal/storyIt.js.map +1 -1
  94. package/dist/server/internal/traits.js +1 -1
  95. package/dist/server/lineSignals.d.ts.map +1 -1
  96. package/dist/server/lineSignals.js +2 -10
  97. package/dist/server/lineSignals.js.map +1 -1
  98. package/dist/server/otlpReceiver.d.ts +1 -1
  99. package/dist/server/otlpReceiver.d.ts.map +1 -1
  100. package/dist/server/otlpReceiver.js +3 -4
  101. package/dist/server/otlpReceiver.js.map +1 -1
  102. package/dist/server/screenDriver.d.ts.map +1 -1
  103. package/dist/server/screenDriver.js +3 -8
  104. package/dist/server/screenDriver.js.map +1 -1
  105. package/dist/server/storyKit.d.ts +9 -7
  106. package/dist/server/storyKit.d.ts.map +1 -1
  107. package/dist/server/storyKit.js.map +1 -1
  108. package/package.json +5 -5
  109. package/src/server/adapters/declareGenre.ts +27 -0
  110. package/src/server/{internal → adapters}/engineSnapshot.ts +6 -2
  111. package/src/server/adapters/engineSummary.ts +15 -0
  112. package/src/server/{internal → adapters}/failureReport.ts +2 -2
  113. package/src/server/{internal → adapters}/fakeHttpAnswer.ts +1 -1
  114. package/src/server/{internal → adapters}/fakeHttpReceive.ts +2 -2
  115. package/src/server/adapters/fakeHttpRuntime.ts +20 -0
  116. package/src/server/{internal → adapters}/fakeHttpSend.ts +6 -0
  117. package/src/server/adapters/makeForwardingProxy.ts +6 -0
  118. package/src/server/{internal → adapters}/otlpProtobuf.ts +1 -1
  119. package/src/server/adapters/receiveOtlp.ts +6 -1
  120. package/src/server/adapters/recordLines.ts +19 -0
  121. package/src/server/adapters/screenAct.ts +10 -0
  122. package/src/server/adapters/screenMutations.ts +1 -1
  123. package/src/server/adapters/storyFailure.ts +1 -1
  124. package/src/server/adapters/writeSnapshot.ts +1 -1
  125. package/src/server/fakeHttpService.ts +15 -26
  126. package/src/server/forwardingProxy.ts +3 -4
  127. package/src/server/internal/compose.ts +2 -1
  128. package/src/server/internal/fakeHttpControls.ts +16 -15
  129. package/src/server/internal/fakeHttpGates.ts +6 -4
  130. package/src/server/internal/narration.ts +6 -4
  131. package/src/server/internal/otlpReadout.ts +1 -1
  132. package/src/server/internal/seed.ts +16 -13
  133. package/src/server/internal/start.ts +39 -24
  134. package/src/server/internal/storyIt.ts +2 -21
  135. package/src/server/internal/traits.ts +1 -1
  136. package/src/server/lineSignals.ts +2 -13
  137. package/src/server/otlpReceiver.ts +4 -4
  138. package/src/server/screenDriver.ts +3 -17
  139. package/src/server/storyKit.ts +13 -7
  140. package/dist/server/internal/engineSnapshot.js.map +0 -1
  141. package/dist/server/internal/otlpProtobuf.d.ts.map +0 -1
  142. /package/dist/server/{internal → adapters}/callSite.d.ts +0 -0
  143. /package/dist/server/{internal → adapters}/callSite.js +0 -0
  144. /package/dist/server/{internal → adapters}/failureReport.d.ts +0 -0
  145. /package/dist/server/{internal → adapters}/fakeHttpAnswer.d.ts +0 -0
  146. /package/dist/server/{internal → adapters}/fakeHttpReceive.d.ts +0 -0
  147. /package/dist/server/{internal → adapters}/loopback.d.ts +0 -0
  148. /package/dist/server/{internal → adapters}/loopback.js +0 -0
  149. /package/dist/server/{internal → adapters}/otlpProtobuf.d.ts +0 -0
  150. /package/dist/server/{internal → adapters}/otlpWire.d.ts +0 -0
  151. /package/dist/server/{internal → adapters}/otlpWire.js +0 -0
  152. /package/src/server/{internal → adapters}/callSite.ts +0 -0
  153. /package/src/server/{internal → adapters}/loopback.ts +0 -0
  154. /package/src/server/{internal → adapters}/otlpWire.ts +0 -0
@@ -0,0 +1,15 @@
1
+ import { inspect } from "node:util";
2
+
3
+ const MAX_CHARACTERS = 2000;
4
+
5
+ export function engineSummary(engine: unknown): string {
6
+ const summary = inspect(engine, {
7
+ breakLength: 100,
8
+ customInspect: false,
9
+ depth: 2,
10
+ getters: false,
11
+ maxArrayLength: 10,
12
+ maxStringLength: 200,
13
+ });
14
+ return summary.length <= MAX_CHARACTERS ? summary : `${summary.slice(0, MAX_CHARACTERS)}…`;
15
+ }
@@ -1,7 +1,7 @@
1
1
  import { relative } from "node:path";
2
2
  import process from "node:process";
3
- import { locate } from "#server/internal/callSite.ts";
4
- import { engineSnapshot } from "#server/internal/engineSnapshot.ts";
3
+ import { locate } from "#server/adapters/callSite.ts";
4
+ import { engineSnapshot } from "#server/adapters/engineSnapshot.ts";
5
5
  import type { Narration, Subject } from "#server/internal/narration.ts";
6
6
  import { describeValue } from "#server/internal/render.ts";
7
7
  import { explained, WIDTH, wrap } from "#server/internal/wrap.ts";
@@ -1,8 +1,8 @@
1
1
  import type { ServerResponse } from "node:http";
2
2
  import * as HttpStatus from "effect/http/HttpStatus";
3
+ import { fakeHttpSend, fakeHttpStrike } from "#server/adapters/fakeHttpSend.ts";
3
4
  import type { FakeHttpReply, FakeHttpRequest, FakeHttpRoute } from "#server/fakeHttpService.ts";
4
5
  import type { fakeHttpControls } from "#server/internal/fakeHttpControls.ts";
5
- import { fakeHttpSend, fakeHttpStrike } from "#server/internal/fakeHttpSend.ts";
6
6
 
7
7
  function pageReply(route: FakeHttpRoute, request: FakeHttpRequest): FakeHttpReply {
8
8
  if (route.reply) {
@@ -1,9 +1,9 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import * as HttpStatus from "effect/http/HttpStatus";
3
+ import { fakeHttpAnswer } from "#server/adapters/fakeHttpAnswer.ts";
4
+ import { fakeHttpSend } from "#server/adapters/fakeHttpSend.ts";
3
5
  import type { FakeHttpRequestRecord, FakeHttpRoute, FakeHttpServiceOptions } from "#server/fakeHttpService.ts";
4
- import { fakeHttpAnswer } from "#server/internal/fakeHttpAnswer.ts";
5
6
  import type { fakeHttpControls } from "#server/internal/fakeHttpControls.ts";
6
- import { fakeHttpSend } from "#server/internal/fakeHttpSend.ts";
7
7
 
8
8
  function match(route: FakeHttpRoute, method: string, pathname: string) {
9
9
  if ((route.method ?? "GET").toUpperCase() !== method) {
@@ -0,0 +1,20 @@
1
+ import { createServer } from "node:http";
2
+ import * as Clock from "effect/Clock";
3
+ import * as Effect from "effect/Effect";
4
+ import type { FakeHttpRequestRecord, FakeHttpServiceOptions } from "#server/fakeHttpService.ts";
5
+ import { fakeHttpControls } from "#server/internal/fakeHttpControls.ts";
6
+ import { fakeHttpSignals } from "#server/internal/fakeHttpSignals.ts";
7
+ import { fakeHttpReceive } from "./fakeHttpReceive.ts";
8
+ import { loopbackServer } from "./loopback.ts";
9
+
10
+ export const fakeHttpRuntime = Effect.fnUntraced(function* (options: FakeHttpServiceOptions, tell: (line: string) => void) {
11
+ const clock = yield* Clock.Clock;
12
+ const requests: FakeHttpRequestRecord[] = [];
13
+ const controls = fakeHttpControls(tell, () => clock.currentTimeMillisUnsafe());
14
+ const signals = fakeHttpSignals();
15
+ const server = createServer((request, response) => fakeHttpReceive(request, response, options, requests, controls, tell, signals.record));
16
+ const url = yield* loopbackServer(server);
17
+ yield* Effect.addFinalizer(() => Effect.sync(signals.close));
18
+ yield* Effect.addFinalizer(controls.close);
19
+ return { controls, requests, signals, url };
20
+ });
@@ -63,3 +63,9 @@ export async function fakeHttpStrike(response: ServerResponse, fault: Exclude<Fa
63
63
  }
64
64
  response.destroy();
65
65
  }
66
+
67
+ export async function fakeHttpPause(response: ServerResponse, pending: () => Promise<void> | undefined) {
68
+ const connection = fakeHttpConnection(response);
69
+ await connection.pause(pending());
70
+ return !(response.destroyed || response.writableEnded || response.headersSent);
71
+ }
@@ -1,7 +1,9 @@
1
1
  import { createServer, type IncomingMessage, request } from "node:http";
2
2
  import { isIP } from "node:net";
3
+ import * as Effect from "effect/Effect";
3
4
  import * as HttpStatus from "effect/http/HttpStatus";
4
5
  import type { ForwardingProxyOptions } from "#server/forwardingProxy.ts";
6
+ import { loopbackServer } from "./loopback.ts";
5
7
  import { proxyConnections } from "./proxyConnections.ts";
6
8
 
7
9
  export function makeForwardingProxy(upstream: string, options: ForwardingProxyOptions) {
@@ -57,3 +59,7 @@ export function makeForwardingProxy(upstream: string, options: ForwardingProxyOp
57
59
  });
58
60
  return { ...connections, server };
59
61
  }
62
+
63
+ export function checkLocalAddress(host: string) {
64
+ return Effect.scoped(loopbackServer(createServer(), { host }));
65
+ }
@@ -1,4 +1,4 @@
1
- import { type WireValue, wireFields } from "#server/internal/otlpWire.ts";
1
+ import { type WireValue, wireFields } from "#server/adapters/otlpWire.ts";
2
2
 
3
3
  type Scalar = "string" | "hex" | "base64" | "number" | "integer" | "boolean" | "double" | "fixed64";
4
4
  type Field = readonly [name: string, type: Scalar | (() => Descriptor), repeated?: boolean];
@@ -1,4 +1,5 @@
1
- import type { IncomingMessage, ServerResponse } from "node:http";
1
+ import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
2
+ import * as Effect from "effect/Effect";
2
3
  import * as HttpStatus from "effect/http/HttpStatus";
3
4
  import type { OtlpExport, OtlpReceiverOptions, OtlpSpan } from "#server/otlpReceiver.ts";
4
5
 
@@ -43,3 +44,7 @@ export async function receiveOtlp(
43
44
  response.writeHead(HttpStatus.fromLiteral("BadRequest")).end();
44
45
  }
45
46
  }
47
+
48
+ export function otlpServer(requests: OtlpExport[], record: (span: OtlpSpan) => void, options: OtlpReceiverOptions) {
49
+ return Effect.sync(() => createServer((request, response) => receiveOtlp(request, response, requests, record, options)));
50
+ }
@@ -0,0 +1,19 @@
1
+ import { createInterface } from "node:readline";
2
+ import type { Readable } from "node:stream";
3
+ import * as Effect from "effect/Effect";
4
+ import { recordedSignals } from "#server/internal/recordedSignals.ts";
5
+
6
+ export const recordLines = Effect.fnUntraced(function* (output: Readable) {
7
+ const signals = recordedSignals<string, Error>();
8
+ yield* Effect.acquireRelease(
9
+ Effect.sync(() => {
10
+ const reader = createInterface({ crlfDelay: Number.POSITIVE_INFINITY, input: output });
11
+ reader.on("line", signals.push);
12
+ reader.once("close", () => signals.end());
13
+ reader.on("error", signals.end);
14
+ return reader;
15
+ }),
16
+ (reader) => Effect.sync(() => reader.close()),
17
+ );
18
+ return signals;
19
+ });
@@ -18,3 +18,13 @@ export function screenAct<E>(act: NonNullable<ScreenDriverOptions["act"]>, actio
18
18
  return Effect.promise(() => completed);
19
19
  });
20
20
  }
21
+
22
+ export const directScreenAct: NonNullable<ScreenDriverOptions["act"]> = (action) => action();
23
+
24
+ export function screenPerform(act: NonNullable<ScreenDriverOptions["act"]>, tell: (line: string) => void) {
25
+ return (line: string, action: () => void) =>
26
+ Effect.promise(async () => {
27
+ tell(line);
28
+ await act(async () => action());
29
+ });
30
+ }
@@ -3,7 +3,7 @@ import * as Effect from "effect/Effect";
3
3
  export function screenMutations(root: HTMLElement, changed: () => void) {
4
4
  return Effect.acquireRelease(
5
5
  Effect.sync(() => {
6
- const observer = new MutationObserver(changed);
6
+ const observer = new (root.ownerDocument.defaultView ?? globalThis).MutationObserver(changed);
7
7
  // Root getters can follow navigation, and visibility can change on an ancestor.
8
8
  observer.observe(root.ownerDocument, { attributes: true, characterData: true, childList: true, subtree: true });
9
9
  observer.observe(root, { attributes: true, characterData: true, childList: true, subtree: true });
@@ -1,6 +1,6 @@
1
1
  import * as Effect from "effect/Effect";
2
2
  import type { TestContext } from "vitest";
3
- import type { FailedTest } from "#server/internal/failureReport.ts";
3
+ import type { FailedTest } from "#server/adapters/failureReport.ts";
4
4
  import { describeFailure } from "#server/internal/render.ts";
5
5
 
6
6
  export type FailureContext = Pick<TestContext, "onTestFailed" | "task">;
@@ -1,7 +1,7 @@
1
1
  import { mkdirSync, writeFileSync } from "node:fs";
2
2
  import { basename, dirname, join, relative } from "node:path";
3
3
  import process from "node:process";
4
- import type { FailedTest } from "#server/internal/failureReport.ts";
4
+ import type { FailedTest } from "#server/adapters/failureReport.ts";
5
5
  import { describeValue, toJson } from "#server/internal/render.ts";
6
6
  import { wrap } from "#server/internal/wrap.ts";
7
7
 
@@ -1,10 +1,6 @@
1
- import { createServer, type IncomingHttpHeaders } from "node:http";
2
- import * as Clock from "effect/Clock";
1
+ import type { IncomingHttpHeaders } from "node:http";
3
2
  import * as Effect from "effect/Effect";
4
- import { fakeHttpControls } from "#server/internal/fakeHttpControls.ts";
5
- import { fakeHttpReceive } from "#server/internal/fakeHttpReceive.ts";
6
- import { fakeHttpSignals } from "#server/internal/fakeHttpSignals.ts";
7
- import { loopbackServer } from "#server/internal/loopback.ts";
3
+ import { fakeHttpRuntime } from "#server/adapters/fakeHttpRuntime.ts";
8
4
  import { type UntilOptions, until } from "#server/until.ts";
9
5
 
10
6
  export interface FakeHttpRequest {
@@ -69,45 +65,38 @@ export interface FakeHttpHold {
69
65
  }
70
66
 
71
67
  export const fakeHttpService = Effect.fnUntraced(function* (options: FakeHttpServiceOptions) {
72
- const clock = yield* Clock.Clock;
73
- const requests: FakeHttpRequestRecord[] = [];
74
68
  let narrate = options.tell;
75
69
  function tell(line: string) {
76
70
  narrate?.(line);
77
71
  }
78
- const controls = fakeHttpControls(tell, () => clock.currentTimeMillisUnsafe());
79
- const signals = fakeHttpSignals();
80
- const server = createServer((request, response) => fakeHttpReceive(request, response, options, requests, controls, tell, signals.record));
81
- const url = yield* loopbackServer(server);
82
-
83
- yield* Effect.addFinalizer(() => Effect.sync(signals.close));
84
- yield* Effect.addFinalizer(controls.close);
85
- function checkRoute(route: string) {
72
+ const { controls, signals, requests, url } = yield* fakeHttpRuntime(options, tell);
73
+ const checkRoute = Effect.fnUntraced(function* (route: string) {
86
74
  if (!Object.hasOwn(options.routes, route)) {
87
- throw new Error(`Unknown fake HTTP route "${route}".\nhelp: Use a name from fakeHttpService's routes when scripting a reply or hold.`);
75
+ return yield* Effect.die(
76
+ new Error(`Unknown fake HTTP route "${route}".\nhelp: Use a name from fakeHttpService's routes when scripting a reply or hold.`),
77
+ );
88
78
  }
89
- }
79
+ });
90
80
  return {
91
81
  completed: signals.completed,
92
82
  fault: (route: string, fault: FakeHttpFault, scope?: FakeHttpScope) =>
93
- Effect.sync(() => checkRoute(route)).pipe(Effect.andThen(controls.fault(route, fault, scope))),
94
- hold: (route: string, holdOptions?: FakeHttpHoldOptions) =>
95
- Effect.sync(() => checkRoute(route)).pipe(Effect.andThen(controls.hold(route, holdOptions))),
83
+ checkRoute(route).pipe(Effect.andThen(controls.fault(route, fault, scope))),
84
+ hold: (route: string, holdOptions?: FakeHttpHoldOptions) => checkRoute(route).pipe(Effect.andThen(controls.hold(route, holdOptions))),
96
85
  narrate: (sink: (line: string) => void) => {
97
86
  narrate = sink;
98
87
  },
99
88
  received: signals.received,
100
89
  releaseOnArrival: (route: string, arrival: string, scope?: FakeHttpScope) =>
101
- Effect.sync(() => {
102
- checkRoute(route);
103
- checkRoute(arrival);
90
+ Effect.gen(function* () {
91
+ yield* checkRoute(route);
92
+ yield* checkRoute(arrival);
104
93
  }).pipe(Effect.andThen(controls.releaseOnArrival(route, arrival, scope))),
105
94
  get requests(): readonly FakeHttpRequestRecord[] {
106
95
  return requests.slice();
107
96
  },
108
97
  scriptFault: (route: string, fault: FakeHttpFault, scriptOptions?: FakeHttpScriptOptions) =>
109
- Effect.sync(() => checkRoute(route)).pipe(Effect.andThen(controls.scriptFault(route, fault, scriptOptions))),
110
- stall: (route: string, scope?: FakeHttpScope) => Effect.sync(() => checkRoute(route)).pipe(Effect.andThen(controls.stall(route, scope))),
98
+ checkRoute(route).pipe(Effect.andThen(controls.scriptFault(route, fault, scriptOptions))),
99
+ stall: (route: string, scope?: FakeHttpScope) => checkRoute(route).pipe(Effect.andThen(controls.stall(route, scope))),
111
100
  untilAbandoned: (matches: (request: FakeHttpRequestRecord) => boolean, wait: UntilOptions) => until(signals.abandoned, matches, wait),
112
101
  url,
113
102
  };
@@ -1,7 +1,6 @@
1
- import { createServer } from "node:http";
2
1
  import * as Effect from "effect/Effect";
3
- import { makeForwardingProxy } from "#server/adapters/makeForwardingProxy.ts";
4
- import { loopbackServer } from "#server/internal/loopback.ts";
2
+ import { loopbackServer } from "#server/adapters/loopback.ts";
3
+ import { checkLocalAddress, makeForwardingProxy } from "#server/adapters/makeForwardingProxy.ts";
5
4
 
6
5
  export interface ForwardingProxyOptions {
7
6
  readonly forwardedHops?: readonly string[];
@@ -11,7 +10,7 @@ export interface ForwardingProxyOptions {
11
10
 
12
11
  export const forwardingProxy = Effect.fnUntraced(function* (upstream: string, options: ForwardingProxyOptions = {}) {
13
12
  if (options.localAddress !== undefined) {
14
- yield* Effect.scoped(loopbackServer(createServer(), { host: options.localAddress })).pipe(
13
+ yield* checkLocalAddress(options.localAddress).pipe(
15
14
  Effect.mapError((cause) => new Error(`Cannot acquire forwarding proxy with local address ${options.localAddress}`, { cause })),
16
15
  );
17
16
  }
@@ -1,6 +1,7 @@
1
1
  import * as Effect from "effect/Effect";
2
2
  import * as Layer from "effect/Layer";
3
3
  import type { AnyTestLayer } from "@shivaedev/test/types.ts";
4
+ import { engineSummary } from "#server/adapters/engineSummary.ts";
4
5
  import { type KitList, kitDefinition } from "#server/internal/compositionTypes.ts";
5
6
  import { hooked } from "#server/internal/hooked.ts";
6
7
  import { runUntil } from "#server/internal/runUntil.ts";
@@ -25,7 +26,7 @@ export function compose(name: string, kits: KitList): LooseDefinition {
25
26
  },
26
27
  inspect: (engine) =>
27
28
  Effect.forEach(definitions, (definition) =>
28
- hooked(() => (definition.inspect === undefined ? engine : definition.inspect(engine))).pipe(
29
+ hooked(() => (definition.inspect === undefined ? engineSummary(engine) : definition.inspect(engine))).pipe(
29
30
  Effect.map((value) => [definition.name, value] as const),
30
31
  ),
31
32
  ).pipe(Effect.map(Object.fromEntries)),
@@ -1,5 +1,6 @@
1
1
  import type { ServerResponse } from "node:http";
2
2
  import * as Effect from "effect/Effect";
3
+ import { fakeHttpPause, fakeHttpSend } from "#server/adapters/fakeHttpSend.ts";
3
4
  import type {
4
5
  FakeHttpFault,
5
6
  FakeHttpHoldOptions,
@@ -11,7 +12,6 @@ import type {
11
12
  import { fakeHttpGates } from "#server/internal/fakeHttpGates.ts";
12
13
  import { fakeHttpScripts } from "#server/internal/fakeHttpScripts.ts";
13
14
  import { fakeHttpSelection } from "#server/internal/fakeHttpSelection.ts";
14
- import { fakeHttpConnection, fakeHttpSend } from "#server/internal/fakeHttpSend.ts";
15
15
  import { describeValue } from "#server/internal/render.ts";
16
16
  import { explained } from "#server/internal/wrap.ts";
17
17
 
@@ -50,8 +50,8 @@ export function fakeHttpControls(tell: (line: string) => void, now: () => number
50
50
  cause,
51
51
  });
52
52
  },
53
- fault: (route: string, fault: FakeHttpFault, scope?: FakeHttpScope) =>
54
- Effect.promise(async () => {
53
+ fault: (route: string, fault: FakeHttpFault, scope?: FakeHttpScope): Effect.Effect<void> =>
54
+ Effect.gen(function* () {
55
55
  const selection = fakeHttpSelection(route, scope);
56
56
  const found = [...active].find(
57
57
  ([candidate, entry]) =>
@@ -60,28 +60,29 @@ export function fakeHttpControls(tell: (line: string) => void, now: () => number
60
60
  && candidate.headersSent === (fault.kind === "reset"),
61
61
  );
62
62
  if (!found) {
63
- throw new Error(
64
- `Fake HTTP route "${route}" has no request ready for a ${fault.kind} fault.\nhelp: Wait for a hold before a status or drop fault, or for response headers before a reset fault.`,
63
+ return yield* Effect.die(
64
+ new Error(
65
+ `Fake HTTP route "${route}" has no request ready for a ${fault.kind} fault.\nhelp: Wait for a hold before a status or drop fault, or for response headers before a reset fault.`,
66
+ ),
65
67
  );
66
68
  }
67
69
  const [response, { request }] = found;
68
70
  tell(`fake HTTP ${selection.label} fault ${fault.kind}`);
69
71
  if (fault.kind === "status") {
70
- await fakeHttpSend(response, typeof fault.reply === "function" ? fault.reply(request, now()) : fault.reply);
72
+ yield* Effect.promise(() => fakeHttpSend(response, typeof fault.reply === "function" ? fault.reply(request, now()) : fault.reply));
71
73
  } else {
72
74
  response.destroy();
73
75
  }
74
76
  }),
75
- hold: (route: string, options?: FakeHttpHoldOptions) => Effect.sync(() => holds.make(route, options, options?.once)),
76
- pause: async (route: string, request: FakeHttpRequest, response: ServerResponse) => {
77
- await fakeHttpConnection(response).pause(holds.get(route, request)?.enter());
78
- return !(response.destroyed || response.writableEnded || response.headersSent);
79
- },
80
- releaseOnArrival: (route: string, arrival: string, scope?: FakeHttpScope) =>
81
- Effect.sync(() => {
77
+ hold: (route: string, options?: FakeHttpHoldOptions) => holds.make(route, options, options?.once),
78
+ pause: (route: string, request: FakeHttpRequest, response: ServerResponse) => fakeHttpPause(response, () => holds.get(route, request)?.enter()),
79
+ releaseOnArrival: (route: string, arrival: string, scope?: FakeHttpScope): Effect.Effect<void> =>
80
+ Effect.gen(function* () {
82
81
  const hold = holds.at(route, scope);
83
82
  if (!hold) {
84
- throw new Error(`Fake HTTP route "${route}" has no hold.\nhelp: Hold the route before scripting its release on arrival.`);
83
+ return yield* Effect.die(
84
+ new Error(`Fake HTTP route "${route}" has no hold.\nhelp: Hold the route before scripting its release on arrival.`),
85
+ );
85
86
  }
86
87
  const releases = arrivals.get(arrival) ?? new Set<() => void>();
87
88
  releases.add(hold.release);
@@ -90,7 +91,7 @@ export function fakeHttpControls(tell: (line: string) => void, now: () => number
90
91
  }),
91
92
  reply: (source: FakeHttpReplySource, request: FakeHttpRequest) => (typeof source === "function" ? source(request, now()) : source),
92
93
  scriptFault: (route: string, fault: FakeHttpFault, options?: FakeHttpScriptOptions) => Effect.sync(() => scripts.make(route, fault, options)),
93
- stall: (route: string, scope?: FakeHttpScope) => Effect.sync(() => stalls.make(route, scope)),
94
+ stall: (route: string, scope?: FakeHttpScope) => stalls.make(route, scope),
94
95
  stallBody: (route: string, request: FakeHttpRequest) => {
95
96
  const stall = stalls.get(route, request);
96
97
  return stall ? () => stall.enter() : undefined;
@@ -13,11 +13,13 @@ export function fakeHttpGates(tell: (line: string) => void, kind: "hold" | "stal
13
13
  }
14
14
  },
15
15
  get: (route: string, request: FakeHttpRequest) => [...gates.values()].find((gate) => gate.matches(route, request)),
16
- make: (route: string, scope?: FakeHttpScope, once = false): FakeHttpHold => {
16
+ make: Effect.fnUntraced(function* (route: string, scope?: FakeHttpScope, once = false) {
17
17
  const selection = fakeHttpSelection(route, scope);
18
18
  const label = selection.label;
19
19
  if (gates.has(label)) {
20
- throw new Error(`Fake HTTP route "${route}" already has a ${kind}.\nhelp: Release its current ${kind} before scripting another.`);
20
+ return yield* Effect.die(
21
+ new Error(`Fake HTTP route "${route}" already has a ${kind}.\nhelp: Release its current ${kind} before scripting another.`),
22
+ );
21
23
  }
22
24
  const waiting = Deferred.makeUnsafe<void>();
23
25
  const released = Promise.withResolvers<void>();
@@ -41,7 +43,7 @@ export function fakeHttpGates(tell: (line: string) => void, kind: "hold" | "stal
41
43
  };
42
44
  gates.set(label, gate);
43
45
  tell(kind === "hold" ? `fake HTTP ${label} held` : `fake HTTP ${label} body will stall`);
44
- return { release: Effect.sync(gate.release), waiting: Deferred.await(waiting) };
45
- },
46
+ return { release: Effect.sync(gate.release), waiting: Deferred.await(waiting) } satisfies FakeHttpHold;
47
+ }),
46
48
  };
47
49
  }
@@ -1,8 +1,9 @@
1
1
  import * as Cause from "effect/Cause";
2
2
  import * as Effect from "effect/Effect";
3
+ import { callSite } from "#server/adapters/callSite.ts";
4
+ import { engineSummary } from "#server/adapters/engineSummary.ts";
5
+ import { creationReport, failureReport } from "#server/adapters/failureReport.ts";
3
6
  import { type FailureContext, reportOnFailure } from "#server/adapters/storyFailure.ts";
4
- import { callSite } from "#server/internal/callSite.ts";
5
- import { creationReport, failureReport } from "#server/internal/failureReport.ts";
6
7
  import { hooked } from "#server/internal/hooked.ts";
7
8
 
8
9
  export interface Refusal {
@@ -49,7 +50,7 @@ export const narrate = Effect.fnUntraced(function* <TEngine>(subject: Subject<TE
49
50
  },
50
51
  };
51
52
  function captureFailure(stack: string | undefined) {
52
- return hooked(() => (subject.inspect === undefined ? subject.engine : subject.inspect(subject.engine))).pipe(
53
+ const snapshotReport = hooked(() => (subject.inspect === undefined ? engineSummary(subject.engine) : subject.inspect(subject.engine))).pipe(
53
54
  Effect.matchCause({
54
55
  onFailure: (cause) => ({ threw: Cause.squash(cause) }),
55
56
  onSuccess: (value) => ({ value }),
@@ -63,8 +64,9 @@ export const narrate = Effect.fnUntraced(function* <TEngine>(subject: Subject<TE
63
64
  }),
64
65
  ),
65
66
  );
67
+ return Effect.suspend(() => (captured === undefined ? snapshotReport : Effect.succeed(captured)));
66
68
  }
67
- yield* reportOnFailure(context, (test) => (captured === undefined ? captureFailure(test.stack) : Effect.succeed(captured)));
69
+ yield* reportOnFailure(context, (test) => captureFailure(test.stack));
68
70
  return { captureFailure, narration };
69
71
  });
70
72
 
@@ -1,5 +1,5 @@
1
1
  import * as Schema from "effect/Schema";
2
- import { otlpProtobuf } from "#server/internal/otlpProtobuf.ts";
2
+ import { otlpProtobuf } from "#server/adapters/otlpProtobuf.ts";
3
3
  import { Attribute } from "#server/internal/otlpValue.ts";
4
4
 
5
5
  const Attributes = Schema.optionalKey(Schema.Array(Attribute));
@@ -5,20 +5,15 @@ import type * as Scope from "effect/Scope";
5
5
  import * as Tracer from "effect/Tracer";
6
6
  import type { AnyTestLayer, EffectClock } from "@shivaedev/test/types.ts";
7
7
  import { refusal } from "#server/internal/errors.ts";
8
- import { type AnyEffect, type EffectHook, type Hook, hooked } from "#server/internal/hooked.ts";
8
+ import { type AnyEffect, type EffectHook, hooked } from "#server/internal/hooked.ts";
9
9
  import { type Narration, tellGiven } from "#server/internal/narration.ts";
10
10
  import type { LooseRunHooks } from "#server/internal/runUntil.ts";
11
11
  import type { Parts } from "#server/internal/traits.ts";
12
- import type { RunUntilOptions } from "#server/storyKit.ts";
12
+ import type { Story } from "#server/storyKit.ts";
13
13
 
14
14
  export type LooseTrait = Parts<string, (engine: unknown) => Effect.Effect<void, unknown, unknown>>;
15
15
 
16
- export interface LooseStory {
17
- readonly engine: unknown;
18
- readonly lines: readonly string[];
19
- readonly runUntil: (until: Hook<[engine: unknown], AnyEffect, boolean>, options?: RunUntilOptions) => Effect.Effect<void, unknown, unknown>;
20
- readonly tell: (line: string) => void;
21
- }
16
+ export type LooseStory = Story<unknown, AnyEffect, string>;
22
17
 
23
18
  export interface LooseDefinition {
24
19
  readonly after?: Readonly<Partial<Record<string, EffectHook<[engine: unknown], AnyEffect, unknown>>>>;
@@ -36,16 +31,24 @@ export interface LooseDefinition {
36
31
  readonly verbs: (engine: unknown, story: LooseStory) => object;
37
32
  }
38
33
 
39
- export const seed = Effect.fnUntraced(function* (
34
+ export const seed = Effect.fnUntraced(function* <A>(
40
35
  definition: LooseDefinition,
41
36
  engine: unknown,
42
37
  narration: Narration,
43
38
  given: readonly LooseTrait[],
44
- body: Effect.Effect<unknown, unknown, unknown>,
39
+ body: Effect.Effect<A, unknown, unknown>,
45
40
  onFailure: (cause: Cause.Cause<unknown>) => Effect.Effect<unknown, never, unknown>,
41
+ initial = true,
46
42
  ) {
47
43
  const parts = given.flatMap((each) => each.parts);
48
- tellGiven(narration, parts);
44
+ const offset = narration.lines.length;
45
+ if (initial) {
46
+ tellGiven(narration, parts);
47
+ } else {
48
+ for (const part of parts) {
49
+ narration.tellAt(part.line, part.site);
50
+ }
51
+ }
49
52
  const stage = Effect.fnUntraced(function* (name: string) {
50
53
  for (const [index, part] of parts.entries()) {
51
54
  if (part.stage === name) {
@@ -55,7 +58,7 @@ export const seed = Effect.fnUntraced(function* (
55
58
  return Effect.interrupt;
56
59
  }
57
60
  const thrown = Cause.squash(cause);
58
- narration.refused = { cause: thrown, index };
61
+ narration.refused = { cause: thrown, index: offset + index };
59
62
  return Effect.die(refusal(definition.name, part.line, thrown));
60
63
  }),
61
64
  );
@@ -67,7 +70,7 @@ export const seed = Effect.fnUntraced(function* (
67
70
  }
68
71
  return undefined;
69
72
  });
70
- function remaining(index: number): Effect.Effect<unknown, unknown, unknown> {
73
+ function remaining(index: number): Effect.Effect<A, unknown, unknown> {
71
74
  const name = definition.stages[index];
72
75
  if (name === undefined) {
73
76
  return body.pipe(Effect.tapCause(onFailure));
@@ -2,44 +2,59 @@ import * as Cause from "effect/Cause";
2
2
  import * as Context from "effect/Context";
3
3
  import * as Effect from "effect/Effect";
4
4
  import * as Tracer from "effect/Tracer";
5
+ import { callSite } from "#server/adapters/callSite.ts";
5
6
  import type { FailureContext } from "#server/adapters/storyFailure.ts";
6
- import { callSite } from "#server/internal/callSite.ts";
7
7
  import { hooked } from "#server/internal/hooked.ts";
8
8
  import { narrate, narrateCreation } from "#server/internal/narration.ts";
9
9
  import { runUntil } from "#server/internal/runUntil.ts";
10
10
  import { type LooseDefinition, type LooseStory, type LooseTrait, seed } from "#server/internal/seed.ts";
11
11
 
12
- export const start = Effect.fnUntraced(function* (
12
+ type Capture = (stack: string | undefined) => Effect.Effect<string, never, unknown>;
13
+
14
+ export const start = Effect.fnUntraced(function* <A>(
13
15
  definition: LooseDefinition,
14
16
  given: readonly LooseTrait[],
15
17
  context: FailureContext,
16
- body: (told: object) => Effect.Effect<unknown, unknown, unknown>,
18
+ body: (told: { readonly story: LooseStory }) => Effect.Effect<A, unknown, unknown>,
19
+ captures: Capture[] = [],
17
20
  ) {
18
21
  const engine = yield* hooked(definition.create).pipe(
19
22
  Effect.updateContext(Context.omit(Tracer.ParentSpan)),
20
23
  Effect.tapCause(() => narrateCreation(definition.name, context)),
21
24
  );
22
25
  const { narration, captureFailure } = yield* narrate({ engine, inspect: definition.inspect, name: definition.name }, context);
23
- const bodyEffect = Effect.suspend(() => {
24
- const story: LooseStory = {
25
- engine,
26
- lines: narration.lines,
27
- runUntil: (until, options) => {
28
- const site = callSite();
29
- narration.at = site;
30
- return runUntil({ engine, name: definition.name, run: definition.run, tell: (line) => narration.tellAt(line, site) }, until, options);
31
- },
32
- tell: narration.tell,
33
- };
34
- return body(
35
- Object.defineProperties(
36
- {},
37
- {
38
- ...Object.getOwnPropertyDescriptors(definition.verbs(engine, story)),
39
- story: { enumerable: true, value: story },
26
+ const index = captures.push(captureFailure) - 1;
27
+ function onFailure(cause: Cause.Cause<unknown>) {
28
+ const stack = Cause.prettyErrors(cause)[0]?.stack;
29
+ return Effect.forEach(captures, (capture) => capture(stack), { discard: true });
30
+ }
31
+ const bodyEffect = Effect.context<unknown>().pipe(
32
+ Effect.flatMap((services) => {
33
+ captures[index] = (stack) => captureFailure(stack).pipe(Effect.provideContext(services));
34
+ const story: LooseStory = {
35
+ apply: (traits) => seed(definition, engine, narration, traits, Effect.void, onFailure, false).pipe(Effect.provideContext(services)),
36
+ engine,
37
+ lines: narration.lines,
38
+ restart: (traits) => start(definition, traits, context, Effect.succeed, captures).pipe(Effect.provideContext(services)),
39
+ runUntil: (until, options) => {
40
+ const site = callSite();
41
+ narration.at = site;
42
+ return runUntil({ engine, name: definition.name, run: definition.run, tell: (line) => narration.tellAt(line, site) }, until, options).pipe(
43
+ Effect.provideContext(services),
44
+ );
40
45
  },
41
- ),
42
- );
43
- });
44
- return yield* seed(definition, engine, narration, given, bodyEffect, (cause) => captureFailure(Cause.prettyErrors(cause)[0]?.stack));
46
+ tell: narration.tell,
47
+ };
48
+ return body(
49
+ Object.defineProperties(
50
+ { story },
51
+ {
52
+ ...Object.getOwnPropertyDescriptors(definition.verbs(engine, story)),
53
+ story: { configurable: false, enumerable: true, value: story, writable: false },
54
+ },
55
+ ),
56
+ );
57
+ }),
58
+ );
59
+ return yield* seed(definition, engine, narration, given, bodyEffect, onFailure);
45
60
  });