@corpdk/pub-sub 2026.10.0-alpha.1 → 2026.10.0-alpha.14

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/README.md ADDED
@@ -0,0 +1,25 @@
1
+ # @corpdk/pub-sub
2
+
3
+ Plugin-style GraphQL pub/sub factory for GraphQL Yoga: in-memory or Redis (`createAppPubSub<T>()`).
4
+
5
+ Used by DAL-automated data services for subscription topics. Redis wiring uses `@graphql-yoga/redis-event-target` and `ioredis`.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ pnpm add @corpdk/pub-sub
11
+ # or
12
+ npm install @corpdk/pub-sub
13
+ ```
14
+
15
+ Use the same CalVer as the rest of the DS automation npm set.
16
+
17
+ ## Documentation
18
+
19
+ - [DS subscription SSE (Yoga)](https://github.com/CorpDK/coding-templates/blob/main/docs/developer/11-ds-subscription-sse.md)
20
+ - [Monorepo design — pub/sub](https://github.com/CorpDK/coding-templates/blob/main/docs/architecture/02-monorepo-design.md)
21
+ - Package source: [`libraries/pub-sub`](https://github.com/CorpDK/coding-templates/tree/main/libraries/pub-sub)
22
+
23
+ ## License
24
+
25
+ MIT — see the [repository LICENSE](https://github.com/CorpDK/coding-templates/blob/main/LICENSE).
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,89 @@
1
+ import { createSchema } from "graphql-yoga";
2
+ import { afterEach, describe, expect, it, vi } from "vitest";
3
+ import { createSseYogaHttpServer, listenSseYogaHttpServer } from "../index.js";
4
+ const schema = createSchema({
5
+ typeDefs: /* GraphQL */ `
6
+ type Query {
7
+ ping: String!
8
+ }
9
+ `,
10
+ resolvers: {
11
+ Query: {
12
+ ping: () => "pong",
13
+ },
14
+ },
15
+ });
16
+ function listen(server) {
17
+ return new Promise((resolve, reject) => {
18
+ server.listen(0, () => {
19
+ const address = server.address();
20
+ if (address && typeof address === "object") {
21
+ resolve(address.port);
22
+ return;
23
+ }
24
+ reject(new Error("server did not bind to a port"));
25
+ });
26
+ });
27
+ }
28
+ function close(server) {
29
+ return new Promise((resolve, reject) => {
30
+ server.close((error) => (error ? reject(error) : resolve()));
31
+ });
32
+ }
33
+ describe("createSseYogaHttpServer", () => {
34
+ afterEach(() => {
35
+ vi.restoreAllMocks();
36
+ });
37
+ it("serves GraphQL queries over HTTP on /graphql", async () => {
38
+ const server = createSseYogaHttpServer(schema);
39
+ const port = await listen(server);
40
+ try {
41
+ const response = await fetch(`http://127.0.0.1:${port}/graphql`, {
42
+ method: "POST",
43
+ headers: { "content-type": "application/json" },
44
+ body: JSON.stringify({ query: "{ ping }" }),
45
+ });
46
+ expect(response.ok).toBe(true);
47
+ const body = (await response.json());
48
+ expect(body.data?.ping).toBe("pong");
49
+ }
50
+ finally {
51
+ await close(server);
52
+ }
53
+ });
54
+ });
55
+ describe("listenSseYogaHttpServer", () => {
56
+ afterEach(() => {
57
+ vi.restoreAllMocks();
58
+ });
59
+ it("listens on an ephemeral port, logs extra startup lines, and serves GraphQL", async () => {
60
+ const server = createSseYogaHttpServer(schema);
61
+ const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
62
+ const extraStartupLines = ["extra-line-a", "extra-line-b"];
63
+ await new Promise((resolve, reject) => {
64
+ server.once("listening", () => resolve());
65
+ server.once("error", reject);
66
+ listenSseYogaHttpServer(server, 0, "@corpdk/test-ds", extraStartupLines);
67
+ });
68
+ try {
69
+ const address = server.address();
70
+ const boundPort = address && typeof address === "object" ? address.port : 0;
71
+ expect(boundPort).not.toBe(0);
72
+ const response = await fetch(`http://127.0.0.1:${boundPort}/graphql`, {
73
+ method: "POST",
74
+ headers: { "content-type": "application/json" },
75
+ body: JSON.stringify({ query: "{ ping }" }),
76
+ });
77
+ expect(response.ok).toBe(true);
78
+ const body = (await response.json());
79
+ expect(body.data?.ping).toBe("pong");
80
+ for (const line of extraStartupLines) {
81
+ expect(log.mock.calls.some((call) => call[0] === line)).toBe(true);
82
+ }
83
+ }
84
+ finally {
85
+ await close(server);
86
+ }
87
+ });
88
+ });
89
+ //# sourceMappingURL=sse-yoga-server.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sse-yoga-server.test.js","sourceRoot":"","sources":["../../src/__tests__/sse-yoga-server.test.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -14,3 +14,4 @@
14
14
  export declare function createAppPubSub<T extends Record<string, [unknown]>>(): import("graphql-yoga").PubSub<T>;
15
15
  export { createMemoryEventTarget } from "./memory.js";
16
16
  export { createRedisEventTarget } from "./redis.js";
