Function generateSessionEvents

scripts/codegen/typescript.ts:340–387

(schemaPath?: string)

// ── Session Events ──────────────────────────────────────────────────────────

async function generateSessionEvents(schemaPath?: string): Promise<void> {
    console.log("TypeScript: generating session-events...");

    const resolvedPath = schemaPath ?? (await getSessionEventsSchemaPath());
    const schema = (await loadSchemaJson(resolvedPath)) as JSONSchema7;
    const processed = propagateInternalVisibility(postProcessSchema(schema));
    const definitionCollections = collectDefinitionCollections(processed as Record<string, unknown>);
    const sessionEvent =
        resolveSchema({ $ref: "#/definitions/SessionEvent" }, definitionCollections) ??
        resolveSchema({ $ref: "#/$defs/SessionEvent" }, definitionCollections) ??
        processed;
    const schemaForCompile = withSharedDefinitions(sessionEvent, definitionCollections);
    appendPropertyMarkerTagsToDescriptions(schemaForCompile);

    const ts = await compile(normalizeSchemaForTypeScript(schemaForCompile), "SessionEvent", {
        bannerComment: `/**
 * AUTO-GENERATED FILE - DO NOT EDIT
 * Generated from: session-events.schema.json
 */`,
        style: { semi: true, singleQuote: false, trailingComma: "all" },
        additionalProperties: false,
        strictIndexSignatures: true,
    });

    let annotatedTs = annotateTypeScriptTypes(ts, experimentalDefinitionNames(definitionCollections), TS_EXPERIMENTAL_JSDOC);
    // Add @internal JSDoc annotations for session-event types marked
    // `visibility: "internal"` in the schema. The tag drives `stripInternal`
    // so the whole type is dropped from the published .d.ts.
    const sessionInternalTypes = new Set<string>();
    for (const [name, def] of Object.entries(definitionCollections.definitions ?? {})) {
        if (def && typeof def === "object" && (def as Record<string, unknown>).visibility === "internal") {
            sessionInternalTypes.add(name);
        }
    }
    for (const [name, def] of Object.entries(definitionCollections.$defs ?? {})) {
        if (def && typeof def === "object" && (def as Record<string, unknown>).visibility === "internal") {
            sessionInternalTypes.add(name);
        }
    }
    for (const intType of sessionInternalTypes) {
        annotatedTs = annotatedTs.replace(
            new RegExp(`(^|\\n)(export (?:interface|type) ${intType}\\b)`, "m"),
            `$1/** @internal */\n$2`
        );
    }
    const outPath = await writeGeneratedFile("nodejs/src/generated/session-events.ts", annotatedTs);
    console.log(`  ✓ ${outPath}`);
}

// ── RPC Types ───────────────────────────────────────────────────────────────