Function emitClientSessionApiRegistration

scripts/codegen/typescript.ts:848–935

* Generate handler interfaces and a registration function for client session API groups. * * Client session API methods have `sessionId` on the wire (injected by the * runtime's proxy layer). The generated registration function accepts a * `getHandler` callback that resolves a sessionId to a han

(clientSchema: Record<string, unknown>)

 * Param types include sessionId — handler code can simply ignore it.
 */
function emitClientSessionApiRegistration(clientSchema: Record<string, unknown>): string[] {
    const lines: string[] = [];
    const groups = collectClientGroups(clientSchema);

    // Emit a handler interface per group
    for (const [groupName, methods] of groups) {
        const interfaceName = toPascalCase(groupName) + "Handler";
        const groupDeprecated = isNodeFullyDeprecated(clientSchema[groupName] as Record<string, unknown>);
        const groupExperimental = isNodeFullyExperimental(clientSchema[groupName] as Record<string, unknown>);
        if (groupDeprecated) {
            lines.push(`/** @deprecated Handler for \`${groupName}\` client session API methods. */`);
        } else if (groupExperimental) {
            lines.push(`/** Handler for \`${groupName}\` client session API methods. */`);
            lines.push(TS_EXPERIMENTAL_JSDOC);
        } else {
            lines.push(`/** Handler for \`${groupName}\` client session API methods. */`);
        }
        lines.push(`export interface ${interfaceName} {`);
        for (const method of methods) {
            const name = handlerMethodName(method.rpcMethod);
            const hasParams = hasSchemaPayload(getMethodParamsSchema(method));
            const pType = hasParams ? paramsTypeName(method) : "";
            const rType = tsResultType(method);

            pushTsRpcMethodJsDoc(lines, "    ", method, {
                summaryFallback: `Handles \`${method.rpcMethod}\`.`,
                paramsName: hasParams ? "params" : undefined,
                paramsDescription: rpcParamsDescription(method, getMethodParamsSchema(method)),
                includeDeprecated: method.deprecated && !groupDeprecated,
                includeExperimental: method.stability === "experimental" && !groupExperimental,
            });
            if (hasParams) {
                lines.push(`    ${name}(params: ${pType}): Promise<${rType}>;`);
            } else {
                lines.push(`    ${name}(): Promise<${rType}>;`);
            }
        }
        lines.push(`}`);
        lines.push("");
    }

    // Emit combined ClientSessionApiHandlers type
    lines.push(`/** All client session API handler groups. */`);
    lines.push(`export interface ClientSessionApiHandlers {`);
    for (const [groupName] of groups) {
        const interfaceName = toPascalCase(groupName) + "Handler";
        lines.push(`    ${groupName}?: ${interfaceName};`);
    }
    lines.push(`}`);
    lines.push("");

    // Emit registration function
    lines.push(`/**`);
    lines.push(` * Register client session API handlers on a JSON-RPC connection.`);
    lines.push(` * The server calls these methods to delegate work to the client.`);
    lines.push(` * Each incoming call includes a \`sessionId\` in the params; the registration`);
    lines.push(` * function uses \`getHandlers\` to resolve the session's handlers.`);
    lines.push(` */`);