@hla4ts/hla-api 0.1.0

package/src/exceptions.ts

@@ -0,0 +1,971 @@
+/**
+ * HLA 4 Exception Classes
+ *
+ * This module defines the exception hierarchy for HLA 4 (IEEE 1516-2025),
+ * mapping protobuf ExceptionData to TypeScript errors.
+ *
+ * The exception names match the HLA 4 specification exactly.
+ */
+
+import type { ExceptionData } from "@hla4ts/proto";
+
+// =============================================================================
+// Base Exception
+// =============================================================================
+
+/**
+ * Base class for all HLA exceptions.
+ */
+export class RTIexception extends Error {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RTIexception";
+    // Maintains proper stack trace for where the error was thrown
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+}
+
+/**
+ * RTI internal error - indicates an unexpected error within the RTI.
+ */
+export class RTIinternalError extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RTIinternalError";
+  }
+}
+
+// =============================================================================
+// Connection Exceptions
+// =============================================================================
+
+export class AlreadyConnected extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AlreadyConnected";
+  }
+}
+
+export class ConnectionFailed extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ConnectionFailed";
+  }
+}
+
+export class NotConnected extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "NotConnected";
+  }
+}
+
+export class Unauthorized extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "Unauthorized";
+  }
+}
+
+export class InvalidCredentials extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidCredentials";
+  }
+}
+
+export class UnsupportedCallbackModel extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "UnsupportedCallbackModel";
+  }
+}
+
+export class CallNotAllowedFromWithinCallback extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "CallNotAllowedFromWithinCallback";
+  }
+}
+
+// =============================================================================
+// Federation Management Exceptions
+// =============================================================================
+
+export class FederationExecutionAlreadyExists extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederationExecutionAlreadyExists";
+  }
+}
+
+export class FederationExecutionDoesNotExist extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederationExecutionDoesNotExist";
+  }
+}
+
+export class FederatesCurrentlyJoined extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederatesCurrentlyJoined";
+  }
+}
+
+export class FederateAlreadyExecutionMember extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateAlreadyExecutionMember";
+  }
+}
+
+export class FederateNotExecutionMember extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateNotExecutionMember";
+  }
+}
+
+export class FederateIsExecutionMember extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateIsExecutionMember";
+  }
+}
+
+export class FederateNameAlreadyInUse extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateNameAlreadyInUse";
+  }
+}
+
+export class FederateOwnsAttributes extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateOwnsAttributes";
+  }
+}
+
+// =============================================================================
+// FOM/MIM Exceptions
+// =============================================================================
+
+export class InconsistentFOM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InconsistentFOM";
+  }
+}
+
+export class InvalidFOM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidFOM";
+  }
+}
+
+export class CouldNotOpenFOM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "CouldNotOpenFOM";
+  }
+}
+
+export class ErrorReadingFOM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ErrorReadingFOM";
+  }
+}
+
+export class InvalidMIM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidMIM";
+  }
+}
+
+export class CouldNotOpenMIM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "CouldNotOpenMIM";
+  }
+}
+
+export class ErrorReadingMIM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ErrorReadingMIM";
+  }
+}
+
+export class DesignatorIsHLAstandardMIM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "DesignatorIsHLAstandardMIM";
+  }
+}
+
+// =============================================================================
+// Time Management Exceptions
+// =============================================================================
+
+export class CouldNotCreateLogicalTimeFactory extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "CouldNotCreateLogicalTimeFactory";
+  }
+}
+
+export class FederateUnableToUseTime extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateUnableToUseTime";
+  }
+}
+
+export class InvalidLogicalTime extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidLogicalTime";
+  }
+}
+
+export class InvalidLogicalTimeInterval extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidLogicalTimeInterval";
+  }
+}
+
+export class InvalidLookahead extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidLookahead";
+  }
+}
+
+export class LogicalTimeAlreadyPassed extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "LogicalTimeAlreadyPassed";
+  }
+}
+
+export class InTimeAdvancingState extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InTimeAdvancingState";
+  }
+}
+
+export class TimeConstrainedAlreadyEnabled extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "TimeConstrainedAlreadyEnabled";
+  }
+}
+
+export class TimeConstrainedIsNotEnabled extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "TimeConstrainedIsNotEnabled";
+  }
+}
+
+export class TimeRegulationAlreadyEnabled extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "TimeRegulationAlreadyEnabled";
+  }
+}
+
+export class TimeRegulationIsNotEnabled extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "TimeRegulationIsNotEnabled";
+  }
+}
+
+export class RequestForTimeConstrainedPending extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RequestForTimeConstrainedPending";
+  }
+}
+
+export class RequestForTimeRegulationPending extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RequestForTimeRegulationPending";
+  }
+}
+
+export class IllegalTimeArithmetic extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "IllegalTimeArithmetic";
+  }
+}
+
+// =============================================================================
+// Save/Restore Exceptions
+// =============================================================================
+
+export class SaveInProgress extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "SaveInProgress";
+  }
+}
+
+export class SaveNotInProgress extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "SaveNotInProgress";
+  }
+}
+
+export class SaveNotInitiated extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "SaveNotInitiated";
+  }
+}
+
+export class RestoreInProgress extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RestoreInProgress";
+  }
+}
+
+export class RestoreNotInProgress extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RestoreNotInProgress";
+  }
+}
+
+export class RestoreNotRequested extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RestoreNotRequested";
+  }
+}
+
+export class FederateHasNotBegunSave extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateHasNotBegunSave";
+  }
+}
+
+// =============================================================================
+// Object Class Exceptions
+// =============================================================================
+
+export class ObjectClassNotDefined extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ObjectClassNotDefined";
+  }
+}
+
+export class ObjectClassNotPublished extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ObjectClassNotPublished";
+  }
+}
+
+export class InvalidObjectClassHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidObjectClassHandle";
+  }
+}
+
+// =============================================================================
+// Object Instance Exceptions
+// =============================================================================
+
+export class ObjectInstanceNotKnown extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ObjectInstanceNotKnown";
+  }
+}
+
+export class ObjectInstanceNameInUse extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ObjectInstanceNameInUse";
+  }
+}
+
+export class ObjectInstanceNameNotReserved extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ObjectInstanceNameNotReserved";
+  }
+}
+
+export class InvalidObjectInstanceHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidObjectInstanceHandle";
+  }
+}
+
+export class DeletePrivilegeNotHeld extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "DeletePrivilegeNotHeld";
+  }
+}
+
+// =============================================================================
+// Attribute Exceptions
+// =============================================================================
+
+export class AttributeNotDefined extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeNotDefined";
+  }
+}
+
+export class AttributeNotOwned extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeNotOwned";
+  }
+}
+
+export class AttributeNotPublished extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeNotPublished";
+  }
+}
+
+export class AttributeAlreadyOwned extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeAlreadyOwned";
+  }
+}
+
+export class AttributeAlreadyBeingAcquired extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeAlreadyBeingAcquired";
+  }
+}
+
+export class AttributeAlreadyBeingChanged extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeAlreadyBeingChanged";
+  }
+}
+
+export class AttributeAlreadyBeingDivested extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeAlreadyBeingDivested";
+  }
+}
+
+export class AttributeAcquisitionWasNotRequested extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeAcquisitionWasNotRequested";
+  }
+}
+
+export class AttributeDivestitureWasNotRequested extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AttributeDivestitureWasNotRequested";
+  }
+}
+
+export class InvalidAttributeHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidAttributeHandle";
+  }
+}
+
+// =============================================================================
+// Interaction Class Exceptions
+// =============================================================================
+
+export class InteractionClassNotDefined extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InteractionClassNotDefined";
+  }
+}
+
+export class InteractionClassNotPublished extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InteractionClassNotPublished";
+  }
+}
+
+export class InteractionClassAlreadyBeingChanged extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InteractionClassAlreadyBeingChanged";
+  }
+}
+
+export class InteractionParameterNotDefined extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InteractionParameterNotDefined";
+  }
+}
+
+export class InvalidInteractionClassHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidInteractionClassHandle";
+  }
+}
+
+export class InvalidParameterHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidParameterHandle";
+  }
+}
+
+// =============================================================================
+// Federate Handle Exceptions
+// =============================================================================
+
+export class FederateHandleNotKnown extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateHandleNotKnown";
+  }
+}
+
+export class InvalidFederateHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidFederateHandle";
+  }
+}
+
+// =============================================================================
+// Ownership Exceptions
+// =============================================================================
+
+export class NoAcquisitionPending extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "NoAcquisitionPending";
+  }
+}
+
+export class OwnershipAcquisitionPending extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "OwnershipAcquisitionPending";
+  }
+}
+
+// =============================================================================
+// Region Exceptions
+// =============================================================================
+
+export class InvalidRegion extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidRegion";
+  }
+}
+
+export class InvalidRegionContext extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidRegionContext";
+  }
+}
+
+export class RegionNotCreatedByThisFederate extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RegionNotCreatedByThisFederate";
+  }
+}
+
+export class RegionDoesNotContainSpecifiedDimension extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RegionDoesNotContainSpecifiedDimension";
+  }
+}
+
+export class RegionInUseForUpdateOrSubscription extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "RegionInUseForUpdateOrSubscription";
+  }
+}
+
+export class InvalidDimensionHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidDimensionHandle";
+  }
+}
+
+export class InvalidRangeBound extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidRangeBound";
+  }
+}
+
+// =============================================================================
+// Message Retraction Exceptions
+// =============================================================================
+
+export class InvalidMessageRetractionHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidMessageRetractionHandle";
+  }
+}
+
+export class MessageCanNoLongerBeRetracted extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "MessageCanNoLongerBeRetracted";
+  }
+}
+
+// =============================================================================
+// Transportation Exceptions
+// =============================================================================
+
+export class InvalidTransportationName extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidTransportationName";
+  }
+}
+
+export class InvalidTransportationTypeHandle extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidTransportationTypeHandle";
+  }
+}
+
+// =============================================================================
+// Order Exceptions
+// =============================================================================
+
+export class InvalidOrderName extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidOrderName";
+  }
+}
+
+export class InvalidOrderType extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidOrderType";
+  }
+}
+
+// =============================================================================
+// Service/Switch Exceptions
+// =============================================================================
+
+export class InvalidServiceGroup extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidServiceGroup";
+  }
+}
+
+export class InvalidUpdateRateDesignator extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidUpdateRateDesignator";
+  }
+}
+
+export class AsynchronousDeliveryAlreadyEnabled extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AsynchronousDeliveryAlreadyEnabled";
+  }
+}
+
+export class AsynchronousDeliveryAlreadyDisabled extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "AsynchronousDeliveryAlreadyDisabled";
+  }
+}
+
+export class FederateServiceInvocationsAreBeingReportedViaMOM extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateServiceInvocationsAreBeingReportedViaMOM";
+  }
+}
+
+export class ReportServiceInvocationsAreSubscribed extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "ReportServiceInvocationsAreSubscribed";
+  }
+}
+
+// =============================================================================
+// Synchronization Point Exceptions
+// =============================================================================
+
+export class SynchronizationPointLabelNotAnnounced extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "SynchronizationPointLabelNotAnnounced";
+  }
+}
+
+// =============================================================================
+// Miscellaneous Exceptions
+// =============================================================================
+
+export class NameNotFound extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "NameNotFound";
+  }
+}
+
+export class NameSetWasEmpty extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "NameSetWasEmpty";
+  }
+}
+
+export class IllegalName extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "IllegalName";
+  }
+}
+
+export class InvalidResignAction extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "InvalidResignAction";
+  }
+}
+
+export class CouldNotDecode extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "CouldNotDecode";
+  }
+}
+
+export class CouldNotEncode extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "CouldNotEncode";
+  }
+}
+
+/**
+ * Exception thrown from within a federate's callback handler.
+ */
+export class FederateInternalError extends RTIexception {
+  constructor(message?: string) {
+    super(message);
+    this.name = "FederateInternalError";
+  }
+}
+
+// =============================================================================
+// Exception Registry and Factory
+// =============================================================================
+
+/**
+ * Type for exception constructor functions.
+ */
+type ExceptionConstructor = new (message?: string) => RTIexception;
+
+/**
+ * Map of exception names to their constructors.
+ */
+const EXCEPTION_REGISTRY: Map<string, ExceptionConstructor> = new Map([
+  ["AlreadyConnected", AlreadyConnected],
+  ["AsynchronousDeliveryAlreadyDisabled", AsynchronousDeliveryAlreadyDisabled],
+  ["AsynchronousDeliveryAlreadyEnabled", AsynchronousDeliveryAlreadyEnabled],
+  ["AttributeAcquisitionWasNotRequested", AttributeAcquisitionWasNotRequested],
+  ["AttributeAlreadyBeingAcquired", AttributeAlreadyBeingAcquired],
+  ["AttributeAlreadyBeingChanged", AttributeAlreadyBeingChanged],
+  ["AttributeAlreadyBeingDivested", AttributeAlreadyBeingDivested],
+  ["AttributeAlreadyOwned", AttributeAlreadyOwned],
+  ["AttributeDivestitureWasNotRequested", AttributeDivestitureWasNotRequested],
+  ["AttributeNotDefined", AttributeNotDefined],
+  ["AttributeNotOwned", AttributeNotOwned],
+  ["AttributeNotPublished", AttributeNotPublished],
+  ["CallNotAllowedFromWithinCallback", CallNotAllowedFromWithinCallback],
+  ["ConnectionFailed", ConnectionFailed],
+  ["CouldNotCreateLogicalTimeFactory", CouldNotCreateLogicalTimeFactory],
+  ["CouldNotDecode", CouldNotDecode],
+  ["CouldNotEncode", CouldNotEncode],
+  ["CouldNotOpenFOM", CouldNotOpenFOM],
+  ["CouldNotOpenMIM", CouldNotOpenMIM],
+  ["DeletePrivilegeNotHeld", DeletePrivilegeNotHeld],
+  ["DesignatorIsHLAstandardMIM", DesignatorIsHLAstandardMIM],
+  ["ErrorReadingFOM", ErrorReadingFOM],
+  ["ErrorReadingMIM", ErrorReadingMIM],
+  ["FederateAlreadyExecutionMember", FederateAlreadyExecutionMember],
+  ["FederateHandleNotKnown", FederateHandleNotKnown],
+  ["FederateHasNotBegunSave", FederateHasNotBegunSave],
+  ["FederateInternalError", FederateInternalError],
+  ["FederateIsExecutionMember", FederateIsExecutionMember],
+  ["FederateNameAlreadyInUse", FederateNameAlreadyInUse],
+  ["FederateNotExecutionMember", FederateNotExecutionMember],
+  ["FederateOwnsAttributes", FederateOwnsAttributes],
+  ["FederatesCurrentlyJoined", FederatesCurrentlyJoined],
+  ["FederateServiceInvocationsAreBeingReportedViaMOM", FederateServiceInvocationsAreBeingReportedViaMOM],
+  ["FederateUnableToUseTime", FederateUnableToUseTime],
+  ["FederationExecutionAlreadyExists", FederationExecutionAlreadyExists],
+  ["FederationExecutionDoesNotExist", FederationExecutionDoesNotExist],
+  ["IllegalName", IllegalName],
+  ["IllegalTimeArithmetic", IllegalTimeArithmetic],
+  ["InconsistentFOM", InconsistentFOM],
+  ["InteractionClassAlreadyBeingChanged", InteractionClassAlreadyBeingChanged],
+  ["InteractionClassNotDefined", InteractionClassNotDefined],
+  ["InteractionClassNotPublished", InteractionClassNotPublished],
+  ["InteractionParameterNotDefined", InteractionParameterNotDefined],
+  ["InTimeAdvancingState", InTimeAdvancingState],
+  ["InvalidAttributeHandle", InvalidAttributeHandle],
+  ["InvalidCredentials", InvalidCredentials],
+  ["InvalidDimensionHandle", InvalidDimensionHandle],
+  ["InvalidFederateHandle", InvalidFederateHandle],
+  ["InvalidFOM", InvalidFOM],
+  ["InvalidInteractionClassHandle", InvalidInteractionClassHandle],
+  ["InvalidLogicalTime", InvalidLogicalTime],
+  ["InvalidLogicalTimeInterval", InvalidLogicalTimeInterval],
+  ["InvalidLookahead", InvalidLookahead],
+  ["InvalidMessageRetractionHandle", InvalidMessageRetractionHandle],
+  ["InvalidMIM", InvalidMIM],
+  ["InvalidObjectClassHandle", InvalidObjectClassHandle],
+  ["InvalidObjectInstanceHandle", InvalidObjectInstanceHandle],
+  ["InvalidOrderName", InvalidOrderName],
+  ["InvalidOrderType", InvalidOrderType],
+  ["InvalidParameterHandle", InvalidParameterHandle],
+  ["InvalidRangeBound", InvalidRangeBound],
+  ["InvalidRegion", InvalidRegion],
+  ["InvalidRegionContext", InvalidRegionContext],
+  ["InvalidResignAction", InvalidResignAction],
+  ["InvalidServiceGroup", InvalidServiceGroup],
+  ["InvalidTransportationName", InvalidTransportationName],
+  ["InvalidTransportationTypeHandle", InvalidTransportationTypeHandle],
+  ["InvalidUpdateRateDesignator", InvalidUpdateRateDesignator],
+  ["LogicalTimeAlreadyPassed", LogicalTimeAlreadyPassed],
+  ["MessageCanNoLongerBeRetracted", MessageCanNoLongerBeRetracted],
+  ["NameNotFound", NameNotFound],
+  ["NameSetWasEmpty", NameSetWasEmpty],
+  ["NoAcquisitionPending", NoAcquisitionPending],
+  ["NotConnected", NotConnected],
+  ["ObjectClassNotDefined", ObjectClassNotDefined],
+  ["ObjectClassNotPublished", ObjectClassNotPublished],
+  ["ObjectInstanceNameInUse", ObjectInstanceNameInUse],
+  ["ObjectInstanceNameNotReserved", ObjectInstanceNameNotReserved],
+  ["ObjectInstanceNotKnown", ObjectInstanceNotKnown],
+  ["OwnershipAcquisitionPending", OwnershipAcquisitionPending],
+  ["RegionDoesNotContainSpecifiedDimension", RegionDoesNotContainSpecifiedDimension],
+  ["RegionInUseForUpdateOrSubscription", RegionInUseForUpdateOrSubscription],
+  ["RegionNotCreatedByThisFederate", RegionNotCreatedByThisFederate],
+  ["ReportServiceInvocationsAreSubscribed", ReportServiceInvocationsAreSubscribed],
+  ["RequestForTimeConstrainedPending", RequestForTimeConstrainedPending],
+  ["RequestForTimeRegulationPending", RequestForTimeRegulationPending],
+  ["RestoreInProgress", RestoreInProgress],
+  ["RestoreNotInProgress", RestoreNotInProgress],
+  ["RestoreNotRequested", RestoreNotRequested],
+  ["RTIexception", RTIexception],
+  ["RTIinternalError", RTIinternalError],
+  ["SaveInProgress", SaveInProgress],
+  ["SaveNotInitiated", SaveNotInitiated],
+  ["SaveNotInProgress", SaveNotInProgress],
+  ["SynchronizationPointLabelNotAnnounced", SynchronizationPointLabelNotAnnounced],
+  ["TimeConstrainedAlreadyEnabled", TimeConstrainedAlreadyEnabled],
+  ["TimeConstrainedIsNotEnabled", TimeConstrainedIsNotEnabled],
+  ["TimeRegulationAlreadyEnabled", TimeRegulationAlreadyEnabled],
+  ["TimeRegulationIsNotEnabled", TimeRegulationIsNotEnabled],
+  ["Unauthorized", Unauthorized],
+  ["UnsupportedCallbackModel", UnsupportedCallbackModel],
+]);
+
+/**
+ * Create an HLA exception from an exception name and details.
+ *
+ * @param exceptionName - The HLA exception class name (e.g., "NotConnected")
+ * @param details - The exception message/details
+ * @returns The appropriate RTIexception subclass instance
+ */
+export function createException(exceptionName: string, details?: string): RTIexception {
+  const Constructor = EXCEPTION_REGISTRY.get(exceptionName);
+  if (Constructor) {
+    return new Constructor(details);
+  }
+  // Unknown exception type - wrap as RTIinternalError
+  return new RTIinternalError(`${exceptionName}: ${details ?? "Unknown error"}`);
+}
+
+/**
+ * Create an HLA exception from protobuf ExceptionData.
+ *
+ * @param exceptionData - The protobuf exception data
+ * @returns The appropriate RTIexception subclass instance
+ */
+export function createExceptionFromProto(exceptionData: ExceptionData): RTIexception {
+  return createException(exceptionData.exceptionName, exceptionData.details);
+}
+
+/**
+ * Throw an HLA exception from an exception name and details.
+ *
+ * This is useful for immediately throwing after decoding a response.
+ *
+ * @param exceptionName - The HLA exception class name
+ * @param details - The exception message/details
+ * @throws RTIexception or appropriate subclass
+ */
+export function throwException(exceptionName: string, details?: string): never {
+  throw createException(exceptionName, details);
+}
+
+/**
+ * Throw an HLA exception from protobuf ExceptionData.
+ *
+ * @param exceptionData - The protobuf exception data
+ * @throws RTIexception or appropriate subclass
+ */
+export function throwExceptionFromProto(exceptionData: ExceptionData): never {
+  throw createExceptionFromProto(exceptionData);
+}