@hla4ts/session 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hla4ts/session",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "HLA 4 Federate Protocol Session Layer - State machine, heartbeats, reconnection",
   "type": "module",
   "main": "src/index.ts",
@@ -24,8 +24,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@hla4ts/transport": "^0.1.0",
-    "@hla4ts/proto": "^0.1.0"
+    "@hla4ts/transport": "^0.1.1",
+    "@hla4ts/proto": "^0.1.1"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/errors.ts

@@ -1,98 +1,98 @@
-/**
- * Session Exceptions
- *
- * Custom error types for session-related failures.
- */
-
-import { SessionState } from "./types.ts";
-
-/**
- * Base class for session-related errors
- */
-export class SessionError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = "SessionError";
-    // Maintains proper stack trace for where the error was thrown
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, this.constructor);
-    }
-  }
-}
-
-/**
- * Thrown when the session is lost unexpectedly.
- * This can happen due to:
- * - Network disconnection
- * - Server timeout
- * - Protocol errors
- */
-export class SessionLostError extends SessionError {
-  constructor(message: string, public readonly cause?: Error) {
-    super(message);
-    this.name = "SessionLostError";
-  }
-}
-
-/**
- * Thrown when an operation is attempted on a session that is already terminated.
- */
-export class SessionAlreadyTerminatedError extends SessionError {
-  constructor(message: string = "Session has already terminated") {
-    super(message);
-    this.name = "SessionAlreadyTerminatedError";
-  }
-}
-
-/**
- * Thrown when an operation is attempted in an invalid session state.
- */
-export class SessionIllegalStateError extends SessionError {
-  constructor(
-    public readonly currentState: SessionState,
-    public readonly operation: string
-  ) {
-    super(`Cannot ${operation} in state ${currentState}`);
-    this.name = "SessionIllegalStateError";
-  }
-}
-
-/**
- * Thrown when a bad message is received from the server.
- */
-export class BadMessageError extends SessionError {
-  constructor(message: string) {
-    super(message);
-    this.name = "BadMessageError";
-  }
-}
-
-/**
- * Thrown when the message queue is full and cannot accept more messages.
- */
-export class MessageQueueFullError extends SessionError {
-  constructor() {
-    super("Message queue is full");
-    this.name = "MessageQueueFullError";
-  }
-}
-
-/**
- * Thrown when a connection attempt times out.
- */
-export class ConnectionTimeoutError extends SessionError {
-  constructor(timeoutMs: number) {
-    super(`Connection timed out after ${timeoutMs}ms`);
-    this.name = "ConnectionTimeoutError";
-  }
-}
-
-/**
- * Thrown when a response is not received within the expected timeout.
- */
-export class ResponseTimeoutError extends SessionError {
-  constructor(timeoutMs: number) {
-    super(`Response timed out after ${timeoutMs}ms`);
-    this.name = "ResponseTimeoutError";
-  }
-}
+/**
+ * Session Exceptions
+ *
+ * Custom error types for session-related failures.
+ */
+
+import { SessionState } from "./types.ts";
+
+/**
+ * Base class for session-related errors
+ */
+export class SessionError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "SessionError";
+    // Maintains proper stack trace for where the error was thrown
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+}
+
+/**
+ * Thrown when the session is lost unexpectedly.
+ * This can happen due to:
+ * - Network disconnection
+ * - Server timeout
+ * - Protocol errors
+ */
+export class SessionLostError extends SessionError {
+  constructor(message: string, public readonly cause?: Error) {
+    super(message);
+    this.name = "SessionLostError";
+  }
+}
+
+/**
+ * Thrown when an operation is attempted on a session that is already terminated.
+ */
+export class SessionAlreadyTerminatedError extends SessionError {
+  constructor(message: string = "Session has already terminated") {
+    super(message);
+    this.name = "SessionAlreadyTerminatedError";
+  }
+}
+
+/**
+ * Thrown when an operation is attempted in an invalid session state.
+ */
+export class SessionIllegalStateError extends SessionError {
+  constructor(
+    public readonly currentState: SessionState,
+    public readonly operation: string
+  ) {
+    super(`Cannot ${operation} in state ${currentState}`);
+    this.name = "SessionIllegalStateError";
+  }
+}
+
+/**
+ * Thrown when a bad message is received from the server.
+ */
+export class BadMessageError extends SessionError {
+  constructor(message: string) {
+    super(message);
+    this.name = "BadMessageError";
+  }
+}
+
+/**
+ * Thrown when the message queue is full and cannot accept more messages.
+ */
+export class MessageQueueFullError extends SessionError {
+  constructor() {
+    super("Message queue is full");
+    this.name = "MessageQueueFullError";
+  }
+}
+
+/**
+ * Thrown when a connection attempt times out.
+ */
+export class ConnectionTimeoutError extends SessionError {
+  constructor(timeoutMs: number) {
+    super(`Connection timed out after ${timeoutMs}ms`);
+    this.name = "ConnectionTimeoutError";
+  }
+}
+
+/**
+ * Thrown when a response is not received within the expected timeout.
+ */
+export class ResponseTimeoutError extends SessionError {
+  constructor(timeoutMs: number) {
+    super(`Response timed out after ${timeoutMs}ms`);
+    this.name = "ResponseTimeoutError";
+  }
+}

