@shivaedev/test-kits 0.2.1 → 0.3.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,24 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.3.0 - 2026-11-04
4
+
5
+ ### Added
6
+
7
+ - Provides a stateful Discord provider with message HTTP routes and a native gateway socket boundary for stories running the real clients.
8
+
9
+ ### Breaking
10
+
11
+ - TypeScript source exports now use `@shivaedev/source` instead of `source`. Replace `source` with `@shivaedev/source` in Node `--conditions`, TypeScript `customConditions`, and Vite/Vitest `resolve.conditions`. Bare `source` selects built JavaScript; no compatibility alias is provided.
12
+
13
+ ## 0.2.2 - 2026-11-04
14
+
15
+ ### Changed
16
+
17
+ - Update `@shivaedev/contract` from 0.34.0 to 0.35.0.
18
+ - Update `@shivaedev/identity` from 0.23.0 to 0.23.1.
19
+ - Update `@shivaedev/test-sql` from 0.18.2 to 0.19.0.
20
+ - Update `@shivaedev/test-story` from 0.37.0 to 0.37.1.
21
+
3
22
  ## 0.2.1 - 2026-11-04
4
23
 
5
24
  ### Changed
package/README.md CHANGED
@@ -27,6 +27,10 @@ Import `inbox`, `emailLink` and the `ReceivedEmail` type from `@shivaedev/test-k
27
27
 
28
28
  Import `signedInUser`, `signInAgain`, `passwordUser` and `storedProviderAccounts` from `@shivaedev/test-kits/identity/adapters/betterAuth.ts`. They use Better Auth's adapter without requiring its test plugin. `signedInUser(auth, fields)` returns the user, session, headers, cookies and token. Optional `providerAccounts` attach provider identities. `signInAgain(auth, userId)` renews the same user's session on the caller's Effect Clock. `passwordUser` accepts either `password` or `passwordHash`; use an existing hash when password hashing is only a precondition. `storedProviderAccounts` reports credential-presence booleans without returning credential values.
29
29
 
30
+ ### Discord bots
31
+
32
+ Import `fakeDiscord` from `@shivaedev/test-kits/discord/fake.ts` and acquire it in a scope. Its loopback `server` retains messages across creation, editing, history reads and deletion, and supports the standard fake HTTP fault controls. Use the token `story-discord-token` with the real Discord REST client and set its API URL to `server.url`. Provide `gateway.transport` as the real gateway client's `GatewayTransport`; it speaks identify, heartbeat and resume frames, retains sessions and replays dispatches emitted during a dropped connection. `gateway.dispatch(type, data)`, `drop(code?)` and `invalidate(resumable)` change the provider, while `frames` and `urls` expose outbound observations. Drive reconnect and rate-limit time through the story kit's controlled clock.
33
+
30
34
  ### MCP bearer tokens
31
35
 
32
36
  Import `mcpBearerToken` from `@shivaedev/test-kits/mcp/adapters/bearerToken.ts`. With the application's mounted Better Auth instance (JWT and MCP provider plugins enabled), an existing signed-in user and OAuth client, mint the token precondition:
@@ -0,0 +1,25 @@
1
+ import { Effect } from "effect";
2
+ import { Socket } from "effect/socket";
3
+ export declare const discordGateway: () => Effect.Effect<{
4
+ closed: () => number;
5
+ dispatch: (type: string, data: unknown) => Effect.Effect<void, never, never>;
6
+ drop: (code?: number) => Effect.Effect<void, never, never>;
7
+ frames: {
8
+ readonly d: unknown;
9
+ readonly op: number;
10
+ }[];
11
+ invalidate: (resumable: boolean) => Effect.Effect<void, never, never>;
12
+ malformedFrame: () => Effect.Effect<void, never, never>;
13
+ nextClosed: Effect.Effect<void, never, never>;
14
+ nextSent: Effect.Effect<{
15
+ readonly d: unknown;
16
+ readonly op: number;
17
+ }, never, never>;
18
+ requestReconnect: () => Effect.Effect<void, never, never>;
19
+ stopAcknowledging: () => Effect.Effect<void, never, never>;
20
+ transport: {
21
+ readonly open: (url: string) => Effect.Effect<Socket.Socket>;
22
+ };
23
+ urls: string[];
24
+ }, never, never>;
25
+ //# sourceMappingURL=gateway.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/discord/adapters/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAMvC,eAAO,MAAM,cAAc;;qBA+FR,MAAM,QAAQ,OAAO;;;;;;4BASd,OAAO;;;;;;;;;;;;;gBAiB/B,CAAC"}
@@ -0,0 +1,120 @@
1
+ import { Effect, Queue, Schema } from "effect";
2
+ import { Socket } from "effect/socket";
3
+ import { GatewayTransport } from "@shivaedev/discord/GatewayTransport.ts";
4
+ const Frame = Schema.Struct({ d: Schema.Unknown, op: Schema.Number });
5
+ const Resume = Schema.Struct({ seq: Schema.Number, sessionId: Schema.String }).pipe(Schema.encodeKeys({ sessionId: "session_id" }));
6
+ export const discordGateway = Effect.fnUntraced(function* () {
7
+ const sent = yield* Queue.unbounded();
8
+ const closures = yield* Queue.unbounded();
9
+ const frames = [];
10
+ const urls = [];
11
+ const events = [];
12
+ let active;
13
+ let sequence = 0;
14
+ let sessionId = "";
15
+ let sessions = 0;
16
+ let closed = 0;
17
+ let acknowledge = true;
18
+ const encode = Schema.encodeSync(Schema.fromJsonString(Schema.Unknown));
19
+ function emit(frame) {
20
+ if (active !== undefined) {
21
+ Queue.offerUnsafe(active, encode(frame));
22
+ }
23
+ }
24
+ function dispatch(type, data) {
25
+ sequence += 1;
26
+ const event = { d: data, op: 0, s: sequence, t: type };
27
+ events.push(event);
28
+ emit(event);
29
+ }
30
+ function identify() {
31
+ sessions += 1;
32
+ sessionId = `session-${sessions}`;
33
+ dispatch("READY", { "resume_gateway_url": "wss://resume.discord.test", "session_id": sessionId });
34
+ }
35
+ function resumeSession(data) {
36
+ const resume = Schema.decodeUnknownSync(Resume)(data);
37
+ if (resume.sessionId !== sessionId || resume.seq > sequence) {
38
+ emit({ d: false, op: 9 });
39
+ return;
40
+ }
41
+ for (const event of events.filter((candidate) => candidate.s > resume.seq)) {
42
+ emit(event);
43
+ }
44
+ dispatch("RESUMED", {});
45
+ }
46
+ function receive(raw) {
47
+ if (typeof raw !== "string") {
48
+ return;
49
+ }
50
+ const frame = Schema.decodeUnknownSync(Schema.fromJsonString(Frame))(raw);
51
+ frames.push(frame);
52
+ Queue.offerUnsafe(sent, frame);
53
+ switch (frame.op) {
54
+ case 2:
55
+ identify();
56
+ break;
57
+ case 6:
58
+ resumeSession(frame.d);
59
+ break;
60
+ case 1:
61
+ if (acknowledge) {
62
+ emit({ d: null, op: 11 });
63
+ }
64
+ break;
65
+ }
66
+ }
67
+ function reader(incoming, url) {
68
+ return Effect.acquireRelease(Effect.sync(() => {
69
+ urls.push(url);
70
+ active = incoming;
71
+ emit({ d: { "heartbeat_interval": 30_000 }, op: 10 });
72
+ return { pull: Queue.take(incoming).pipe(Effect.map((frame) => [frame])), upgrade: Socket.SocketUpgradeError.unsupported };
73
+ }), () => Effect.gen(function* () {
74
+ closed += 1;
75
+ yield* Queue.offer(closures, undefined);
76
+ if (active === incoming) {
77
+ active = undefined;
78
+ }
79
+ yield* Queue.fail(incoming, new Socket.SocketError({ reason: new Socket.SocketCloseError({ code: 1000 }) }));
80
+ }));
81
+ }
82
+ const transport = GatewayTransport.of({
83
+ open: (url) => Effect.gen(function* () {
84
+ const incoming = yield* Queue.unbounded();
85
+ function write(raw) {
86
+ return Effect.sync(() => receive(raw));
87
+ }
88
+ return Socket.make({
89
+ reader: reader(incoming, url),
90
+ writer: Effect.succeed({ write, writeAll: (chunks) => Effect.forEach(chunks, write, { discard: true }) }),
91
+ });
92
+ }),
93
+ });
94
+ return {
95
+ closed: () => closed,
96
+ dispatch: (type, data) => Effect.sync(() => dispatch(type, data)),
97
+ drop: (code = 1006) => Effect.gen(function* () {
98
+ if (active !== undefined) {
99
+ yield* Queue.fail(active, new Socket.SocketError({ reason: new Socket.SocketCloseError({ code }) }));
100
+ }
101
+ active = undefined;
102
+ }),
103
+ frames,
104
+ invalidate: (resumable) => Effect.sync(() => emit({ d: resumable, op: 9 })),
105
+ malformedFrame: () => Effect.sync(() => {
106
+ if (active !== undefined) {
107
+ Queue.offerUnsafe(active, "not json");
108
+ }
109
+ }),
110
+ nextClosed: Queue.take(closures),
111
+ nextSent: Queue.take(sent),
112
+ requestReconnect: () => Effect.sync(() => emit({ d: null, op: 7 })),
113
+ stopAcknowledging: () => Effect.sync(() => {
114
+ acknowledge = false;
115
+ }),
116
+ transport,
117
+ urls,
118
+ };
119
+ });
120
+ //# sourceMappingURL=gateway.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../../src/discord/adapters/gateway.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import { Effect } from "effect";
2
+ export declare const discordRest: () => Effect.Effect<{
3
+ server: {
4
+ completed: import("effect/Stream").Stream<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, never, never>;
5
+ fault: (route: string, fault: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpFault, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<void, never, never>;
6
+ hold: (route: string, holdOptions?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpHoldOptions) => Effect.Effect<{
7
+ release: Effect.Effect<void, never, never>;
8
+ waiting: Effect.Effect<void, never, never>;
9
+ }, never, never>;
10
+ narrate: (sink: (line: string) => void) => void;
11
+ received: import("effect/Stream").Stream<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, never, never>;
12
+ releaseOnArrival: (route: string, arrival: string, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<void, never, never>;
13
+ readonly requests: readonly import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord[];
14
+ scriptFault: (route: string, fault: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpFault, scriptOptions?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScriptOptions) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScript, never, never>;
15
+ stall: (route: string, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<{
16
+ release: Effect.Effect<void, never, never>;
17
+ waiting: Effect.Effect<void, never, never>;
18
+ }, never, never>;
19
+ untilAbandoned: (matches: (request: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord) => boolean, wait: import("@shivaedev/test-story/server/until.ts").UntilOptions) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, import("@shivaedev/test-story/server/until.ts").SignalNotReceived, never>;
20
+ url: string;
21
+ };
22
+ }, import("effect/Cause").UnknownError, import("effect/Scope").Scope>;
23
+ //# sourceMappingURL=rest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../src/discord/adapters/rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAKxC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;qEA6CtB,CAAC"}
@@ -0,0 +1,50 @@
1
+ import { Effect, Schema } from "effect";
2
+ import { fakeHttpService } from "@shivaedev/test-story/server/fakeHttpService.ts";
3
+ const MessageBody = Schema.fromJsonString(Schema.Struct({ content: Schema.String }));
4
+ export const discordRest = Effect.fnUntraced(function* () {
5
+ const messages = new Map();
6
+ let nextId = 1000;
7
+ const server = yield* fakeHttpService({
8
+ guard: (request) => request.headers.authorization === "Bot story-discord-token",
9
+ routes: {
10
+ create: {
11
+ method: "POST",
12
+ path: "/channels/:channel/messages",
13
+ reply: (request) => {
14
+ const body = Schema.decodeUnknownSync(MessageBody)(request.body.toString());
15
+ nextId += 1;
16
+ const message = { "channel_id": request.params.channel ?? "", content: body.content, id: String(nextId) };
17
+ messages.set(message.id, message);
18
+ return { body: message };
19
+ },
20
+ },
21
+ edit: {
22
+ method: "PATCH",
23
+ path: "/channels/:channel/messages/:message",
24
+ reply: (request) => {
25
+ const message = messages.get(request.params.message ?? "");
26
+ if (message === undefined || message.channel_id !== request.params.channel) {
27
+ return { status: 404 };
28
+ }
29
+ message.content = Schema.decodeUnknownSync(MessageBody)(request.body.toString()).content;
30
+ return { body: message };
31
+ },
32
+ },
33
+ list: {
34
+ method: "GET",
35
+ path: "/channels/:channel/messages",
36
+ reply: (request) => ({ body: [...messages.values()].filter((message) => message.channel_id === request.params.channel) }),
37
+ },
38
+ remove: {
39
+ method: "DELETE",
40
+ path: "/channels/:channel/messages/:message",
41
+ reply: (request) => {
42
+ messages.delete(request.params.message ?? "");
43
+ return { status: 204 };
44
+ },
45
+ },
46
+ },
47
+ });
48
+ return { server };
49
+ });
50
+ //# sourceMappingURL=rest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rest.js","sourceRoot":"","sources":["../../../src/discord/adapters/rest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import { Effect } from "effect";
2
+ export declare const fakeDiscord: () => Effect.Effect<{
3
+ server: {
4
+ completed: import("effect/Stream").Stream<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, never, never>;
5
+ fault: (route: string, fault: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpFault, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<void, never, never>;
6
+ hold: (route: string, holdOptions?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpHoldOptions) => Effect.Effect<{
7
+ release: Effect.Effect<void, never, never>;
8
+ waiting: Effect.Effect<void, never, never>;
9
+ }, never, never>;
10
+ narrate: (sink: (line: string) => void) => void;
11
+ received: import("effect/Stream").Stream<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, never, never>;
12
+ releaseOnArrival: (route: string, arrival: string, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<void, never, never>;
13
+ readonly requests: readonly import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord[];
14
+ scriptFault: (route: string, fault: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpFault, scriptOptions?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScriptOptions) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScript, never, never>;
15
+ stall: (route: string, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<{
16
+ release: Effect.Effect<void, never, never>;
17
+ waiting: Effect.Effect<void, never, never>;
18
+ }, never, never>;
19
+ untilAbandoned: (matches: (request: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord) => boolean, wait: import("@shivaedev/test-story/server/until.ts").UntilOptions) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, import("@shivaedev/test-story/server/until.ts").SignalNotReceived, never>;
20
+ url: string;
21
+ };
22
+ gateway: {
23
+ closed: () => number;
24
+ dispatch: (type: string, data: unknown) => Effect.Effect<void, never, never>;
25
+ drop: (code?: number) => Effect.Effect<void, never, never>;
26
+ frames: {
27
+ readonly d: unknown;
28
+ readonly op: number;
29
+ }[];
30
+ invalidate: (resumable: boolean) => Effect.Effect<void, never, never>;
31
+ malformedFrame: () => Effect.Effect<void, never, never>;
32
+ nextClosed: Effect.Effect<void, never, never>;
33
+ nextSent: Effect.Effect<{
34
+ readonly d: unknown;
35
+ readonly op: number;
36
+ }, never, never>;
37
+ requestReconnect: () => Effect.Effect<void, never, never>;
38
+ stopAcknowledging: () => Effect.Effect<void, never, never>;
39
+ transport: {
40
+ readonly open: (url: string) => Effect.Effect<import("effect/socket/Socket").Socket>;
41
+ };
42
+ urls: string[];
43
+ };
44
+ }, import("effect/Cause").UnknownError, import("effect/Scope").Scope>;
45
+ //# sourceMappingURL=fake.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/discord/fake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAEtB,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { Effect } from "effect";
2
+ import { discordGateway } from "#discord/adapters/gateway.ts";
3
+ import { discordRest } from "#discord/adapters/rest.ts";
4
+ export const fakeDiscord = Effect.fnUntraced(function* () {
5
+ return { gateway: yield* discordGateway(), ...(yield* discordRest()) };
6
+ });
7
+ //# sourceMappingURL=fake.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fake.js","sourceRoot":"","sources":["../../src/discord/fake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;IACrD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shivaedev/test-kits",
3
- "version": "0.2.1",
3
+ "version": "0.3.0",
4
4
  "description": "Reusable story building blocks for Platform applications",
5
5
  "keywords": [
6
6
  "effect"
@@ -20,14 +20,14 @@
20
20
  "imports": {
21
21
  "#test/*": "./src/test-support/*",
22
22
  "#*.ts": {
23
- "source": "./src/*.ts",
23
+ "@shivaedev/source": "./src/*.ts",
24
24
  "types": "./dist/*.d.ts",
25
25
  "default": "./dist/*.js"
26
26
  }
27
27
  },
28
28
  "exports": {
29
29
  "./*.ts": {
30
- "source": "./src/*.ts",
30
+ "@shivaedev/source": "./src/*.ts",
31
31
  "types": "./dist/*.d.ts",
32
32
  "default": "./dist/*.js"
33
33
  },
@@ -43,11 +43,11 @@
43
43
  "README.md"
44
44
  ],
45
45
  "dependencies": {
46
- "@shivaedev/test-sql": "0.18.2",
47
- "@shivaedev/test-story": "0.37.0"
46
+ "@shivaedev/test-sql": "0.20.0",
47
+ "@shivaedev/test-story": "0.38.0"
48
48
  },
49
49
  "devDependencies": {
50
- "@shivaedev/quality": "0.58.0",
50
+ "@shivaedev/quality": "0.60.0",
51
51
  "@types/node": "24.19.2",
52
52
  "better-auth": "1.7.14",
53
53
  "effect": "4.0.6",
@@ -55,11 +55,12 @@
55
55
  "vitest": "5.0.5"
56
56
  },
57
57
  "peerDependencies": {
58
- "@shivaedev/changes": "0.9.0",
59
- "@shivaedev/contract": "0.34.0",
60
- "@shivaedev/email": "0.3.2",
61
- "@shivaedev/identity": "0.23.0",
62
- "@shivaedev/sql": "0.36.1",
58
+ "@shivaedev/changes": "0.10.0",
59
+ "@shivaedev/contract": "0.36.0",
60
+ "@shivaedev/discord": "0.2.0",
61
+ "@shivaedev/email": "0.4.0",
62
+ "@shivaedev/identity": "0.24.0",
63
+ "@shivaedev/sql": "0.37.0",
63
64
  "better-auth": "1.7.14",
64
65
  "effect": "4.0.6"
65
66
  },
@@ -0,0 +1,129 @@
1
+ import { Effect, Queue, Schema } from "effect";
2
+ import { Socket } from "effect/socket";
3
+ import { GatewayTransport } from "@shivaedev/discord/GatewayTransport.ts";
4
+
5
+ const Frame = Schema.Struct({ d: Schema.Unknown, op: Schema.Number });
6
+ const Resume = Schema.Struct({ seq: Schema.Number, sessionId: Schema.String }).pipe(Schema.encodeKeys({ sessionId: "session_id" }));
7
+
8
+ export const discordGateway = Effect.fnUntraced(function* () {
9
+ const sent = yield* Queue.unbounded<typeof Frame.Type>();
10
+ const closures = yield* Queue.unbounded<void>();
11
+ const frames: (typeof Frame.Type)[] = [];
12
+ const urls: string[] = [];
13
+ const events: { d: unknown; op: number; s: number; t: string }[] = [];
14
+ let active: Queue.Queue<string, Socket.SocketError> | undefined;
15
+ let sequence = 0;
16
+ let sessionId = "";
17
+ let sessions = 0;
18
+ let closed = 0;
19
+ let acknowledge = true;
20
+ const encode = Schema.encodeSync(Schema.fromJsonString(Schema.Unknown));
21
+ function emit(frame: unknown) {
22
+ if (active !== undefined) {
23
+ Queue.offerUnsafe(active, encode(frame));
24
+ }
25
+ }
26
+ function dispatch(type: string, data: unknown) {
27
+ sequence += 1;
28
+ const event = { d: data, op: 0, s: sequence, t: type };
29
+ events.push(event);
30
+ emit(event);
31
+ }
32
+ function identify() {
33
+ sessions += 1;
34
+ sessionId = `session-${sessions}`;
35
+ dispatch("READY", { "resume_gateway_url": "wss://resume.discord.test", "session_id": sessionId });
36
+ }
37
+ function resumeSession(data: unknown) {
38
+ const resume = Schema.decodeUnknownSync(Resume)(data);
39
+ if (resume.sessionId !== sessionId || resume.seq > sequence) {
40
+ emit({ d: false, op: 9 });
41
+ return;
42
+ }
43
+ for (const event of events.filter((candidate) => candidate.s > resume.seq)) {
44
+ emit(event);
45
+ }
46
+ dispatch("RESUMED", {});
47
+ }
48
+ function receive(raw: Uint8Array | string | Socket.CloseEvent) {
49
+ if (typeof raw !== "string") {
50
+ return;
51
+ }
52
+ const frame = Schema.decodeUnknownSync(Schema.fromJsonString(Frame))(raw);
53
+ frames.push(frame);
54
+ Queue.offerUnsafe(sent, frame);
55
+ switch (frame.op) {
56
+ case 2:
57
+ identify();
58
+ break;
59
+ case 6:
60
+ resumeSession(frame.d);
61
+ break;
62
+ case 1:
63
+ if (acknowledge) {
64
+ emit({ d: null, op: 11 });
65
+ }
66
+ break;
67
+ }
68
+ }
69
+ function reader(incoming: Queue.Queue<string, Socket.SocketError>, url: string) {
70
+ return Effect.acquireRelease(
71
+ Effect.sync(() => {
72
+ urls.push(url);
73
+ active = incoming;
74
+ emit({ d: { "heartbeat_interval": 30_000 }, op: 10 });
75
+ return { pull: Queue.take(incoming).pipe(Effect.map((frame) => [frame] as const)), upgrade: Socket.SocketUpgradeError.unsupported };
76
+ }),
77
+ () =>
78
+ Effect.gen(function* () {
79
+ closed += 1;
80
+ yield* Queue.offer(closures, undefined);
81
+ if (active === incoming) {
82
+ active = undefined;
83
+ }
84
+ yield* Queue.fail(incoming, new Socket.SocketError({ reason: new Socket.SocketCloseError({ code: 1000 }) }));
85
+ }),
86
+ );
87
+ }
88
+ const transport = GatewayTransport.of({
89
+ open: (url) =>
90
+ Effect.gen(function* () {
91
+ const incoming = yield* Queue.unbounded<string, Socket.SocketError>();
92
+ function write(raw: Uint8Array | string | Socket.CloseEvent) {
93
+ return Effect.sync(() => receive(raw));
94
+ }
95
+ return Socket.make({
96
+ reader: reader(incoming, url),
97
+ writer: Effect.succeed({ write, writeAll: (chunks) => Effect.forEach(chunks, write, { discard: true }) }),
98
+ });
99
+ }),
100
+ });
101
+ return {
102
+ closed: () => closed,
103
+ dispatch: (type: string, data: unknown) => Effect.sync(() => dispatch(type, data)),
104
+ drop: (code = 1006) =>
105
+ Effect.gen(function* () {
106
+ if (active !== undefined) {
107
+ yield* Queue.fail(active, new Socket.SocketError({ reason: new Socket.SocketCloseError({ code }) }));
108
+ }
109
+ active = undefined;
110
+ }),
111
+ frames,
112
+ invalidate: (resumable: boolean) => Effect.sync(() => emit({ d: resumable, op: 9 })),
113
+ malformedFrame: () =>
114
+ Effect.sync(() => {
115
+ if (active !== undefined) {
116
+ Queue.offerUnsafe(active, "not json");
117
+ }
118
+ }),
119
+ nextClosed: Queue.take(closures),
120
+ nextSent: Queue.take(sent),
121
+ requestReconnect: () => Effect.sync(() => emit({ d: null, op: 7 })),
122
+ stopAcknowledging: () =>
123
+ Effect.sync(() => {
124
+ acknowledge = false;
125
+ }),
126
+ transport,
127
+ urls,
128
+ };
129
+ });
@@ -0,0 +1,51 @@
1
+ import { Effect, Schema } from "effect";
2
+ import { fakeHttpService } from "@shivaedev/test-story/server/fakeHttpService.ts";
3
+
4
+ const MessageBody = Schema.fromJsonString(Schema.Struct({ content: Schema.String }));
5
+
6
+ export const discordRest = Effect.fnUntraced(function* () {
7
+ const messages = new Map<string, { "channel_id": string; content: string; id: string }>();
8
+ let nextId = 1000;
9
+ const server = yield* fakeHttpService({
10
+ guard: (request) => request.headers.authorization === "Bot story-discord-token",
11
+ routes: {
12
+ create: {
13
+ method: "POST",
14
+ path: "/channels/:channel/messages",
15
+ reply: (request) => {
16
+ const body = Schema.decodeUnknownSync(MessageBody)(request.body.toString());
17
+ nextId += 1;
18
+ const message = { "channel_id": request.params.channel ?? "", content: body.content, id: String(nextId) };
19
+ messages.set(message.id, message);
20
+ return { body: message };
21
+ },
22
+ },
23
+ edit: {
24
+ method: "PATCH",
25
+ path: "/channels/:channel/messages/:message",
26
+ reply: (request) => {
27
+ const message = messages.get(request.params.message ?? "");
28
+ if (message === undefined || message.channel_id !== request.params.channel) {
29
+ return { status: 404 };
30
+ }
31
+ message.content = Schema.decodeUnknownSync(MessageBody)(request.body.toString()).content;
32
+ return { body: message };
33
+ },
34
+ },
35
+ list: {
36
+ method: "GET",
37
+ path: "/channels/:channel/messages",
38
+ reply: (request) => ({ body: [...messages.values()].filter((message) => message.channel_id === request.params.channel) }),
39
+ },
40
+ remove: {
41
+ method: "DELETE",
42
+ path: "/channels/:channel/messages/:message",
43
+ reply: (request) => {
44
+ messages.delete(request.params.message ?? "");
45
+ return { status: 204 };
46
+ },
47
+ },
48
+ },
49
+ });
50
+ return { server };
51
+ });
@@ -0,0 +1,7 @@
1
+ import { Effect } from "effect";
2
+ import { discordGateway } from "#discord/adapters/gateway.ts";
3
+ import { discordRest } from "#discord/adapters/rest.ts";
4
+
5
+ export const fakeDiscord = Effect.fnUntraced(function* () {
6
+ return { gateway: yield* discordGateway(), ...(yield* discordRest()) };
7
+ });