/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. *--------------------------------------------------------------------------------------------*/ /** * Java code generator for session-events and RPC types. * Generates Java source files under src/generated/java/ from JSON Schema files. */ import fs from "fs/promises"; import path from "path"; import { fileURLToPath } from "url"; import type { JSONSchema7 } from "json-schema"; const __filename = fileURLToPath(import.meta.url); const __dirname = path.dirname(__filename); /** Root of the copilot-sdk-java repo */ const REPO_ROOT = path.resolve(__dirname, "../.."); /** Event types to exclude from generation (internal/legacy types) */ const EXCLUDED_EVENT_TYPES = new Set(["session.import_legacy"]); const AUTO_GENERATED_HEADER = `// AUTO-GENERATED FILE - DO NOT EDIT`; const GENERATED_FROM_SESSION_EVENTS = `// Generated from: session-events.schema.json`; const GENERATED_FROM_API = `// Generated from: api.schema.json`; const GENERATED_ANNOTATION = `@javax.annotation.processing.Generated("copilot-sdk-codegen")`; const COPYRIGHT = `/*---------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All rights reserved.\n *--------------------------------------------------------------------------------------------*/`; // ── Naming utilities ───────────────────────────────────────────────────────── function toPascalCase(name: string): string { return name.split(/[-_.]/).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(""); } function toJavaClassName(typeName: string): string { return typeName.split(/[._]/).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(""); } function toCamelCase(name: string): string { const pascal = toPascalCase(name); return pascal.charAt(0).toLowerCase() + pascal.slice(1); } function toEnumConstant(value: string): string { return value.toUpperCase().replace(/[-. ]/g, "_"); } // ── Schema path resolution ─────────────────────────────────────────────────── async function getSessionEventsSchemaPath(): Promise { const candidates = [ path.join(REPO_ROOT, "scripts/codegen/node_modules/@github/copilot/schemas/session-events.schema.json"), path.join(REPO_ROOT, "nodejs/node_modules/@github/copilot/schemas/session-events.schema.json"), ]; for (const p of candidates) { try { await fs.access(p); return p; } catch { // try next } } throw new Error("session-events.schema.json not found. Run 'npm ci' in scripts/codegen first."); } async function getApiSchemaPath(): Promise { const candidates = [ path.join(REPO_ROOT, "scripts/codegen/node_modules/@github/copilot/schemas/api.schema.json"), path.join(REPO_ROOT, "nodejs/node_modules/@github/copilot/schemas/api.schema.json"), ]; for (const p of candidates) { try { await fs.access(p); return p; } catch { // try next } } throw new Error("api.schema.json not found. Run 'npm ci' in scripts/codegen first."); } // ── File writing ───────────────────────────────────────────────────────────── async function writeGeneratedFile(relativePath: string, content: string): Promise { const fullPath = path.join(REPO_ROOT, relativePath); await fs.mkdir(path.dirname(fullPath), { recursive: true }); await fs.writeFile(fullPath, content, "utf-8"); console.log(` ✓ ${relativePath}`); return fullPath; } // ── Java type mapping ───────────────────────────────────────────────────────── interface JavaTypeResult { javaType: string; imports: Set; } function schemaTypeToJava( schema: JSONSchema7, required: boolean, context: string, propName: string, nestedTypes: Map ): JavaTypeResult { const imports = new Set(); if (schema.anyOf) { const hasNull = schema.anyOf.some((s) => typeof s === "object" && (s as JSONSchema7).type === "null"); const nonNull = schema.anyOf.filter((s) => typeof s === "object" && (s as JSONSchema7).type !== "null"); if (nonNull.length === 1) { const result = schemaTypeToJava(nonNull[0] as JSONSchema7, required && !hasNull, context, propName, nestedTypes); return result; } // Multi-branch anyOf: fall through to Object, matching the C# generator's // behavior. Java has no union types, so Object is the correct erasure for // anyOf[string, object] and similar multi-variant schemas. console.warn(`[codegen] ${context}.${propName}: anyOf with ${nonNull.length} non-null branches — falling back to Object`); return { javaType: "Object", imports }; } if (schema.type === "string") { if (schema.format === "uuid") { imports.add("java.util.UUID"); return { javaType: "UUID", imports }; } if (schema.format === "date-time") { imports.add("java.time.OffsetDateTime"); return { javaType: "OffsetDateTime", imports }; } if (schema.enum && Array.isArray(schema.enum)) { const enumName = `${context}${toPascalCase(propName)}`; nestedTypes.set(enumName, { kind: "enum", name: enumName, values: schema.enum as string[], description: schema.description, }); return { javaType: enumName, imports }; } return { javaType: "String", imports }; } if (Array.isArray(schema.type)) { const nonNullTypes = schema.type.filter((t) => t !== "null"); if (nonNullTypes.length === 1) { const baseSchema = { ...schema, type: nonNullTypes[0] }; return schemaTypeToJava(baseSchema as JSONSchema7, required, context, propName, nestedTypes); } } if (schema.type === "integer") { // JSON Schema "integer" maps to Long (boxed — always used for records). // Use primitive long for required fields in mutable-bean contexts if needed. return { javaType: required ? "long" : "Long", imports }; } if (schema.type === "number") { return { javaType: required ? "double" : "Double", imports }; } if (schema.type === "boolean") { return { javaType: required ? "boolean" : "Boolean", imports }; } if (schema.type === "array") { const items = schema.items as JSONSchema7 | undefined; if (items) { // Always pass required=false so primitives are boxed (List, not List) const itemResult = schemaTypeToJava(items, false, context, propName + "Item", nestedTypes); imports.add("java.util.List"); for (const imp of itemResult.imports) imports.add(imp); return { javaType: `List<${itemResult.javaType}>`, imports }; } imports.add("java.util.List"); console.warn(`[codegen] ${context}.${propName}: array without typed items — falling back to List