@relayfile/adapter-core 0.1.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 (140) hide show
  1. package/README.md +89 -0
  2. package/dist/src/cli.d.ts +3 -0
  3. package/dist/src/cli.d.ts.map +1 -0
  4. package/dist/src/cli.js +430 -0
  5. package/dist/src/cli.js.map +1 -0
  6. package/dist/src/docs/change-detector.d.ts +23 -0
  7. package/dist/src/docs/change-detector.d.ts.map +1 -0
  8. package/dist/src/docs/change-detector.js +126 -0
  9. package/dist/src/docs/change-detector.js.map +1 -0
  10. package/dist/src/docs/crawler.d.ts +22 -0
  11. package/dist/src/docs/crawler.d.ts.map +1 -0
  12. package/dist/src/docs/crawler.js +296 -0
  13. package/dist/src/docs/crawler.js.map +1 -0
  14. package/dist/src/docs/extractor.d.ts +12 -0
  15. package/dist/src/docs/extractor.d.ts.map +1 -0
  16. package/dist/src/docs/extractor.js +549 -0
  17. package/dist/src/docs/extractor.js.map +1 -0
  18. package/dist/src/docs/generator.d.ts +14 -0
  19. package/dist/src/docs/generator.d.ts.map +1 -0
  20. package/dist/src/docs/generator.js +368 -0
  21. package/dist/src/docs/generator.js.map +1 -0
  22. package/dist/src/docs/mapping-generator.d.ts +13 -0
  23. package/dist/src/docs/mapping-generator.d.ts.map +1 -0
  24. package/dist/src/docs/mapping-generator.js +104 -0
  25. package/dist/src/docs/mapping-generator.js.map +1 -0
  26. package/dist/src/docs/types.d.ts +110 -0
  27. package/dist/src/docs/types.d.ts.map +1 -0
  28. package/dist/src/docs/types.js +2 -0
  29. package/dist/src/docs/types.js.map +1 -0
  30. package/dist/src/docs/updater.d.ts +11 -0
  31. package/dist/src/docs/updater.d.ts.map +1 -0
  32. package/dist/src/docs/updater.js +133 -0
  33. package/dist/src/docs/updater.js.map +1 -0
  34. package/dist/src/drift/drift-checker.d.ts +13 -0
  35. package/dist/src/drift/drift-checker.d.ts.map +1 -0
  36. package/dist/src/drift/drift-checker.js +200 -0
  37. package/dist/src/drift/drift-checker.js.map +1 -0
  38. package/dist/src/generate/adapter-generator.d.ts +4 -0
  39. package/dist/src/generate/adapter-generator.d.ts.map +1 -0
  40. package/dist/src/generate/adapter-generator.js +115 -0
  41. package/dist/src/generate/adapter-generator.js.map +1 -0
  42. package/dist/src/generate/types-generator.d.ts +3 -0
  43. package/dist/src/generate/types-generator.d.ts.map +1 -0
  44. package/dist/src/generate/types-generator.js +105 -0
  45. package/dist/src/generate/types-generator.js.map +1 -0
  46. package/dist/src/index.d.ts +22 -0
  47. package/dist/src/index.d.ts.map +1 -0
  48. package/dist/src/index.js +21 -0
  49. package/dist/src/index.js.map +1 -0
  50. package/dist/src/ingest/index.d.ts +4 -0
  51. package/dist/src/ingest/index.d.ts.map +1 -0
  52. package/dist/src/ingest/index.js +34 -0
  53. package/dist/src/ingest/index.js.map +1 -0
  54. package/dist/src/ingest/openapi.d.ts +8 -0
  55. package/dist/src/ingest/openapi.d.ts.map +1 -0
  56. package/dist/src/ingest/openapi.js +187 -0
  57. package/dist/src/ingest/openapi.js.map +1 -0
  58. package/dist/src/ingest/postman.d.ts +3 -0
  59. package/dist/src/ingest/postman.d.ts.map +1 -0
  60. package/dist/src/ingest/postman.js +14 -0
  61. package/dist/src/ingest/postman.js.map +1 -0
  62. package/dist/src/ingest/sample.d.ts +4 -0
  63. package/dist/src/ingest/sample.d.ts.map +1 -0
  64. package/dist/src/ingest/sample.js +72 -0
  65. package/dist/src/ingest/sample.js.map +1 -0
  66. package/dist/src/ingest/shared.d.ts +6 -0
  67. package/dist/src/ingest/shared.d.ts.map +1 -0
  68. package/dist/src/ingest/shared.js +52 -0
  69. package/dist/src/ingest/shared.js.map +1 -0
  70. package/dist/src/ingest/types.d.ts +44 -0
  71. package/dist/src/ingest/types.d.ts.map +1 -0
  72. package/dist/src/ingest/types.js +2 -0
  73. package/dist/src/ingest/types.js.map +1 -0
  74. package/dist/src/runtime/schema-adapter.d.ts +71 -0
  75. package/dist/src/runtime/schema-adapter.d.ts.map +1 -0
  76. package/dist/src/runtime/schema-adapter.js +887 -0
  77. package/dist/src/runtime/schema-adapter.js.map +1 -0
  78. package/dist/src/spec/parser.d.ts +9 -0
  79. package/dist/src/spec/parser.d.ts.map +1 -0
  80. package/dist/src/spec/parser.js +371 -0
  81. package/dist/src/spec/parser.js.map +1 -0
  82. package/dist/src/spec/template.d.ts +8 -0
  83. package/dist/src/spec/template.d.ts.map +1 -0
  84. package/dist/src/spec/template.js +75 -0
  85. package/dist/src/spec/template.js.map +1 -0
  86. package/dist/src/spec/types.d.ts +88 -0
  87. package/dist/src/spec/types.d.ts.map +1 -0
  88. package/dist/src/spec/types.js +2 -0
  89. package/dist/src/spec/types.js.map +1 -0
  90. package/dist/tests/docs/change-detector.test.d.ts +2 -0
  91. package/dist/tests/docs/change-detector.test.d.ts.map +1 -0
  92. package/dist/tests/docs/change-detector.test.js +24 -0
  93. package/dist/tests/docs/change-detector.test.js.map +1 -0
  94. package/dist/tests/docs/crawler.test.d.ts +2 -0
  95. package/dist/tests/docs/crawler.test.d.ts.map +1 -0
  96. package/dist/tests/docs/crawler.test.js +55 -0
  97. package/dist/tests/docs/crawler.test.js.map +1 -0
  98. package/dist/tests/docs/extractor.test.d.ts +2 -0
  99. package/dist/tests/docs/extractor.test.d.ts.map +1 -0
  100. package/dist/tests/docs/extractor.test.js +63 -0
  101. package/dist/tests/docs/extractor.test.js.map +1 -0
  102. package/dist/tests/docs/generator.test.d.ts +2 -0
  103. package/dist/tests/docs/generator.test.d.ts.map +1 -0
  104. package/dist/tests/docs/generator.test.js +46 -0
  105. package/dist/tests/docs/generator.test.js.map +1 -0
  106. package/dist/tests/drift/drift-checker.test.d.ts +2 -0
  107. package/dist/tests/drift/drift-checker.test.d.ts.map +1 -0
  108. package/dist/tests/drift/drift-checker.test.js +59 -0
  109. package/dist/tests/drift/drift-checker.test.js.map +1 -0
  110. package/dist/tests/round-trip/fake-connection.d.ts +29 -0
  111. package/dist/tests/round-trip/fake-connection.d.ts.map +1 -0
  112. package/dist/tests/round-trip/fake-connection.js +174 -0
  113. package/dist/tests/round-trip/fake-connection.js.map +1 -0
  114. package/dist/tests/round-trip/github-pulls.test.d.ts +2 -0
  115. package/dist/tests/round-trip/github-pulls.test.d.ts.map +1 -0
  116. package/dist/tests/round-trip/github-pulls.test.js +12 -0
  117. package/dist/tests/round-trip/github-pulls.test.js.map +1 -0
  118. package/dist/tests/round-trip/harness.d.ts +74 -0
  119. package/dist/tests/round-trip/harness.d.ts.map +1 -0
  120. package/dist/tests/round-trip/harness.js +323 -0
  121. package/dist/tests/round-trip/harness.js.map +1 -0
  122. package/dist/tests/round-trip/vfs-snapshot.d.ts +45 -0
  123. package/dist/tests/round-trip/vfs-snapshot.d.ts.map +1 -0
  124. package/dist/tests/round-trip/vfs-snapshot.js +218 -0
  125. package/dist/tests/round-trip/vfs-snapshot.js.map +1 -0
  126. package/dist/tests/runtime/schema-adapter.sync.test.d.ts +2 -0
  127. package/dist/tests/runtime/schema-adapter.sync.test.d.ts.map +1 -0
  128. package/dist/tests/runtime/schema-adapter.sync.test.js +962 -0
  129. package/dist/tests/runtime/schema-adapter.sync.test.js.map +1 -0
  130. package/dist/tests/runtime/schema-adapter.test.d.ts +2 -0
  131. package/dist/tests/runtime/schema-adapter.test.d.ts.map +1 -0
  132. package/dist/tests/runtime/schema-adapter.test.js +100 -0
  133. package/dist/tests/runtime/schema-adapter.test.js.map +1 -0
  134. package/dist/tests/spec/parser.test.d.ts +2 -0
  135. package/dist/tests/spec/parser.test.d.ts.map +1 -0
  136. package/dist/tests/spec/parser.test.js +248 -0
  137. package/dist/tests/spec/parser.test.js.map +1 -0
  138. package/mappings/github.mapping.yaml +35 -0
  139. package/mappings/slack.mapping.yaml +18 -0
  140. package/package.json +52 -0
