Validate complex issuance reader payloads

src/functions/OpenCapTable/capTable/batchTypes.ts

@@ -495,6 +495,17 @@ export type DamlDataTypeFor<EntityType extends OcfEntityType> = Extract<
   { tag: OcfOperationTagFor<EntityType, 'edit'> }
 >['value'];
 
+/** Recursively readonly view used for immutable generated DAML writer output. */
+export type DeepReadonly<T> =
+  T extends ReadonlyArray<infer Item>
+    ? ReadonlyArray<DeepReadonly<Item>>
+    : T extends object
+      ? { readonly [Key in keyof T]: DeepReadonly<T[Key]> }
+      : T;
+
+/** Exact immutable generated DAML entity-data payload for one SDK entity kind. */
+export type ReadonlyDamlDataTypeFor<EntityType extends OcfEntityType> = DeepReadonly<DamlDataTypeFor<EntityType>>;
+
 /** Correlated entity-kind and generated DAML-data tuples accepted by the read dispatcher. */
 export type DamlEntityArguments = {
   [EntityType in OcfEntityType]: readonly [type: EntityType, damlData: DamlDataTypeFor<EntityType>];

src/functions/OpenCapTable/capTable/damlEntityData.ts

@@ -22,6 +22,12 @@ import {
 } from './batchTypes';
 import { extractAndDecodeCancellationData, isCancellationEntityType } from './cancellationContractData';
 import { decodeLosslessGeneratedDamlValue, type ReadonlyGeneratedDaml } from './damlCodecLosslessness';
+import {
+  decodeComplexIssuanceDamlData,
+  extractAndDecodeComplexIssuanceData,
+  isComplexIssuanceEntityType,
+  validateComplexIssuanceDamlDataInput,
+} from './issuanceContractData';
 import {
   extractAndDecodeTransferData,
   isTransferEntityType,
@@ -122,6 +128,9 @@ function createEntityDataDecoder<const EntityType extends OcfEntityType>(
             if (isVestingEntityType(entityType)) {
               validateVestingDamlDataInput(entityType, decoderInput);
             }
+            if (isComplexIssuanceEntityType(entityType)) {
+              validateComplexIssuanceDamlDataInput(entityType, decoderInput);
+            }
             assertCanonicalJsonGraph(decoderInput, entityType);
             preflightSemanticDamlEntityData(entityType, decoderInput);
             const decoderResult = codec.decoder.run(decoderInput);
@@ -348,6 +357,9 @@ export function decodeDamlEntityData(
   input: unknown
 ): ReadonlyDamlDataTypeFor<OcfEntityType> {
   assertSupportedOcfEntityType(entityType, 'damlToOcf.decodeDamlEntityData.entityType');
+  if (isComplexIssuanceEntityType(entityType)) {
+    return decodeComplexIssuanceDamlData(entityType, input);
+  }
   return ENTITY_DATA_DECODER_MAP[entityType](input);
 }
 
@@ -364,6 +376,10 @@ export function extractAndDecodeDamlEntityData(
     return extractAndDecodeAdministrativeAdjustmentData(entityType, createArgument);
   }
 
+  if (isComplexIssuanceEntityType(entityType)) {
+    return extractAndDecodeComplexIssuanceData(entityType, createArgument);
+  }
+
   if (isAcceptanceEntityType(entityType)) {
     return extractAndDecodeAcceptanceData(entityType, createArgument);
   }

src/functions/OpenCapTable/capTable/damlToOcf.ts

@@ -175,6 +175,23 @@ export function convertToOcf(
     );
   }
 
+  // Issuance converters run their correlated generated-codec preflight first,
+  // preserving one parse-error family across direct, dispatcher, and ledger reads.
+  if (type === 'convertibleIssuance') {
+    return damlConvertibleIssuanceDataToNative(data as Parameters<typeof damlConvertibleIssuanceDataToNative>[0]);
+  }
+  if (type === 'equityCompensationIssuance') {
+    return damlEquityCompensationIssuanceDataToNative(
+      data as Parameters<typeof damlEquityCompensationIssuanceDataToNative>[0]
+    );
+  }
+  if (type === 'stockIssuance') {
+    return damlStockIssuanceDataToNative(data as Parameters<typeof damlStockIssuanceDataToNative>[0]);
+  }
+  if (type === 'warrantIssuance') {
+    return damlWarrantIssuanceDataToNative(data as Parameters<typeof damlWarrantIssuanceDataToNative>[0]);
+  }
+
   assertCanonicalJsonGraph(data, type);
   switch (type) {
     // ===== Core objects =====
@@ -191,16 +208,6 @@ export function convertToOcf(
     case 'stockPlan':
       return damlStockPlanDataToNative(data);
 
-    // ===== Issuance types =====
-    case 'convertibleIssuance':
-      return damlConvertibleIssuanceDataToNative(data);
-    case 'equityCompensationIssuance':
-      return damlEquityCompensationIssuanceDataToNative(data);
-    case 'stockIssuance':
-      return damlStockIssuanceDataToNative(data as Parameters<typeof damlStockIssuanceDataToNative>[0]);
-    case 'warrantIssuance':
-      return damlWarrantIssuanceDataToNative(data);
-
     // ===== Acceptance types =====
     case 'stockAcceptance':
       return damlStockAcceptanceToNative(data as Parameters<typeof damlStockAcceptanceToNative>[0]);