17
+ export { createSseYogaHttpServer, createSseYogaServer, listenSseYogaHttpServer, } from "./sse-yoga-server.js";
package/dist/index.js CHANGED
@@ -22,4 +22,5 @@ export function createAppPubSub() {
22
22
  }
23
23
  export { createMemoryEventTarget } from "./memory.js";
24
24
  export { createRedisEventTarget } from "./redis.js";
25
+ export { createSseYogaHttpServer, createSseYogaServer, listenSseYogaHttpServer, } from "./sse-yoga-server.js";
25
26
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS;QACvC,CAAC,CAAC,sBAAsB,EAAE;QAC1B,CAAC,CAAC,uBAAuB,EAAE,CAAC;IAC9B,OAAO,YAAY,CAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS;QACvC,CAAC,CAAC,sBAAsB,EAAE;QAC1B,CAAC,CAAC,uBAAuB,EAAE,CAAC;IAC9B,OAAO,YAAY,CAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { type Server } from "node:http";
2
+ import { createYoga } from "graphql-yoga";
3
+ type SseYogaSchema = NonNullable<Parameters<typeof createYoga>[0]["schema"]>;
4
+ export declare function createSseYogaServer(schema: SseYogaSchema): import("graphql-yoga").YogaServerInstance<Record<string, any>, {}>;
5
+ export declare function createSseYogaHttpServer(schema: SseYogaSchema): Server;
6
+ export declare function listenSseYogaHttpServer(server: Server, port: number, packageLabel: string, extraStartupLines?: readonly string[]): void;
7
+ export {};
@@ -0,0 +1,25 @@
1
+ import { createServer } from "node:http";
2
+ import { createYoga } from "graphql-yoga";
3
+ export function createSseYogaServer(schema) {
4
+ return createYoga({
5
+ schema,
6
+ graphiql: process.env.NODE_ENV !== "production",
7
+ logging: true,
8
+ });
9
+ }
10
+ export function createSseYogaHttpServer(schema) {
11
+ return createServer(createSseYogaServer(schema));
12
+ }
13
+ export function listenSseYogaHttpServer(server, port, packageLabel, extraStartupLines = []) {
14
+ server.listen(port, () => {
15
+ const addr = server.address();
16
+ const boundPort = addr && typeof addr === "object" ? addr.port : port;
17
+ const base = `http://localhost:${boundPort}/graphql`;
18
+ console.log(`${packageLabel} HTTP ${base}`);
19
+ for (const line of extraStartupLines) {
20
+ console.log(line);
21
+ }
22
+ console.log(`${packageLabel} SSE ${base} (subscriptions: Accept: text/event-stream)`);
23
+ });
24
+ }
25
+ //# sourceMappingURL=sse-yoga-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sse-yoga-server.js","sourceRoot":"","sources":["../src/sse-yoga-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO,UAAU,CAAC;QAChB,MAAM;QACN,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAC/C,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAqB;IAC3D,OAAO,YAAY,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,IAAY,EACZ,YAAoB,EACpB,oBAAuC,EAAE;IAEzC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,MAAM,IAAI,GAAG,oBAAoB,SAAS,UAAU,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,WAAW,IAAI,EAAE,CAAC,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,GAAG,CACT,GAAG,YAAY,WAAW,IAAI,8CAA8C,CAC7E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
package/package.json CHANGED
@@ -1,14 +1,22 @@
1
1
  {
2
2
  "name": "@corpdk/pub-sub",
3
- "version": "2026.10.0-alpha.1",
3
+ "version": "2026.10.0-alpha.14",
4
+ "description": "Plugin-style GraphQL pub/sub factory (in-memory or Redis)",
4
5
  "type": "module",
5
6
  "publishConfig": {
6
7
  "registry": "https://registry.npmjs.org/",
7
8
  "access": "public"
8
9
  },
10
+ "repository": {
11
+ "type": "git",
12
+ "url": "https://github.com/CorpDK/coding-templates.git",
13
+ "directory": "libraries/pub-sub"
14
+ },
9
15
  "files": [
10
- "dist"
16
+ "dist",
17
+ "README.md"
11
18
  ],
19
+ "types": "./dist/index.d.ts",
12
20
  "exports": {
13
21
  ".": {
14
22
  "types": "./dist/index.d.ts",
@@ -21,13 +29,20 @@
21
29
  "ioredis": "^5.10.1"
22
30
  },
23
31
  "devDependencies": {
24
- "@types/node": "^20.19.37",
25
- "typescript": "^6.0.2"
32
+ "@types/node": "^24.0.0",
33
+ "@vitest/coverage-v8": "4.1.2",
34
+ "typescript": "^6.0.2",
35
+ "vitest": "^4.1.2"
26
36
  },
27
37
  "license": "MIT",
38
+ "engines": {
39
+ "node": ">=24.0.0"
40
+ },
28
41
  "scripts": {
29
42
  "build": "tsc",
30
- "lint": "eslint src/",
43
+ "lint": "tsc --noEmit --types node",
44
+ "test": "vitest run",
45
+ "test:coverage": "vitest run --coverage",
31
46
  "clean": "rm -rf dist node_modules .turbo *.tsbuildinfo"
32
47
  }
33
48
  }