copilot-sdk/nodejs/test/client-api-codegen.test.ts at jmoseley-automated-message-source · github/copilot-sdk · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
import { describe, expect, it } from "vitest";

import { emitClientSessionApiRegistration as emitGoClientSessionApiRegistration } from "../../scripts/codegen/go.ts";
import { emitClientSessionApiRegistration as emitPythonClientSessionApiRegistration } from "../../scripts/codegen/python.ts";
import { emitClientSessionApiRegistration as emitTypeScriptClientSessionApiRegistration } from "../../scripts/codegen/typescript.ts";

const clientSessionSchema: Record<string, unknown> = {
    mixed: {
        visible: {
            rpcMethod: "mixed.visible",
            params: {
                type: "object",
                title: "VisibleRequest",
                properties: {
                    sessionId: { type: "string" },
                },
                required: ["sessionId"],
            },
            result: {
                type: "object",
                title: "VisibleResult",
                properties: {},
            },
        },
        secret: {
            rpcMethod: "mixed.secret",
            visibility: "internal",
            params: {
                $ref: "#/definitions/InternalRequest",
            },
            result: {
                $ref: "#/definitions/InternalResult",
            },
        },
    },
    internalOnly: {
        hidden: {
            rpcMethod: "internalOnly.hidden",
            visibility: "internal",
            params: {
                $ref: "#/definitions/InternalRequest",
            },
            result: {
                $ref: "#/definitions/InternalResult",
            },
        },
    },
};

const allInternalClientSessionSchema: Record<string, unknown> = {
    internalOnly: clientSessionSchema.internalOnly,
};

function expectOnlyPublicClientSessionHandlers(code: string): void {
    expect(code).toContain("mixed.visible");
    expect(code).not.toContain("mixed.secret");
    expect(code).not.toContain("internalOnly.hidden");
    expect(code).not.toContain("InternalRequest");
    expect(code).not.toContain("InternalResult");
}

describe("client-session API codegen", () => {
    it("excludes internal methods from TypeScript handlers", () => {
        const code = emitTypeScriptClientSessionApiRegistration(clientSessionSchema).join("\n");
        const allInternalCode = emitTypeScriptClientSessionApiRegistration(
            allInternalClientSessionSchema
        ).join("\n");

        expectOnlyPublicClientSessionHandlers(code);
        expect(code).not.toContain("InternalOnlyHandler");
        expect(allInternalCode).toContain("export interface ClientSessionApiHandlers {");
        expect(allInternalCode).toContain("export function registerClientSessionApiHandlers(");
        expect(allInternalCode).not.toContain("InternalOnlyHandler");
    });

    it("excludes internal methods from Go handlers", () => {
        const lines: string[] = [];
        emitGoClientSessionApiRegistration(lines, clientSessionSchema, (name) => name, new Map());
        const code = lines.join("\n");
        const allInternalLines: string[] = [];
        emitGoClientSessionApiRegistration(
            allInternalLines,
            allInternalClientSessionSchema,
            (name) => name,
            new Map()
        );
        const allInternalCode = allInternalLines.join("\n");

        expectOnlyPublicClientSessionHandlers(code);
        expect(code).not.toContain("InternalOnlyHandler");
        expect(allInternalCode).toContain("type ClientSessionAPIHandlers struct {");
        expect(allInternalCode).toContain("func RegisterClientSessionAPIHandlers(");
        expect(allInternalCode).not.toContain("InternalOnlyHandler");
        expect(allInternalCode).not.toContain("clientSessionHandlerError");
    });

    it("excludes internal methods from Python handlers", () => {
        const lines: string[] = [];
        emitPythonClientSessionApiRegistration(lines, clientSessionSchema, (name) => name);
        const code = lines.join("\n");
        const allInternalLines: string[] = [];
        emitPythonClientSessionApiRegistration(
            allInternalLines,
            allInternalClientSessionSchema,
            (name) => name
        );
        const allInternalCode = allInternalLines.join("\n");

        expectOnlyPublicClientSessionHandlers(code);
        expect(code).not.toContain("InternalOnlyHandler");
        expect(allInternalCode).toContain("class ClientSessionApiHandlers:");
        expect(allInternalCode).toContain("def register_client_session_api_handlers(");
        expect(allInternalCode).not.toContain("InternalOnlyHandler");
    });
});