@genesislcap/event-type-codegen 15.17.0 → 15.18.0

package/dist/parse-metadata.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderEventTypesFromMetadataContracts = exports.parseEventMetadataDump = exports.eventNameToDetailsInterfaceName = exports.quoteTsString = void 0;
+const naming_1 = require("./naming");
+const isRecord = (value) => typeof value === 'object' && value != null && !Array.isArray(value);
+/** Quote a string for safe emission as a TS string literal / object key. */
+const quoteTsString = (s) => `'${s.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+exports.quoteTsString = quoteTsString;
+/** Bare identifier when legal; otherwise a quoted string key. */
+const tsPropertyKey = (name) => /^[A-Za-z_$][\w$]*$/.test(name) ? name : (0, exports.quoteTsString)(name);
+/** EVENT_BROKER_INSERT → BrokerInsertDetails */
+const eventNameToDetailsInterfaceName = (eventName) => {
+    const base = eventName.startsWith('EVENT_') ? eventName.slice('EVENT_'.length) : eventName;
+    const pascal = base
+        .toLowerCase()
+        .split('_')
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+    return `${pascal}Details`;
+};
+exports.eventNameToDetailsInterfaceName = eventNameToDetailsInterfaceName;
+/** Build a valid PascalCase TypeScript identifier from an enum name hint. */
+const toSafeEnumIdentifier = (enumNameHint) => {
+    const enumName = enumNameHint
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1).toLowerCase())
+        .join('');
+    if (!enumName)
+        return 'GeneratedEnum';
+    return /^[A-Za-z]/.test(enumName) ? enumName : `E${enumName}`;
+};
+const valuesKey = (values) => values.join('\0');
+/**
+ * Register an enum under a collision-safe name. Same values → reuse; different values →
+ * disambiguate (`Foo`, `Foo2`, …) and report via `unmapped`.
+ */
+const registerEnum = (enums, preferredName, values, unmapped, context) => {
+    const existing = enums.get(preferredName);
+    if (!existing) {
+        enums.set(preferredName, values);
+        return preferredName;
+    }
+    if (valuesKey(existing) === valuesKey(values)) {
+        return preferredName;
+    }
+    let n = 2;
+    let candidate = `${preferredName}${n}`;
+    while (enums.has(candidate) && valuesKey(enums.get(candidate)) !== valuesKey(values)) {
+        n += 1;
+        candidate = `${preferredName}${n}`;
+    }
+    if (!enums.has(candidate)) {
+        enums.set(candidate, values);
+        unmapped.push(`${context}: enum name collision for ${preferredName}; emitted as ${candidate}`);
+    }
+    return candidate;
+};
+const jsonSchemaTypeToTs = (propSchema, enums, enumNameHint, unmapped, context) => {
+    if (Array.isArray(propSchema.enum) && propSchema.enum.every((v) => typeof v === 'string')) {
+        const values = propSchema.enum;
+        const safeName = toSafeEnumIdentifier(enumNameHint);
+        return registerEnum(enums, safeName, values, unmapped, context);
+    }
+    if (Array.isArray(propSchema.oneOf)) {
+        const nonNull = propSchema.oneOf.find((branch) => isRecord(branch) && branch.type !== 'null');
+        if (isRecord(nonNull)) {
+            return jsonSchemaTypeToTs(nonNull, enums, enumNameHint, unmapped, context);
+        }
+    }
+    const type = propSchema.type;
+    if (type === 'integer' || type === 'number')
+        return 'number';
+    if (type === 'boolean')
+        return 'boolean';
+    if (type === 'array') {
+        const items = isRecord(propSchema.items) ? propSchema.items : {};
+        return `${jsonSchemaTypeToTs(items, enums, enumNameHint, unmapped, context)}[]`;
+    }
+    if (type === 'object')
+        return 'Record<string, unknown>';
+    return 'string';
+};
+const metadataJsonTypeToTs = (jsonType, fieldType) => {
+    const jt = (jsonType !== null && jsonType !== void 0 ? jsonType : '').toLowerCase();
+    if (jt === 'integer' || jt === 'number')
+        return 'number';
+    if (jt === 'boolean')
+        return 'boolean';
+    if ((fieldType !== null && fieldType !== void 0 ? fieldType : '').toUpperCase() === 'DATETIME' ||
+        (fieldType !== null && fieldType !== void 0 ? fieldType : '').toUpperCase() === 'DATE') {
+        return 'number';
+    }
+    return 'string';
+};
+const extractDetailsSchema = (inbound) => {
+    if (!inbound)
+        return null;
+    const rootProps = isRecord(inbound.properties) ? inbound.properties : undefined;
+    if (!rootProps)
+        return null;
+    // Event inbound is usually { DETAILS: { type: object, properties: {...}, required: [...] } }
+    const details = rootProps.DETAILS;
+    if (isRecord(details) && isRecord(details.properties)) {
+        const required = Array.isArray(details.required)
+            ? new Set(details.required.filter((r) => typeof r === 'string'))
+            : new Set();
+        return { properties: details.properties, required };
+    }
+    // Some schemas flatten DETAILS properties at the inbound root.
+    const required = Array.isArray(inbound.required)
+        ? new Set(inbound.required.filter((r) => typeof r === 'string'))
+        : new Set();
+    return { properties: rootProps, required };
+};
+/**
+ * Parse a header-captured event-metadata.json dump into per-event contracts.
+ */
+const parseEventMetadataDump = (dump) => {
+    var _a, _b, _c, _d;
+    const contracts = [];
+    const enums = new Map();
+    const unmapped = [];
+    const eventNames = Object.keys((_a = dump.events) !== null && _a !== void 0 ? _a : {}).sort((a, b) => a.localeCompare(b));
+    for (const eventName of eventNames) {
+        if (!eventName.startsWith('EVENT_')) {
+            unmapped.push(`${eventName}: not an EVENT_* handler`);
+            continue;
+        }
+        const entry = dump.events[eventName];
+        const inbound = isRecord((_b = entry === null || entry === void 0 ? void 0 : entry.schema) === null || _b === void 0 ? void 0 : _b.INBOUND)
+            ? entry.schema.INBOUND
+            : undefined;
+        const detailsSchema = extractDetailsSchema(inbound);
+        const fields = [];
+        if (detailsSchema) {
+            for (const [fieldName, rawProp] of Object.entries(detailsSchema.properties)) {
+                if (fieldName === 'MESSAGE_TYPE' || fieldName === 'SOURCE_REF')
+                    continue;
+                if (!isRecord(rawProp))
+                    continue;
+                const optional = !detailsSchema.required.has(fieldName);
+                const enumNameHint = eventName.startsWith('EVENT_')
+                    ? `${eventName.slice('EVENT_'.length)}_${fieldName}`
+                    : `${eventName}_${fieldName}`;
+                fields.push({
+                    name: fieldName,
+                    tsType: jsonSchemaTypeToTs(rawProp, enums, enumNameHint, unmapped, `${eventName}.${fieldName}`),
+                    optional,
+                });
+            }
+        }
+        else if ((_d = (_c = entry === null || entry === void 0 ? void 0 : entry.metadata) === null || _c === void 0 ? void 0 : _c.FIELD) === null || _d === void 0 ? void 0 : _d.length) {
+            for (const field of entry.metadata.FIELD) {
+                fields.push({
+                    name: field.NAME,
+                    tsType: metadataJsonTypeToTs(field.JSON_TYPE, field.TYPE),
+                    optional: field.OPTIONAL !== false,
+                });
+            }
+        }
+        else {
+            unmapped.push(`${eventName}: no INBOUND DETAILS schema or metadata.FIELD`);
+            continue;
+        }
+        contracts.push({
+            eventName,
+            detailsInterface: (0, exports.eventNameToDetailsInterfaceName)(eventName),
+            fields,
+        });
+    }
+    const enumDefs = [...enums.entries()]
+        .map(([name, values]) => ({ name, values }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    return { contracts, enums: enumDefs, unmapped };
+};
+exports.parseEventMetadataDump = parseEventMetadataDump;
+const renderEventTypesFromMetadataContracts = (contracts, enums, unmapped) => {
+    const unmappedComment = unmapped.length > 0
+        ? `/**\n * Unmapped handlers (not included in EventDetailsMap):\n${unmapped
+            .map((line) => ` * - ${line}`)
+            .join('\n')}\n */\n\n`
+        : '';
+    const enumExports = enums
+        .map((e) => {
+        const entries = e.values
+            .map((value) => `  ${(0, exports.quoteTsString)(value)}: ${(0, exports.quoteTsString)(value)},`)
+            .join('\n');
+        return `export const ${e.name} = {\n${entries}\n} as const;\n\nexport type ${e.name} = (typeof ${e.name})[keyof typeof ${e.name}];`;
+    })
+        .join('\n\n');
+    const interfaces = contracts
+        .map((c) => {
+        const lines = c.fields.map((f) => {
+            const optional = f.optional ? '?' : '';
+            return `  ${tsPropertyKey(f.name)}${optional}: ${f.tsType};`;
+        });
+        return `export interface ${c.detailsInterface} {\n${lines.join('\n')}\n}`;
+    })
+        .join('\n\n');
+    const mapEntries = contracts
+        .map((c) => `  ${tsPropertyKey(c.eventName)}: ${c.detailsInterface};`)
+        .join('\n');
+    const eventClasses = contracts
+        .map((c) => {
+        const className = (0, naming_1.eventNameToEventClassName)(c.eventName);
+        return `export class ${className} extends GenesisEvent<'${c.eventName}', ${c.detailsInterface}> {
+  readonly MESSAGE_TYPE = '${c.eventName}' as const;
+
+  constructor(details: ${c.detailsInterface}) {
+    super(details);
+  }
+}`;
+    })
+        .join('\n\n');
+    const foundationCommsImport = contracts.length > 0 ? `import { GenesisEvent } from '@genesislcap/foundation-comms';\n\n` : '';
+    return `// AUTO-GENERATED — do not edit
+// Source: event metadata dump (genx generate event-types --from-metadata)
+
+${unmappedComment}${foundationCommsImport}${enumExports ? `${enumExports}\n\n` : ''}${interfaces}
+
+export interface EventDetailsMap {
+${mapEntries}
+}
+
+export type GenesisEventName = keyof EventDetailsMap;
+${eventClasses ? `\n${eventClasses}\n` : ''}`;
+};
+exports.renderEventTypesFromMetadataContracts = renderEventTypesFromMetadataContracts;
+//# sourceMappingURL=parse-metadata.js.map

package/dist/parse-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-metadata.js","sourceRoot":"","sources":["../src/parse-metadata.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/event-type-codegen",
   "description": "Build-time TypeScript codegen from Kotlin event handler DTOs",
-  "version": "15.17.0",
+  "version": "15.18.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,7 @@
     "consola": "^3.0.2"
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.17.0",
+    "@genesislcap/foundation-testing": "15.18.0",
     "@types/node": "^22.10.2",
     "tsx": "^4.7.0",
     "uvu": "0.5.4"
@@ -34,5 +34,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "2e040c4861f6acfde7afef48b60555548fac8708"
+  "gitHead": "a92013873774dbc7f67a32d37994f10777f86383"
 }

package/src/index.ts

@@ -1,4 +1,4 @@
-import { existsSync, globSync } from 'node:fs';
+import { existsSync, globSync, readFileSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname, join, resolve } from 'node:path';
 import { consola } from 'consola';
@@ -7,6 +7,11 @@ import { resolveEventTypesConfig } from './config';
 import { parseGeneratedDaosFromSources } from './parse-dao';
 import { parseGeneratedEnumsFromSources } from './parse-enums';
 import { parseHandlersFromSources, parseDtosFromSources } from './parse-kotlin';
+import {
+  parseEventMetadataDump,
+  renderEventTypesFromMetadataContracts,
+  type EventMetadataDump,
+} from './parse-metadata';
 import { renderEventTypesFile } from './render';
 import type { EventTypesResolvedConfig, GenerateResult, KotlinDto } from './types';
 
@@ -56,8 +61,50 @@ export type GenerateEventTypesOptions = {
   clientRoot: string;
   config?: EventTypesResolvedConfig;
   packageGenesis?: { eventTypes?: unknown };
+  /** When set, generate from a header-captured metadata dump instead of Kotlin sources. */
+  fromMetadataPath?: string;
 };
 
+export async function generateEventTypesFromMetadata(options: {
+  clientRoot: string;
+  metadataPath: string;
+  output?: string;
+}): Promise<GenerateResult> {
+  const metadataPath = resolve(options.clientRoot, options.metadataPath);
+  if (!existsSync(metadataPath)) {
+    throw new Error(`eventTypes: metadata dump not found at ${metadataPath}`);
+  }
+
+  let dump: EventMetadataDump;
+  try {
+    dump = JSON.parse(readFileSync(metadataPath, 'utf8')) as EventMetadataDump;
+  } catch (err) {
+    throw new Error(
+      `eventTypes: failed to parse metadata JSON dump at ${metadataPath}: ${
+        err instanceof Error ? err.message : String(err)
+      }`,
+    );
+  }
+  const { contracts, enums, unmapped } = parseEventMetadataDump(dump);
+  const contents = renderEventTypesFromMetadataContracts(contracts, enums, unmapped);
+
+  const outputRel = options.output ?? 'src/generated/genesis-event-types.ts';
+  const outputPath = resolve(options.clientRoot, outputRel);
+  await mkdir(dirname(outputPath), { recursive: true });
+  await writeFile(outputPath, contents, 'utf8');
+
+  consola.info(
+    `eventTypes: wrote ${outputPath} from metadata (${contracts.length} events, ${unmapped.length} unmapped)`,
+  );
+
+  return {
+    outputPath,
+    eventCount: contracts.length,
+    dtoCount: contracts.length,
+    unmappedCount: unmapped.length,
+  };
+}
+
 export async function generateEventTypes(
   options: GenerateEventTypesOptions,
 ): Promise<GenerateResult | null> {
@@ -65,6 +112,14 @@ export async function generateEventTypes(
     options.config ??
     resolveEventTypesConfig(options.clientRoot, undefined, options.packageGenesis);
 
+  if (options.fromMetadataPath) {
+    return generateEventTypesFromMetadata({
+      clientRoot: options.clientRoot,
+      metadataPath: options.fromMetadataPath,
+      output: resolved.output,
+    });
+  }
+
   if (!resolved.enabled) {
     return null;
   }
@@ -118,3 +173,12 @@ export async function generateEventTypes(
 
 export * from './types';
 export { resolveEventTypesConfig } from './config';
+export {
+  parseEventMetadataDump,
+  renderEventTypesFromMetadataContracts,
+  eventNameToDetailsInterfaceName,
+  type EventMetadataDump,
+  type MetadataEventContract,
+  type MetadataField,
+} from './parse-metadata';
+export { toUpperUnderscoreWithAcronyms, kotlinPropertyToWireField } from './naming';

package/src/kotlin-parse-utils.ts

@@ -38,25 +38,35 @@ export type ParseKotlinPropertyOptions = {
   allowBareParams?: boolean;
 };
 
+/** Plain or backtick-escaped Kotlin identifier (`value` for reserved words). */
+const KOTLIN_IDENT = '(?:\\w+|`[^`]+`)';
+
+const PROPERTY_REGEX = new RegExp(
+  `^(?:public\\s+)?(?:val|var)\\s+(${KOTLIN_IDENT})\\s*:\\s*([^=]+?)(?:\\s*=\\s*.+)?$`,
+);
+
+const BARE_PROPERTY_REGEX = new RegExp(`^(${KOTLIN_IDENT})\\s*:\\s*([^=]+?)(?:\\s*=\\s*.+)?$`);
+
+const stripBackticks = (ident: string): string =>
+  ident.startsWith('`') && ident.endsWith('`') ? ident.slice(1, -1) : ident;
+
 /**
  * Parse a Kotlin constructor / data-class property segment into a wire-facing property.
- * Accepts optional public modifier and use-site-stripped annotations.
+ * Accepts optional public modifier, use-site-stripped annotations, and backtick-escaped
+ * reserved identifiers (e.g. `value` → value → wire VALUE).
  */
 export const parseKotlinProperty = (
   segment: string,
   options: ParseKotlinPropertyOptions = {},
 ): KotlinProperty | null => {
   const cleaned = stripKotlinAnnotations(segment);
-  const propertyMatch = cleaned.match(
-    /^(?:public\s+)?(?:val|var)\s+(\w+)\s*:\s*([^=]+?)(?:\s*=\s*.+)?$/,
-  );
+  const propertyMatch = cleaned.match(PROPERTY_REGEX);
   const match =
-    propertyMatch ??
-    (options.allowBareParams ? cleaned.match(/^(\w+)\s*:\s*([^=]+?)(?:\s*=\s*.+)?$/) : null);
+    propertyMatch ?? (options.allowBareParams ? cleaned.match(BARE_PROPERTY_REGEX) : null);
 
   if (!match) return null;
 
-  const name = match[1];
+  const name = stripBackticks(match[1]);
   let kotlinType = match[2].trim();
   const optional = kotlinType.endsWith('?') || cleaned.includes('=');
   kotlinType = kotlinType.replace(/\?$/, '').trim();

package/src/naming.ts

@@ -1,8 +1,64 @@
-import { constantCase, pascalCase } from 'change-case';
+import { pascalCase } from 'change-case';
+
+/**
+ * Character classification used by {@link toUpperUnderscoreWithAcronyms}.
+ * Mirrors genesis-server `CharType` in GenesisMessage.kt.
+ */
+type CharType = 'UPPERCASE' | 'LOWERCASE' | 'NUMBER';
+
+/**
+ * Convert camelCase / PascalCase to UPPER_UNDERSCORE, inserting `_` before digits and
+ * splitting acronyms the same way as genesis-server `toUpperUnderscoreWithAcronyms`.
+ *
+ * Examples: `addressLine1` → `ADDRESS_LINE_1`, `orderID` → `ORDER_ID`.
+ *
+ * @public
+ */
+export const toUpperUnderscoreWithAcronyms = (name: string): string => {
+  if (!name) return name;
+
+  // Already wire-formatted — genesis-server passes these through unchanged.
+  if (/^[A-Z0-9]+(?:_[A-Z0-9]+)*$/.test(name)) return name;
+
+  const length = name.length;
+  const result: string[] = [];
+  // Genesis seeds non-upper (including digits) as NUMBER so the first digit after
+  // letters still gets a leading underscore on subsequent chars.
+  let lastCharacterType: CharType = name[0] >= 'A' && name[0] <= 'Z' ? 'UPPERCASE' : 'NUMBER';
+
+  result.push(name[0].toUpperCase());
+
+  const isUpperOrDigit = (c: string): boolean => (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9');
+
+  for (let i = 1; i < length; i += 1) {
+    const ch = name[i];
+    if (ch >= 'A' && ch <= 'Z') {
+      // Continue an acronym run when the next char is also upper/digit; otherwise split.
+      const continueAcronym =
+        lastCharacterType === 'UPPERCASE' && (i + 1 >= length || isUpperOrDigit(name[i + 1]));
+      if (!continueAcronym) {
+        result.push('_');
+      }
+      result.push(ch);
+      lastCharacterType = 'UPPERCASE';
+    } else if (ch >= '0' && ch <= '9') {
+      if (lastCharacterType !== 'NUMBER') {
+        result.push('_');
+      }
+      result.push(ch);
+      lastCharacterType = 'NUMBER';
+    } else {
+      result.push(ch.toUpperCase());
+      lastCharacterType = 'LOWERCASE';
+    }
+  }
+
+  return result.join('');
+};
 
 /** Wire field name for a Kotlin property (DETAILS uses UPPER_SNAKE_CASE). */
 export const kotlinPropertyToWireField = (propertyName: string): string =>
-  constantCase(propertyName);
+  toUpperUnderscoreWithAcronyms(propertyName);
 
 /** Generated interface name for a Kotlin DTO or handler input type. */
 export const dtoToDetailsInterfaceName = (dtoName: string): string =>

package/src/parse-kotlin.ts

@@ -16,10 +16,11 @@ const PRIMITIVE_TS: Record<string, string> = {
   Float: 'number',
   Boolean: 'boolean',
   BigDecimal: 'string',
-  DateTime: 'string',
-  Instant: 'string',
-  LocalDate: 'string',
-  LocalDateTime: 'string',
+  // Genesis wire JSON_TYPE for DATE/DATETIME is integer (epoch millis).
+  DateTime: 'number',
+  Instant: 'number',
+  LocalDate: 'number',
+  LocalDateTime: 'number',
 };
 
 const DATA_CLASS_START = /^\s*(?:data\s+)?class\s+(\w+)\s*(?:\([^)]*\))?\s*(?:\([^)]*\)|\{)/;