@@ -0,0 +1,88 @@
1
+ import type { DocsLlmConfig, DocsSourceConfig, DocsSyncConfig } from "../docs/types.js";
2
+ export interface AdapterSource {
3
+ openapi?: string;
4
+ postman?: string;
5
+ samples?: string | string[];
6
+ docs?: DocsSourceConfig;
7
+ sync?: DocsSyncConfig;
8
+ llm?: DocsLlmConfig;
9
+ }
10
+ export interface AdapterMetadata {
11
+ name: string;
12
+ version: string;
13
+ baseUrl?: string;
14
+ source: AdapterSource;
15
+ }
16
+ export interface DataProjection {
17
+ extract?: string[];
18
+ }
19
+ export interface WebhookMapping extends DataProjection {
20
+ path: string;
21
+ objectType?: string;
22
+ objectId?: string;
23
+ }
24
+ export interface ResourceMapping extends DataProjection {
25
+ endpoint: string;
26
+ path: string;
27
+ iterate?: boolean;
28
+ pagination?: PaginationConfig;
29
+ sync?: ResourceSyncConfig;
30
+ }
31
+ export type PaginationStrategy = "cursor" | "offset" | "page" | "link-header" | "next-token";
32
+ interface PaginationBase {
33
+ strategy: PaginationStrategy;
34
+ }
35
+ export interface CursorPagination extends PaginationBase {
36
+ strategy: "cursor";
37
+ cursorPath: string;
38
+ paramName?: string;
39
+ }
40
+ export interface OffsetPagination extends PaginationBase {
41
+ strategy: "offset";
42
+ paramName?: string;
43
+ limitParamName?: string;
44
+ pageSize?: number;
45
+ }
46
+ export interface PagePagination extends PaginationBase {
47
+ strategy: "page";
48
+ paramName?: string;
49
+ limitParamName?: string;
50
+ pageSize?: number;
51
+ }
52
+ export interface LinkHeaderPagination extends PaginationBase {
53
+ strategy: "link-header";
54
+ }
55
+ export interface NextTokenPagination extends PaginationBase {
56
+ strategy: "next-token";
57
+ tokenPath: string;
58
+ paramName?: string;
59
+ }
60
+ export type PaginationConfig = CursorPagination | OffsetPagination | PagePagination | LinkHeaderPagination | NextTokenPagination;
61
+ export interface ResourceSyncConfig {
62
+ modelName: string;
63
+ cursorField?: string;
64
+ checkpointKey?: string;
65
+ }
66
+ export interface WritebackMapping {
67
+ match: string;
68
+ endpoint: string;
69
+ baseUrl?: string;
70
+ }
71
+ export interface MappingSpec {
72
+ adapter: AdapterMetadata;
73
+ webhooks: Record<string, WebhookMapping>;
74
+ resources?: Record<string, ResourceMapping>;
75
+ writebacks?: Record<string, WritebackMapping>;
76
+ }
77
+ export type ValidationLevel = "error" | "warning";
78
+ export interface ValidationIssue {
79
+ level: ValidationLevel;
80
+ path: string;
81
+ message: string;
82
+ }
83
+ export interface ValidationResult {
84
+ valid: boolean;
85
+ issues: ValidationIssue[];
86
+ }
87
+ export {};
88
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/spec/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/spec/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=change-detector.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"change-detector.test.d.ts","sourceRoot":"","sources":["../../../tests/docs/change-detector.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,24 @@
1
+ import assert from "node:assert/strict";
2
+ import { mkdtemp } from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import test from "node:test";
6
+ import { ChangeDetector, defaultSyncConfig, } from "../../src/docs/change-detector.js";
7
+ test("ChangeDetector stores and reuses content hashes", async () => {
8
+ const stateDir = await mkdtemp(join(tmpdir(), "adapter-core-docs-"));
9
+ const stateFile = join(stateDir, "state.json");
10
+ const detector = new ChangeDetector({
11
+ stateFile,
12
+ fetchImpl: async () => new Response("same-doc-content", { status: 200 }),
13
+ });
14
+ const config = defaultSyncConfig("https://docs.example.com/api", {
15
+ trigger: "content-hash",
16
+ stateFile,
17
+ });
18
+ const first = await detector.check(config);
19
+ assert.equal(first.changed, true);
20
+ await detector.record(config, first);
21
+ const second = await detector.check(config);
22
+ assert.equal(second.changed, false);
23
+ });
24
+ //# sourceMappingURL=change-detector.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"change-detector.test.js","sourceRoot":"","sources":["../../../tests/docs/change-detector.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAE3C,IAAI,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;IACjE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QAClC,SAAS;QACT,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;KACzE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,8BAA8B,EAAE;QAC/D,OAAO,EAAE,cAAc;QACvB,SAAS;KACV,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAErC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=crawler.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"crawler.test.d.ts","sourceRoot":"","sources":["../../../tests/docs/crawler.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,55 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import { DocsCrawler } from "../../src/docs/crawler.js";
4
+ test("DocsCrawler extracts main content and follows next links", async () => {
5
+ const responses = new Map([
6
+ ["https://docs.example.com/robots.txt", "User-agent: *\nAllow: /\n"],
7
+ [
8
+ "https://docs.example.com/api",
9
+ `
10
+ <html>
11
+ <head><title>Intro</title></head>
12
+ <body>
13
+ <nav>ignore me</nav>
14
+ <main>
15
+ <h1>Widgets API</h1>
16
+ <p>List widgets.</p>
17
+ <a href="#overview">Overview</a>
18
+ <a href="/api/page-2" rel="next">Next</a>
19
+ </main>
20
+ </body>
21
+ </html>
22
+ `,
23
+ ],
24
+ [
25
+ "https://docs.example.com/api/page-2",
26
+ `
27
+ <html>
28
+ <body>
29
+ <main>
30
+ <h2>Create Widget</h2>
31
+ <pre><code>POST /widgets</code></pre>
32
+ <a href="/api/page-2#request">Request</a>
33
+ </main>
34
+ </body>
35
+ </html>
36
+ `,
37
+ ],
38
+ ]);
39
+ const crawler = new DocsCrawler({
40
+ url: "https://docs.example.com/api",
41
+ crawlPaths: ["/api"],
42
+ rateLimitMs: 0,
43
+ fetchImpl: async (input) => {
44
+ const body = responses.get(String(input));
45
+ assert.ok(body !== undefined, `Unexpected fetch: ${String(input)}`);
46
+ return new Response(body, { status: 200 });
47
+ },
48
+ });
49
+ const pages = await crawler.crawl();
50
+ assert.equal(pages.length, 2);
51
+ assert.match(pages[0]?.content ?? "", /Widgets API/);
52
+ assert.doesNotMatch(pages[0]?.content ?? "", /ignore me/);
53
+ assert.match(pages[1]?.content ?? "", /POST \/widgets/);
54
+ });
55
+ //# sourceMappingURL=crawler.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"crawler.test.js","sourceRoot":"","sources":["../../../tests/docs/crawler.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,IAAI,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAiB;QACxC,CAAC,qCAAqC,EAAE,2BAA2B,CAAC;QACpE;YACE,8BAA8B;YAC9B;;;;;;;;;;;;;OAaC;SACF;QACD;YACE,qCAAqC;YACrC;;;;;;;;;;OAUC;SACF;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;QAC9B,GAAG,EAAE,8BAA8B;QACnC,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=extractor.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extractor.test.d.ts","sourceRoot":"","sources":["../../../tests/docs/extractor.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,63 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import { APIExtractor } from "../../src/docs/extractor.js";
4
+ test("APIExtractor parses structured JSON responses from the LLM", async () => {
5
+ const extractor = new APIExtractor({
6
+ provider: "custom",
7
+ endpoint: "https://llm.example.test/extract",
8
+ concurrency: 1,
9
+ fetchImpl: async (input, init) => {
10
+ assert.equal(String(input), "https://llm.example.test/extract");
11
+ assert.equal(init?.method, "POST");
12
+ return new Response(JSON.stringify({
13
+ output: {
14
+ text: JSON.stringify({
15
+ title: "Widgets API",
16
+ endpoints: [
17
+ {
18
+ method: "GET",
19
+ path: "/widgets/{id}",
20
+ parameters: [
21
+ {
22
+ name: "id",
23
+ in: "path",
24
+ type: "string",
25
+ required: true,
26
+ },
27
+ ],
28
+ responseShape: {
29
+ id: "string",
30
+ name: "string",
31
+ },
32
+ },
33
+ ],
34
+ webhooks: [
35
+ {
36
+ event: "widget.created",
37
+ payloadShape: {
38
+ id: "string",
39
+ type: "widget.created",
40
+ },
41
+ },
42
+ ],
43
+ auth: {
44
+ type: "bearer",
45
+ },
46
+ }),
47
+ },
48
+ }), { status: 200 });
49
+ },
50
+ });
51
+ const extracted = await extractor.extract([
52
+ {
53
+ url: "https://docs.example.com/api",
54
+ title: "Widgets",
55
+ content: "GET /widgets/{id}",
56
+ },
57
+ ]);
58
+ assert.equal(extracted.endpoints.length, 1);
59
+ assert.equal(extracted.endpoints[0]?.method, "GET");
60
+ assert.equal(extracted.webhooks[0]?.event, "widget.created");
61
+ assert.equal(extracted.auth?.type, "bearer");
62
+ });
63
+ //# sourceMappingURL=extractor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extractor.test.js","sourceRoot":"","sources":["../../../tests/docs/extractor.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,IAAI,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;IAC5E,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;QACjC,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,kCAAkC;QAC5C,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,kCAAkC,CAAC,CAAC;YAChE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACnC,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,SAAS,CAAC;gBACb,MAAM,EAAE;oBACN,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,aAAa;wBACpB,SAAS,EAAE;4BACT;gCACE,MAAM,EAAE,KAAK;gCACb,IAAI,EAAE,eAAe;gCACrB,UAAU,EAAE;oCACV;wCACE,IAAI,EAAE,IAAI;wCACV,EAAE,EAAE,MAAM;wCACV,IAAI,EAAE,QAAQ;wCACd,QAAQ,EAAE,IAAI;qCACf;iCACF;gCACD,aAAa,EAAE;oCACb,EAAE,EAAE,QAAQ;oCACZ,IAAI,EAAE,QAAQ;iCACf;6BACF;yBACF;wBACD,QAAQ,EAAE;4BACR;gCACE,KAAK,EAAE,gBAAgB;gCACvB,YAAY,EAAE;oCACZ,EAAE,EAAE,QAAQ;oCACZ,IAAI,EAAE,gBAAgB;iCACvB;6BACF;yBACF;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;yBACf;qBACF,CAAC;iBACH;aACF,CAAC,EACF,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC;QACxC;YACE,GAAG,EAAE,8BAA8B;YACnC,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,mBAAmB;SAC7B;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC7D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=generator.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generator.test.d.ts","sourceRoot":"","sources":["../../../tests/docs/generator.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,46 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import YAML from "yaml";
4
+ import { SpecGenerator } from "../../src/docs/generator.js";
5
+ test("SpecGenerator emits OpenAPI with security and x-webhooks", () => {
6
+ const generator = new SpecGenerator();
7
+ const yaml = generator.generate({
8
+ endpoints: [
9
+ {
10
+ method: "GET",
11
+ path: "/widgets/{id}",
12
+ parameters: [
13
+ { name: "id", in: "path", required: true, type: "string" },
14
+ ],
15
+ responseShape: {
16
+ id: "string",
17
+ name: "string",
18
+ },
19
+ },
20
+ ],
21
+ webhooks: [
22
+ {
23
+ event: "widget.created",
24
+ payloadShape: { id: "string" },
25
+ },
26
+ ],
27
+ auth: {
28
+ type: "api-key",
29
+ location: "header",
30
+ headerName: "X-API-Key",
31
+ },
32
+ }, {
33
+ apiName: "widgets",
34
+ docsSource: {
35
+ url: "https://docs.example.com/api",
36
+ },
37
+ });
38
+ const document = YAML.parse(yaml);
39
+ assert.equal(document.openapi, "3.0.3");
40
+ assert.ok(document.paths["/widgets/{id}"]);
41
+ assert.ok((document.components.securitySchemes ?? {})
42
+ .DefaultAuth);
43
+ assert.ok(document["x-webhooks"]["widget.created"]);
44
+ assert.ok(document["x-docs-source"]);
45
+ });
46
+ //# sourceMappingURL=generator.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generator.test.js","sourceRoot":"","sources":["../../../tests/docs/generator.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAC7B;QACE,SAAS,EAAE;YACT;gBACE,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,eAAe;gBACrB,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3D;gBACD,aAAa,EAAE;oBACb,EAAE,EAAE,QAAQ;oBACZ,IAAI,EAAE,QAAQ;iBACf;aACF;SACF;QACD,QAAQ,EAAE;YACR;gBACE,KAAK,EAAE,gBAAgB;gBACvB,YAAY,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;aAC/B;SACF;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,WAAW;SACxB;KACF,EACD;QACE,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE;YACV,GAAG,EAAE,8BAA8B;SACpC;KACF,CACF,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;IAC7D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,CAAE,QAAQ,CAAC,KAAiC,CAAC,eAAe,CAAC,CAAC,CAAC;IACxE,MAAM,CAAC,EAAE,CACP,CAAE,QAAQ,CAAC,UAAsD,CAAC,eAAe,IAAI,EAAE,CAAC;SACrF,WAAW,CACf,CAAC;IACF,MAAM,CAAC,EAAE,CAAE,QAAQ,CAAC,YAAY,CAA6B,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACjF,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=drift-checker.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drift-checker.test.d.ts","sourceRoot":"","sources":["../../../tests/drift/drift-checker.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,59 @@
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { detectDrift } from "../../src/drift/drift-checker.js";
4
+ test("detectDrift reports breaking field removals and optional additions", () => {
5
+ const baseline = {
6
+ title: "API",
7
+ version: "1",
8
+ sourceKind: "openapi",
9
+ sourceLocation: "baseline",
10
+ endpoints: [
11
+ {
12
+ key: "GET /tickets/{id}",
13
+ operationId: "getTicket",
14
+ method: "GET",
15
+ path: "/tickets/{id}",
16
+ parameters: [
17
+ {
18
+ name: "id",
19
+ in: "path",
20
+ required: true,
21
+ schema: { type: "string" },
22
+ },
23
+ ],
24
+ responseSchema: { ref: "#/components/schemas/Ticket" },
25
+ },
26
+ ],
27
+ schemas: {
28
+ Ticket: {
29
+ type: "object",
30
+ required: ["id", "title"],
31
+ properties: {
32
+ id: { type: "string" },
33
+ title: { type: "string" },
34
+ },
35
+ },
36
+ },
37
+ webhookSchemas: {},
38
+ };
39
+ const current = {
40
+ ...baseline,
41
+ sourceLocation: "current",
42
+ schemas: {
43
+ Ticket: {
44
+ type: "object",
45
+ required: ["id", "status"],
46
+ properties: {
47
+ id: { type: "string" },
48
+ status: { type: "string" },
49
+ assignee: { type: "string" },
50
+ },
51
+ },
52
+ },
53
+ };
54
+ const report = detectDrift(baseline, current);
55
+ assert.equal(report.breaking.some((item) => item.type === "field_removed"), true);
56
+ assert.equal(report.breaking.some((item) => item.type === "required_field_added"), true);
57
+ assert.equal(report.additions.some((item) => item.type === "field_added"), true);
58
+ });
59
+ //# sourceMappingURL=drift-checker.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drift-checker.test.js","sourceRoot":"","sources":["../../../tests/drift/drift-checker.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAG/D,IAAI,CAAC,oEAAoE,EAAE,GAAG,EAAE;IAC9E,MAAM,QAAQ,GAAgB;QAC5B,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,GAAG;QACZ,UAAU,EAAE,SAAS;QACrB,cAAc,EAAE,UAAU;QAC1B,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,mBAAmB;gBACxB,WAAW,EAAE,WAAW;gBACxB,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,eAAe;gBACrB,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,IAAI;wBACV,EAAE,EAAE,MAAM;wBACV,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qBAC3B;iBACF;gBACD,cAAc,EAAE,EAAE,GAAG,EAAE,6BAA6B,EAAE;aACvD;SACF;QACD,OAAO,EAAE;YACP,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;gBACzB,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;aACF;SACF;QACD,cAAc,EAAE,EAAE;KACnB,CAAC;IAEF,MAAM,OAAO,GAAgB;QAC3B,GAAG,QAAQ;QACX,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE;YACP,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAC1B,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACtB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC7B;aACF;SACF;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,EAAE,IAAI,CAAC,CAAC;IAClF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,sBAAsB,CAAC,EAAE,IAAI,CAAC,CAAC;IACzF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;AACnF,CAAC,CAAC,CAAC"}
@@ -0,0 +1,29 @@
1
+ import type { ConnectionProvider, ProxyHeaders, ProxyMethod, ProxyQuery, ProxyResponse } from "@relayfile/sdk";
2
+ export interface HttpReplayRequest {
3
+ method: ProxyMethod;
4
+ baseUrl: string;
5
+ endpoint: string;
6
+ connectionId: string;
7
+ headers?: ProxyHeaders;
8
+ body?: unknown;
9
+ query?: ProxyQuery;
10
+ }
11
+ export interface HttpReplayInteraction<TData = unknown> {
12
+ request: HttpReplayRequest;
13
+ response: ProxyResponse<TData>;
14
+ }
15
+ export type HttpReplayFixture = readonly HttpReplayInteraction[] | {
16
+ interactions?: readonly HttpReplayInteraction[];
17
+ requests?: readonly HttpReplayInteraction[];
18
+ http?: readonly HttpReplayInteraction[];
19
+ };
20
+ export interface FakeConnectionProvider extends ConnectionProvider {
21
+ readonly calls: HttpReplayRequest[];
22
+ readonly remaining: number;
23
+ assertExhausted(): void;
24
+ }
25
+ export interface FakeConnectionOptions {
26
+ name?: string;
27
+ }
28
+ export declare function createFakeConnection(fixture: HttpReplayFixture, options?: FakeConnectionOptions): FakeConnectionProvider;
29
+ //# sourceMappingURL=fake-connection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fake-connection.d.ts","sourceRoot":"","sources":["../../../tests/round-trip/fake-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,UAAU,EAEV,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,KAAK,GAAG,OAAO;IACpD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GACzB,SAAS,qBAAqB,EAAE,GAChC;IACE,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAChD,QAAQ,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC5C,IAAI,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACzC,CAAC;AAEN,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,eAAe,IAAI,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,qBAA0B,GAClC,sBAAsB,CA4DxB"}
@@ -0,0 +1,174 @@
1
+ export function createFakeConnection(fixture, options = {}) {
2
+ const interactions = normalizeFixture(fixture);
3
+ const calls = [];
4
+ let nextInteractionIndex = 0;
5
+ return {
6
+ name: options.name ?? "fake-connection",
7
+ calls,
8
+ get remaining() {
9
+ return interactions.length - nextInteractionIndex;
10
+ },
11
+ async proxy(request) {
12
+ const actual = sanitizeRequest(request);
13
+ const interaction = interactions[nextInteractionIndex];
14
+ calls.push(actual);
15
+ if (!interaction) {
16
+ throw new Error([
17
+ `Unexpected HTTP replay call #${calls.length}.`,
18
+ `Received: ${stableStringify(actual)}`,
19
+ ].join("\n"));
20
+ }
21
+ const expected = sanitizeRequest(interaction.request);
22
+ if (!requestsMatch(expected, actual)) {
23
+ throw new Error([
24
+ `HTTP replay call #${calls.length} did not match the fixture.`,
25
+ `Expected: ${stableStringify(expected)}`,
26
+ `Received: ${stableStringify(actual)}`,
27
+ ].join("\n"));
28
+ }
29
+ nextInteractionIndex += 1;
30
+ return cloneResponse(interaction.response);
31
+ },
32
+ async healthCheck() {
33
+ return true;
34
+ },
35
+ assertExhausted() {
36
+ if (nextInteractionIndex === interactions.length) {
37
+ return;
38
+ }
39
+ const unused = interactions
40
+ .slice(nextInteractionIndex)
41
+ .map((interaction) => sanitizeRequest(interaction.request));
42
+ throw new Error([
43
+ `HTTP replay fixture has ${unused.length} unused interaction(s).`,
44
+ `Unused: ${stableStringify(unused)}`,
45
+ ].join("\n"));
46
+ },
47
+ };
48
+ }
49
+ function normalizeFixture(fixture) {
50
+ const interactions = Array.isArray(fixture)
51
+ ? fixture
52
+ : fixture.interactions ?? fixture.requests ?? fixture.http;
53
+ if (!interactions) {
54
+ throw new Error("HTTP replay fixture must be an array or an object with interactions, requests, or http.");
55
+ }
56
+ return interactions.map((interaction, index) => normalizeInteraction(interaction, index));
57
+ }
58
+ function normalizeInteraction(interaction, index) {
59
+ if (!isRecord(interaction)) {
60
+ throw new Error(`HTTP replay interaction #${index + 1} must be an object.`);
61
+ }
62
+ if (!isRecord(interaction.request)) {
63
+ throw new Error(`HTTP replay interaction #${index + 1} must include request.`);
64
+ }
65
+ if (!isRecord(interaction.response)) {
66
+ throw new Error(`HTTP replay interaction #${index + 1} must include response.`);
67
+ }
68
+ if (typeof interaction.response.status !== "number") {
69
+ throw new Error(`HTTP replay interaction #${index + 1} response.status must be a number.`);
70
+ }
71
+ return {
72
+ request: sanitizeRequest(interaction.request),
73
+ response: {
74
+ status: interaction.response.status,
75
+ headers: normalizeHeaders(interaction.response.headers) ?? {},
76
+ data: cloneValue(interaction.response.data),
77
+ },
78
+ };
79
+ }
80
+ function sanitizeRequest(request) {
81
+ const { endpoint, query } = splitEndpoint(request.endpoint);
82
+ return stripUndefined({
83
+ method: request.method,
84
+ baseUrl: request.baseUrl,
85
+ endpoint,
86
+ connectionId: request.connectionId,
87
+ headers: normalizeHeaders(request.headers),
88
+ body: cloneValue(request.body),
89
+ query: normalizeQuery({ ...query, ...(request.query ?? {}) }),
90
+ });
91
+ }
92
+ function splitEndpoint(endpoint) {
93
+ const [path, rawQuery] = endpoint.split("?", 2);
94
+ if (!rawQuery) {
95
+ return { endpoint, query: {} };
96
+ }
97
+ const query = {};
98
+ const params = new URLSearchParams(rawQuery);
99
+ params.forEach((value, key) => {
100
+ query[key] = value;
101
+ });
102
+ return { endpoint: path, query };
103
+ }
104
+ function normalizeHeaders(headers) {
105
+ if (!isRecord(headers)) {
106
+ return undefined;
107
+ }
108
+ const normalized = {};
109
+ for (const [key, value] of Object.entries(headers)) {
110
+ if (typeof value === "string") {
111
+ normalized[key.toLowerCase()] = value;
112
+ }
113
+ }
114
+ return Object.keys(normalized).length > 0 ? normalized : undefined;
115
+ }
116
+ function normalizeQuery(query) {
117
+ if (!isRecord(query)) {
118
+ return undefined;
119
+ }
120
+ const normalized = {};
121
+ for (const [key, value] of Object.entries(query)) {
122
+ const scalar = stringifyScalar(value);
123
+ if (scalar !== undefined) {
124
+ normalized[key] = scalar;
125
+ }
126
+ }
127
+ return Object.keys(normalized).length > 0 ? normalized : undefined;
128
+ }
129
+ function requestsMatch(expected, actual) {
130
+ return stableStringify(expected) === stableStringify(actual);
131
+ }
132
+ function cloneResponse(response) {
133
+ return {
134
+ status: response.status,
135
+ headers: { ...response.headers },
136
+ data: cloneValue(response.data),
137
+ };
138
+ }
139
+ function cloneValue(value) {
140
+ if (value === undefined || value === null || typeof value !== "object") {
141
+ return value;
142
+ }
143
+ return JSON.parse(JSON.stringify(value));
144
+ }
145
+ function stringifyScalar(value) {
146
+ if (typeof value === "string") {
147
+ return value;
148
+ }
149
+ if (typeof value === "number" ||
150
+ typeof value === "boolean" ||
151
+ typeof value === "bigint") {
152
+ return String(value);
153
+ }
154
+ return undefined;
155
+ }
156
+ function stripUndefined(value) {
157
+ return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
158
+ }
159
+ function stableStringify(value) {
160
+ if (Array.isArray(value)) {
161
+ return `[${value.map((item) => stableStringify(item)).join(",")}]`;
162
+ }
163
+ if (isRecord(value)) {
164
+ return `{${Object.keys(value)
165
+ .sort()
166
+ .map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`)
167
+ .join(",")}}`;
168
+ }
169
+ return JSON.stringify(value) ?? "undefined";
170
+ }
171
+ function isRecord(value) {
172
+ return typeof value === "object" && value !== null && !Array.isArray(value);
173
+ }
174
+ //# sourceMappingURL=fake-connection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fake-connection.js","sourceRoot":"","sources":["../../../tests/round-trip/fake-connection.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=github-pulls.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github-pulls.test.d.ts","sourceRoot":"","sources":["../../../tests/round-trip/github-pulls.test.ts"],"names":[],"mappings":""}