package/src/index.ts

@@ -1,147 +1,147 @@
-/**
- * @hla4ts/session - HLA 4 Federate Protocol Session Layer
- *
- * This package provides session management for the HLA 4 Federate Protocol,
- * including connection establishment, state machine, heartbeats, and reconnection.
- *
- * @example
- * ```ts
- * import { Session, SessionState } from '@hla4ts/session';
- * import { TlsTransport } from '@hla4ts/transport';
- *
- * // Create transport and session
- * const transport = new TlsTransport({
- *   host: 'rti.example.com',
- *   port: 15165,
- * });
- *
- * const session = new Session(transport, {
- *   connectionTimeout: 30000,
- *   responseTimeout: 180000,
- * });
- *
- * // Listen for state changes
- * session.addStateListener({
- *   onStateTransition: (oldState, newState, reason) => {
- *     console.log(`Session: ${oldState} -> ${newState} (${reason})`);
- *     if (newState === SessionState.DROPPED) {
- *       // Attempt to resume
- *       session.resume().catch(console.error);
- *     }
- *   }
- * });
- *
- * // Start the session
- * await session.start({
- *   onHlaCallbackRequest: (seqNum, callbackData) => {
- *     // Handle RTI callback
- *     const response = processCallback(callbackData);
- *     session.sendHlaCallbackResponse(seqNum, response);
- *   }
- * });
- *
- * // Send HLA calls
- * const response = await session.sendHlaCallRequest(encodedCall);
- *
- * // Clean up
- * await session.terminate();
- * ```
- *
- * @packageDocumentation
- */
-
-// =============================================================================
-// Session
-// =============================================================================
-export { Session } from "./session.ts";
-
-// =============================================================================
-// Types
-// =============================================================================
-export {
-  // State machine
-  SessionState,
-  VALID_TRANSITIONS,
-  isValidTransition,
-  isOperationalState,
-
-  // Options
-  type SessionOptions,
-  DEFAULT_SESSION_OPTIONS,
-
-  // Callbacks
-  type HlaCallbackRequestListener,
-  type SessionStateListener,
-  type MessageSentListener,
-
-  // Stats
-  type SessionStats,
-} from "./types.ts";
-
-// =============================================================================
-// Errors
-// =============================================================================
-export {
-  SessionError,
-  SessionLostError,
-  SessionAlreadyTerminatedError,
-  SessionIllegalStateError,
-  BadMessageError,
-  MessageQueueFullError,
-  ConnectionTimeoutError,
-  ResponseTimeoutError,
-} from "./errors.ts";
-
-// =============================================================================
-// Sequence Numbers
-// =============================================================================
-export {
-  // Constants
-  NO_SEQUENCE_NUMBER,
-  INITIAL_SEQUENCE_NUMBER,
-  MAX_SEQUENCE_NUMBER,
-
-  // Functions
-  isValidSequenceNumber,
-  nextSequenceNumber,
-  addSequenceNumbers,
-  isInInterval,
-
-  // Classes
-  SequenceNumber,
-  AtomicSequenceNumber,
-} from "./sequence-number.ts";
-
-// =============================================================================
-// Timers
-// =============================================================================
-export { TimeoutTimer, OneShotTimer } from "./timeout-timer.ts";
-
-// =============================================================================
-// Messages (for advanced use)
-// =============================================================================
-export {
-  // Session control messages
-  createNewSessionMessage,
-  decodeNewSessionStatus,
-  createResumeRequestMessage,
-  decodeResumeStatus,
-  ResumeStatusCode,
-  createHeartbeatMessage,
-  decodeHeartbeatResponse,
-  createTerminateSessionMessage,
-
-  // HLA messages
-  createHlaCallRequestMessage,
-  decodeHlaCallResponse,
-  decodeHlaCallbackRequest,
-  createHlaCallbackResponseMessage,
-
-  // Types
-  type ResumeStatusResult,
-  type HlaCallResponseResult,
-  type HlaCallbackRequestResult,
-
-  // Utilities
-  describeHeader,
-} from "./messages.ts";
+/**
+ * @hla4ts/session - HLA 4 Federate Protocol Session Layer
+ *
+ * This package provides session management for the HLA 4 Federate Protocol,
+ * including connection establishment, state machine, heartbeats, and reconnection.
+ *
+ * @example
+ * ```ts
+ * import { Session, SessionState } from '@hla4ts/session';
+ * import { TlsTransport } from '@hla4ts/transport';
+ *
+ * // Create transport and session
+ * const transport = new TlsTransport({
+ *   host: 'rti.example.com',
+ *   port: 15165,
+ * });
+ *
+ * const session = new Session(transport, {
+ *   connectionTimeout: 30000,
+ *   responseTimeout: 180000,
+ * });
+ *
+ * // Listen for state changes
+ * session.addStateListener({
+ *   onStateTransition: (oldState, newState, reason) => {
+ *     console.log(`Session: ${oldState} -> ${newState} (${reason})`);
+ *     if (newState === SessionState.DROPPED) {
+ *       // Attempt to resume
+ *       session.resume().catch(console.error);
+ *     }
+ *   }
+ * });
+ *
+ * // Start the session
+ * await session.start({
+ *   onHlaCallbackRequest: (seqNum, callbackData) => {
+ *     // Handle RTI callback
+ *     const response = processCallback(callbackData);
+ *     session.sendHlaCallbackResponse(seqNum, response);
+ *   }
+ * });
+ *
+ * // Send HLA calls
+ * const response = await session.sendHlaCallRequest(encodedCall);
+ *
+ * // Clean up
+ * await session.terminate();
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+// =============================================================================
+// Session
+// =============================================================================
+export { Session } from "./session.ts";
+
+// =============================================================================
+// Types
+// =============================================================================
+export {
+  // State machine
+  SessionState,
+  VALID_TRANSITIONS,
+  isValidTransition,
+  isOperationalState,
+
+  // Options
+  type SessionOptions,
+  DEFAULT_SESSION_OPTIONS,
+
+  // Callbacks
+  type HlaCallbackRequestListener,
+  type SessionStateListener,
+  type MessageSentListener,
+
+  // Stats
+  type SessionStats,
+} from "./types.ts";
+
+// =============================================================================
+// Errors
+// =============================================================================
+export {
+  SessionError,
+  SessionLostError,
+  SessionAlreadyTerminatedError,
+  SessionIllegalStateError,
+  BadMessageError,
+  MessageQueueFullError,
+  ConnectionTimeoutError,
+  ResponseTimeoutError,
+} from "./errors.ts";
+
+// =============================================================================
+// Sequence Numbers
+// =============================================================================
+export {
+  // Constants
+  NO_SEQUENCE_NUMBER,
+  INITIAL_SEQUENCE_NUMBER,
+  MAX_SEQUENCE_NUMBER,
+
+  // Functions
+  isValidSequenceNumber,
+  nextSequenceNumber,
+  addSequenceNumbers,
+  isInInterval,
+
+  // Classes
+  SequenceNumber,
+  AtomicSequenceNumber,
+} from "./sequence-number.ts";
+
+// =============================================================================
+// Timers
+// =============================================================================
+export { TimeoutTimer, OneShotTimer } from "./timeout-timer.ts";
+
+// =============================================================================
+// Messages (for advanced use)
+// =============================================================================
+export {
+  // Session control messages
+  createNewSessionMessage,
+  decodeNewSessionStatus,
+  createResumeRequestMessage,
+  decodeResumeStatus,
+  ResumeStatusCode,
+  createHeartbeatMessage,
+  decodeHeartbeatResponse,
+  createTerminateSessionMessage,
+
+  // HLA messages
+  createHlaCallRequestMessage,
+  decodeHlaCallResponse,
+  decodeHlaCallbackRequest,
+  createHlaCallbackResponseMessage,
+
+  // Types
+  type ResumeStatusResult,
+  type HlaCallResponseResult,
+  type HlaCallbackRequestResult,
+
+  // Utilities
+  describeHeader,
+} from "./messages.ts";