opcjs-client 0.1.18-alpha → 0.1.26-alpha

package/dist/index.cjs

@@ -3,11 +3,38 @@
 var opcjsBase = require('opcjs-base');
 
 // src/client.ts
+var SessionInvalidError = class extends Error {
+  statusCode;
+  constructor(statusCode) {
+    super(`Session is no longer valid: ${opcjsBase.StatusCodeToString(statusCode)} (0x${statusCode.toString(16).toUpperCase()})`);
+    this.name = "SessionInvalidError";
+    this.statusCode = statusCode;
+  }
+};
+
+// src/services/serviceBase.ts
 var ServiceBase = class {
   constructor(authToken, secureChannel) {
     this.authToken = authToken;
     this.secureChannel = secureChannel;
   }
+  /**
+   * Validates the `serviceResult` value from a response header.
+   *
+   * Throws `SessionInvalidError` for session-related status codes so callers
+   * can detect a dropped session and act accordingly (e.g. reconnect).
+   * Throws a generic `Error` for all other non-Good codes.
+   *
+   * @param result  - The `serviceResult` value from the response header.
+   * @param context - Short description used in the error message (e.g. "ReadRequest").
+   */
+  checkServiceResult(result, context) {
+    if (result === void 0 || result === opcjsBase.StatusCode.Good) return;
+    if (result === opcjsBase.StatusCode.BadSessionIdInvalid || result === opcjsBase.StatusCode.BadSessionClosed) {
+      throw new SessionInvalidError(result);
+    }
+    throw new Error(`${context} failed: ${opcjsBase.StatusCodeToString(result)} (${opcjsBase.StatusCodeToStringNumber(result)})`);
+  }
   createRequestHeader() {
     const requestHeader = new opcjsBase.RequestHeader();
     requestHeader.authenticationToken = this.authToken;
@@ -28,6 +55,10 @@ var SessionService = class _SessionService extends ServiceBase {
     this.configuration = configuration;
   }
   logger = opcjsBase.getLogger("services.SessionService");
+  /**
+   * Creates a new session on the server (OPC UA Part 4, Section 5.7.2).
+   * @returns The session ID, authentication token, and selected server endpoint.
+   */
   async createSession() {
     this.logger.debug("Creating session...");
     const clientDescription = new opcjsBase.ApplicationDescription();
@@ -57,6 +88,10 @@ var SessionService = class _SessionService extends ServiceBase {
     if (!castedResponse || !castedResponse.sessionId || !castedResponse.authenticationToken) {
       throw new Error("CreateSessionResponse missing SessionId or AuthenticationToken");
     }
+    const serviceResult = castedResponse.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`CreateSessionRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)}`);
+    }
     const endpoint = "opc." + this.secureChannel.getEndpointUrl();
     const endpointUrl = new URL(endpoint);
     const securityMode = this.secureChannel.getSecurityMode();
@@ -75,6 +110,10 @@ var SessionService = class _SessionService extends ServiceBase {
       endpoint: serverEndpoint
     };
   }
+  /**
+   * Activates an existing session using the supplied identity token (OPC UA Part 4, Section 5.7.3).
+   * @param identityToken - User identity token (anonymous, username/password, certificate, or issued token).
+   */
   async activateSession(identityToken) {
     const signatureData = new opcjsBase.SignatureData();
     signatureData.algorithm = this.secureChannel.getSecurityPolicy();
@@ -87,7 +126,11 @@ var SessionService = class _SessionService extends ServiceBase {
     request.userIdentityToken = opcjsBase.ExtensionObject.newBinary(identityToken);
     request.userTokenSignature = signatureData;
     this.logger.debug("Sending ActivateSessionRequest...");
-    await this.secureChannel.issueServiceRequest(request);
+    const activateResponse = await this.secureChannel.issueServiceRequest(request);
+    const activateResult = activateResponse?.responseHeader?.serviceResult;
+    if (activateResult !== void 0 && activateResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`ActivateSessionRequest failed: ${opcjsBase.StatusCodeToString(activateResult)}`);
+    }
     this.logger.debug("Session activated.");
   }
   recreate(authToken) {
@@ -171,268 +214,17 @@ var SessionHandler = class {
 // src/services/attributeServiceAttributes.ts
 var AttrIdValue = 13;
 
-// ../base/src/types/statusCode.ts
-function StatusCodeToString(statusCode) {
-  if (statusCode === void 0) {
-    return "Unknown";
-  }
-  const name = Object.entries(StatusCode).find(([, v]) => v === statusCode)?.[0];
-  return name ?? `0x${statusCode.toString(16).toUpperCase().padStart(8, "0")}`;
-}
-var StatusCode = /* @__PURE__ */ ((StatusCode2) => {
-  StatusCode2[StatusCode2["Good"] = 0] = "Good";
-  StatusCode2[StatusCode2["Uncertain"] = 1073741824] = "Uncertain";
-  StatusCode2[StatusCode2["Bad"] = 2147483648] = "Bad";
-  StatusCode2[StatusCode2["BadUnexpectedError"] = 2147549184] = "BadUnexpectedError";
-  StatusCode2[StatusCode2["BadInternalError"] = 2147614720] = "BadInternalError";
-  StatusCode2[StatusCode2["BadOutOfMemory"] = 2147680256] = "BadOutOfMemory";
-  StatusCode2[StatusCode2["BadResourceUnavailable"] = 2147745792] = "BadResourceUnavailable";
-  StatusCode2[StatusCode2["BadCommunicationError"] = 2147811328] = "BadCommunicationError";
-  StatusCode2[StatusCode2["BadEncodingError"] = 2147876864] = "BadEncodingError";
-  StatusCode2[StatusCode2["BadDecodingError"] = 2147942400] = "BadDecodingError";
-  StatusCode2[StatusCode2["BadEncodingLimitsExceeded"] = 2148007936] = "BadEncodingLimitsExceeded";
-  StatusCode2[StatusCode2["BadRequestTooLarge"] = 2159542272] = "BadRequestTooLarge";
-  StatusCode2[StatusCode2["BadResponseTooLarge"] = 2159607808] = "BadResponseTooLarge";
-  StatusCode2[StatusCode2["BadUnknownResponse"] = 2148073472] = "BadUnknownResponse";
-  StatusCode2[StatusCode2["BadTimeout"] = 2148139008] = "BadTimeout";
-  StatusCode2[StatusCode2["BadServiceUnsupported"] = 2148204544] = "BadServiceUnsupported";
-  StatusCode2[StatusCode2["BadShutdown"] = 2148270080] = "BadShutdown";
-  StatusCode2[StatusCode2["BadServerNotConnected"] = 2148335616] = "BadServerNotConnected";
-  StatusCode2[StatusCode2["BadServerHalted"] = 2148401152] = "BadServerHalted";
-  StatusCode2[StatusCode2["BadNothingToDo"] = 2148466688] = "BadNothingToDo";
-  StatusCode2[StatusCode2["BadTooManyOperations"] = 2148532224] = "BadTooManyOperations";
-  StatusCode2[StatusCode2["BadTooManyMonitoredItems"] = 2161836032] = "BadTooManyMonitoredItems";
-  StatusCode2[StatusCode2["BadDataTypeIdUnknown"] = 2148597760] = "BadDataTypeIdUnknown";
-  StatusCode2[StatusCode2["BadCertificateInvalid"] = 2148663296] = "BadCertificateInvalid";
-  StatusCode2[StatusCode2["BadSecurityChecksFailed"] = 2148728832] = "BadSecurityChecksFailed";
-  StatusCode2[StatusCode2["BadCertificatePolicyCheckFailed"] = 2165571584] = "BadCertificatePolicyCheckFailed";
-  StatusCode2[StatusCode2["BadCertificateTimeInvalid"] = 2148794368] = "BadCertificateTimeInvalid";
-  StatusCode2[StatusCode2["BadCertificateIssuerTimeInvalid"] = 2148859904] = "BadCertificateIssuerTimeInvalid";
-  StatusCode2[StatusCode2["BadCertificateHostNameInvalid"] = 2148925440] = "BadCertificateHostNameInvalid";
-  StatusCode2[StatusCode2["BadCertificateUriInvalid"] = 2148990976] = "BadCertificateUriInvalid";
-  StatusCode2[StatusCode2["BadCertificateUseNotAllowed"] = 2149056512] = "BadCertificateUseNotAllowed";
-  StatusCode2[StatusCode2["BadCertificateIssuerUseNotAllowed"] = 2149122048] = "BadCertificateIssuerUseNotAllowed";
-  StatusCode2[StatusCode2["BadCertificateUntrusted"] = 2149187584] = "BadCertificateUntrusted";
-  StatusCode2[StatusCode2["BadCertificateRevocationUnknown"] = 2149253120] = "BadCertificateRevocationUnknown";
-  StatusCode2[StatusCode2["BadCertificateIssuerRevocationUnknown"] = 2149318656] = "BadCertificateIssuerRevocationUnknown";
-  StatusCode2[StatusCode2["BadCertificateRevoked"] = 2149384192] = "BadCertificateRevoked";
-  StatusCode2[StatusCode2["BadCertificateIssuerRevoked"] = 2149449728] = "BadCertificateIssuerRevoked";
-  StatusCode2[StatusCode2["BadCertificateChainIncomplete"] = 2165112832] = "BadCertificateChainIncomplete";
-  StatusCode2[StatusCode2["BadUserAccessDenied"] = 2149515264] = "BadUserAccessDenied";
-  StatusCode2[StatusCode2["BadIdentityTokenInvalid"] = 2149580800] = "BadIdentityTokenInvalid";
-  StatusCode2[StatusCode2["BadIdentityTokenRejected"] = 2149646336] = "BadIdentityTokenRejected";
-  StatusCode2[StatusCode2["BadSecureChannelIdInvalid"] = 2149711872] = "BadSecureChannelIdInvalid";
-  StatusCode2[StatusCode2["BadInvalidTimestamp"] = 2149777408] = "BadInvalidTimestamp";
-  StatusCode2[StatusCode2["BadNonceInvalid"] = 2149842944] = "BadNonceInvalid";
-  StatusCode2[StatusCode2["BadSessionIdInvalid"] = 2149908480] = "BadSessionIdInvalid";
-  StatusCode2[StatusCode2["BadSessionClosed"] = 2149974016] = "BadSessionClosed";
-  StatusCode2[StatusCode2["BadSessionNotActivated"] = 2150039552] = "BadSessionNotActivated";
-  StatusCode2[StatusCode2["BadSubscriptionIdInvalid"] = 2150105088] = "BadSubscriptionIdInvalid";
-  StatusCode2[StatusCode2["BadRequestHeaderInvalid"] = 2150236160] = "BadRequestHeaderInvalid";
-  StatusCode2[StatusCode2["BadTimestampsToReturnInvalid"] = 2150301696] = "BadTimestampsToReturnInvalid";
-  StatusCode2[StatusCode2["BadRequestCancelledByClient"] = 2150367232] = "BadRequestCancelledByClient";
-  StatusCode2[StatusCode2["BadTooManyArguments"] = 2162491392] = "BadTooManyArguments";
-  StatusCode2[StatusCode2["BadLicenseExpired"] = 2165178368] = "BadLicenseExpired";
-  StatusCode2[StatusCode2["BadLicenseLimitsExceeded"] = 2165243904] = "BadLicenseLimitsExceeded";
-  StatusCode2[StatusCode2["BadLicenseNotAvailable"] = 2165309440] = "BadLicenseNotAvailable";
-  StatusCode2[StatusCode2["GoodSubscriptionTransferred"] = 2949120] = "GoodSubscriptionTransferred";
-  StatusCode2[StatusCode2["GoodCompletesAsynchronously"] = 3014656] = "GoodCompletesAsynchronously";
-  StatusCode2[StatusCode2["GoodOverload"] = 3080192] = "GoodOverload";
-  StatusCode2[StatusCode2["GoodClamped"] = 3145728] = "GoodClamped";
-  StatusCode2[StatusCode2["BadNoCommunication"] = 2150694912] = "BadNoCommunication";
-  StatusCode2[StatusCode2["BadWaitingForInitialData"] = 2150760448] = "BadWaitingForInitialData";
-  StatusCode2[StatusCode2["BadNodeIdInvalid"] = 2150825984] = "BadNodeIdInvalid";
-  StatusCode2[StatusCode2["BadNodeIdUnknown"] = 2150891520] = "BadNodeIdUnknown";
-  StatusCode2[StatusCode2["BadAttributeIdInvalid"] = 2150957056] = "BadAttributeIdInvalid";
-  StatusCode2[StatusCode2["BadIndexRangeInvalid"] = 2151022592] = "BadIndexRangeInvalid";
-  StatusCode2[StatusCode2["BadIndexRangeNoData"] = 2151088128] = "BadIndexRangeNoData";
-  StatusCode2[StatusCode2["BadDataEncodingInvalid"] = 2151153664] = "BadDataEncodingInvalid";
-  StatusCode2[StatusCode2["BadDataEncodingUnsupported"] = 2151219200] = "BadDataEncodingUnsupported";
-  StatusCode2[StatusCode2["BadNotReadable"] = 2151284736] = "BadNotReadable";
-  StatusCode2[StatusCode2["BadNotWritable"] = 2151350272] = "BadNotWritable";
-  StatusCode2[StatusCode2["BadOutOfRange"] = 2151415808] = "BadOutOfRange";
-  StatusCode2[StatusCode2["BadNotSupported"] = 2151481344] = "BadNotSupported";
-  StatusCode2[StatusCode2["BadNotFound"] = 2151546880] = "BadNotFound";
-  StatusCode2[StatusCode2["BadObjectDeleted"] = 2151612416] = "BadObjectDeleted";
-  StatusCode2[StatusCode2["BadNotImplemented"] = 2151677952] = "BadNotImplemented";
-  StatusCode2[StatusCode2["BadMonitoringModeInvalid"] = 2151743488] = "BadMonitoringModeInvalid";
-  StatusCode2[StatusCode2["BadMonitoredItemIdInvalid"] = 2151809024] = "BadMonitoredItemIdInvalid";
-  StatusCode2[StatusCode2["BadMonitoredItemFilterInvalid"] = 2151874560] = "BadMonitoredItemFilterInvalid";
-  StatusCode2[StatusCode2["BadMonitoredItemFilterUnsupported"] = 2151940096] = "BadMonitoredItemFilterUnsupported";
-  StatusCode2[StatusCode2["BadFilterNotAllowed"] = 2152005632] = "BadFilterNotAllowed";
-  StatusCode2[StatusCode2["BadStructureMissing"] = 2152071168] = "BadStructureMissing";
-  StatusCode2[StatusCode2["BadEventFilterInvalid"] = 2152136704] = "BadEventFilterInvalid";
-  StatusCode2[StatusCode2["BadContentFilterInvalid"] = 2152202240] = "BadContentFilterInvalid";
-  StatusCode2[StatusCode2["BadFilterOperatorInvalid"] = 2160132096] = "BadFilterOperatorInvalid";
-  StatusCode2[StatusCode2["BadFilterOperatorUnsupported"] = 2160197632] = "BadFilterOperatorUnsupported";
-  StatusCode2[StatusCode2["BadFilterOperandCountMismatch"] = 2160263168] = "BadFilterOperandCountMismatch";
-  StatusCode2[StatusCode2["BadFilterOperandInvalid"] = 2152267776] = "BadFilterOperandInvalid";
-  StatusCode2[StatusCode2["BadFilterElementInvalid"] = 2160328704] = "BadFilterElementInvalid";
-  StatusCode2[StatusCode2["BadFilterLiteralInvalid"] = 2160394240] = "BadFilterLiteralInvalid";
-  StatusCode2[StatusCode2["BadContinuationPointInvalid"] = 2152333312] = "BadContinuationPointInvalid";
-  StatusCode2[StatusCode2["BadNoContinuationPoints"] = 2152398848] = "BadNoContinuationPoints";
-  StatusCode2[StatusCode2["BadReferenceTypeIdInvalid"] = 2152464384] = "BadReferenceTypeIdInvalid";
-  StatusCode2[StatusCode2["BadBrowseDirectionInvalid"] = 2152529920] = "BadBrowseDirectionInvalid";
-  StatusCode2[StatusCode2["BadNodeNotInView"] = 2152595456] = "BadNodeNotInView";
-  StatusCode2[StatusCode2["BadNumericOverflow"] = 2165440512] = "BadNumericOverflow";
-  StatusCode2[StatusCode2["BadServerUriInvalid"] = 2152660992] = "BadServerUriInvalid";
-  StatusCode2[StatusCode2["BadServerNameMissing"] = 2152726528] = "BadServerNameMissing";
-  StatusCode2[StatusCode2["BadDiscoveryUrlMissing"] = 2152792064] = "BadDiscoveryUrlMissing";
-  StatusCode2[StatusCode2["BadSempahoreFileMissing"] = 2152857600] = "BadSempahoreFileMissing";
-  StatusCode2[StatusCode2["BadRequestTypeInvalid"] = 2152923136] = "BadRequestTypeInvalid";
-  StatusCode2[StatusCode2["BadSecurityModeRejected"] = 2152988672] = "BadSecurityModeRejected";
-  StatusCode2[StatusCode2["BadSecurityPolicyRejected"] = 2153054208] = "BadSecurityPolicyRejected";
-  StatusCode2[StatusCode2["BadTooManySessions"] = 2153119744] = "BadTooManySessions";
-  StatusCode2[StatusCode2["BadUserSignatureInvalid"] = 2153185280] = "BadUserSignatureInvalid";
-  StatusCode2[StatusCode2["BadApplicationSignatureInvalid"] = 2153250816] = "BadApplicationSignatureInvalid";
-  StatusCode2[StatusCode2["BadNoValidCertificates"] = 2153316352] = "BadNoValidCertificates";
-  StatusCode2[StatusCode2["BadIdentityChangeNotSupported"] = 2160459776] = "BadIdentityChangeNotSupported";
-  StatusCode2[StatusCode2["BadRequestCancelledByRequest"] = 2153381888] = "BadRequestCancelledByRequest";
-  StatusCode2[StatusCode2["BadParentNodeIdInvalid"] = 2153447424] = "BadParentNodeIdInvalid";
-  StatusCode2[StatusCode2["BadReferenceNotAllowed"] = 2153512960] = "BadReferenceNotAllowed";
-  StatusCode2[StatusCode2["BadNodeIdRejected"] = 2153578496] = "BadNodeIdRejected";
-  StatusCode2[StatusCode2["BadNodeIdExists"] = 2153644032] = "BadNodeIdExists";
-  StatusCode2[StatusCode2["BadNodeClassInvalid"] = 2153709568] = "BadNodeClassInvalid";
-  StatusCode2[StatusCode2["BadBrowseNameInvalid"] = 2153775104] = "BadBrowseNameInvalid";
-  StatusCode2[StatusCode2["BadBrowseNameDuplicated"] = 2153840640] = "BadBrowseNameDuplicated";
-  StatusCode2[StatusCode2["BadNodeAttributesInvalid"] = 2153906176] = "BadNodeAttributesInvalid";
-  StatusCode2[StatusCode2["BadTypeDefinitionInvalid"] = 2153971712] = "BadTypeDefinitionInvalid";
-  StatusCode2[StatusCode2["BadSourceNodeIdInvalid"] = 2154037248] = "BadSourceNodeIdInvalid";
-  StatusCode2[StatusCode2["BadTargetNodeIdInvalid"] = 2154102784] = "BadTargetNodeIdInvalid";
-  StatusCode2[StatusCode2["BadDuplicateReferenceNotAllowed"] = 2154168320] = "BadDuplicateReferenceNotAllowed";
-  StatusCode2[StatusCode2["BadInvalidSelfReference"] = 2154233856] = "BadInvalidSelfReference";
-  StatusCode2[StatusCode2["BadReferenceLocalOnly"] = 2154299392] = "BadReferenceLocalOnly";
-  StatusCode2[StatusCode2["BadNoDeleteRights"] = 2154364928] = "BadNoDeleteRights";
-  StatusCode2[StatusCode2["UncertainReferenceNotDeleted"] = 1086062592] = "UncertainReferenceNotDeleted";
-  StatusCode2[StatusCode2["BadServerIndexInvalid"] = 2154430464] = "BadServerIndexInvalid";
-  StatusCode2[StatusCode2["BadViewIdUnknown"] = 2154496e3] = "BadViewIdUnknown";
-  StatusCode2[StatusCode2["BadViewTimestampInvalid"] = 2160656384] = "BadViewTimestampInvalid";
-  StatusCode2[StatusCode2["BadViewParameterMismatch"] = 2160721920] = "BadViewParameterMismatch";
-  StatusCode2[StatusCode2["BadViewVersionInvalid"] = 2160787456] = "BadViewVersionInvalid";
-  StatusCode2[StatusCode2["UncertainNotAllNodesAvailable"] = 1086324736] = "UncertainNotAllNodesAvailable";
-  StatusCode2[StatusCode2["GoodResultsMayBeIncomplete"] = 12189696] = "GoodResultsMayBeIncomplete";
-  StatusCode2[StatusCode2["BadNotTypeDefinition"] = 2160590848] = "BadNotTypeDefinition";
-  StatusCode2[StatusCode2["UncertainReferenceOutOfServer"] = 1080819712] = "UncertainReferenceOutOfServer";
-  StatusCode2[StatusCode2["BadTooManyMatches"] = 2154627072] = "BadTooManyMatches";
-  StatusCode2[StatusCode2["BadQueryTooComplex"] = 2154692608] = "BadQueryTooComplex";
-  StatusCode2[StatusCode2["BadNoMatch"] = 2154758144] = "BadNoMatch";
-  StatusCode2[StatusCode2["BadMaxAgeInvalid"] = 2154823680] = "BadMaxAgeInvalid";
-  StatusCode2[StatusCode2["BadSecurityModeInsufficient"] = 2162556928] = "BadSecurityModeInsufficient";
-  StatusCode2[StatusCode2["BadHistoryOperationInvalid"] = 2154889216] = "BadHistoryOperationInvalid";
-  StatusCode2[StatusCode2["BadHistoryOperationUnsupported"] = 2154954752] = "BadHistoryOperationUnsupported";
-  StatusCode2[StatusCode2["BadInvalidTimestampArgument"] = 2159869952] = "BadInvalidTimestampArgument";
-  StatusCode2[StatusCode2["BadWriteNotSupported"] = 2155020288] = "BadWriteNotSupported";
-  StatusCode2[StatusCode2["BadTypeMismatch"] = 2155085824] = "BadTypeMismatch";
-  StatusCode2[StatusCode2["BadMethodInvalid"] = 2155151360] = "BadMethodInvalid";
-  StatusCode2[StatusCode2["BadArgumentsMissing"] = 2155216896] = "BadArgumentsMissing";
-  StatusCode2[StatusCode2["BadNotExecutable"] = 2165374976] = "BadNotExecutable";
-  StatusCode2[StatusCode2["BadTooManySubscriptions"] = 2155282432] = "BadTooManySubscriptions";
-  StatusCode2[StatusCode2["BadTooManyPublishRequests"] = 2155347968] = "BadTooManyPublishRequests";
-  StatusCode2[StatusCode2["BadNoSubscription"] = 2155413504] = "BadNoSubscription";
-  StatusCode2[StatusCode2["BadSequenceNumberUnknown"] = 2155479040] = "BadSequenceNumberUnknown";
-  StatusCode2[StatusCode2["BadMessageNotAvailable"] = 2155544576] = "BadMessageNotAvailable";
-  StatusCode2[StatusCode2["BadInsufficientClientProfile"] = 2155610112] = "BadInsufficientClientProfile";
-  StatusCode2[StatusCode2["BadStateNotActive"] = 2160001024] = "BadStateNotActive";
-  StatusCode2[StatusCode2["BadAlreadyExists"] = 2165637120] = "BadAlreadyExists";
-  StatusCode2[StatusCode2["BadTcpServerTooBusy"] = 2155675648] = "BadTcpServerTooBusy";
-  StatusCode2[StatusCode2["BadTcpMessageTypeInvalid"] = 2155741184] = "BadTcpMessageTypeInvalid";
-  StatusCode2[StatusCode2["BadTcpSecureChannelUnknown"] = 2155806720] = "BadTcpSecureChannelUnknown";
-  StatusCode2[StatusCode2["BadTcpMessageTooLarge"] = 2155872256] = "BadTcpMessageTooLarge";
-  StatusCode2[StatusCode2["BadTcpNotEnoughResources"] = 2155937792] = "BadTcpNotEnoughResources";
-  StatusCode2[StatusCode2["BadTcpInternalError"] = 2156003328] = "BadTcpInternalError";
-  StatusCode2[StatusCode2["BadTcpEndpointUrlInvalid"] = 2156068864] = "BadTcpEndpointUrlInvalid";
-  StatusCode2[StatusCode2["BadRequestInterrupted"] = 2156134400] = "BadRequestInterrupted";
-  StatusCode2[StatusCode2["BadRequestTimeout"] = 2156199936] = "BadRequestTimeout";
-  StatusCode2[StatusCode2["BadSecureChannelClosed"] = 2156265472] = "BadSecureChannelClosed";
-  StatusCode2[StatusCode2["BadSecureChannelTokenUnknown"] = 2156331008] = "BadSecureChannelTokenUnknown";
-  StatusCode2[StatusCode2["BadSequenceNumberInvalid"] = 2156396544] = "BadSequenceNumberInvalid";
-  StatusCode2[StatusCode2["BadProtocolVersionUnsupported"] = 2159935488] = "BadProtocolVersionUnsupported";
-  StatusCode2[StatusCode2["BadConfigurationError"] = 2156462080] = "BadConfigurationError";
-  StatusCode2[StatusCode2["BadNotConnected"] = 2156527616] = "BadNotConnected";
-  StatusCode2[StatusCode2["BadDeviceFailure"] = 2156593152] = "BadDeviceFailure";
-  StatusCode2[StatusCode2["BadSensorFailure"] = 2156658688] = "BadSensorFailure";
-  StatusCode2[StatusCode2["BadOutOfService"] = 2156724224] = "BadOutOfService";
-  StatusCode2[StatusCode2["BadDeadbandFilterInvalid"] = 2156789760] = "BadDeadbandFilterInvalid";
-  StatusCode2[StatusCode2["UncertainNoCommunicationLastUsableValue"] = 1083113472] = "UncertainNoCommunicationLastUsableValue";
-  StatusCode2[StatusCode2["UncertainLastUsableValue"] = 1083179008] = "UncertainLastUsableValue";
-  StatusCode2[StatusCode2["UncertainSubstituteValue"] = 1083244544] = "UncertainSubstituteValue";
-  StatusCode2[StatusCode2["UncertainInitialValue"] = 1083310080] = "UncertainInitialValue";
-  StatusCode2[StatusCode2["UncertainSensorNotAccurate"] = 1083375616] = "UncertainSensorNotAccurate";
-  StatusCode2[StatusCode2["UncertainEngineeringUnitsExceeded"] = 1083441152] = "UncertainEngineeringUnitsExceeded";
-  StatusCode2[StatusCode2["UncertainSubNormal"] = 1083506688] = "UncertainSubNormal";
-  StatusCode2[StatusCode2["GoodLocalOverride"] = 9830400] = "GoodLocalOverride";
-  StatusCode2[StatusCode2["BadRefreshInProgress"] = 2157379584] = "BadRefreshInProgress";
-  StatusCode2[StatusCode2["BadConditionAlreadyDisabled"] = 2157445120] = "BadConditionAlreadyDisabled";
-  StatusCode2[StatusCode2["BadConditionAlreadyEnabled"] = 2160852992] = "BadConditionAlreadyEnabled";
-  StatusCode2[StatusCode2["BadConditionDisabled"] = 2157510656] = "BadConditionDisabled";
-  StatusCode2[StatusCode2["BadEventIdUnknown"] = 2157576192] = "BadEventIdUnknown";
-  StatusCode2[StatusCode2["BadEventNotAcknowledgeable"] = 2159738880] = "BadEventNotAcknowledgeable";
-  StatusCode2[StatusCode2["BadDialogNotActive"] = 2160918528] = "BadDialogNotActive";
-  StatusCode2[StatusCode2["BadDialogResponseInvalid"] = 2160984064] = "BadDialogResponseInvalid";
-  StatusCode2[StatusCode2["BadConditionBranchAlreadyAcked"] = 2161049600] = "BadConditionBranchAlreadyAcked";
-  StatusCode2[StatusCode2["BadConditionBranchAlreadyConfirmed"] = 2161115136] = "BadConditionBranchAlreadyConfirmed";
-  StatusCode2[StatusCode2["BadConditionAlreadyShelved"] = 2161180672] = "BadConditionAlreadyShelved";
-  StatusCode2[StatusCode2["BadConditionNotShelved"] = 2161246208] = "BadConditionNotShelved";
-  StatusCode2[StatusCode2["BadShelvingTimeOutOfRange"] = 2161311744] = "BadShelvingTimeOutOfRange";
-  StatusCode2[StatusCode2["BadNoData"] = 2157641728] = "BadNoData";
-  StatusCode2[StatusCode2["BadBoundNotFound"] = 2161573888] = "BadBoundNotFound";
-  StatusCode2[StatusCode2["BadBoundNotSupported"] = 2161639424] = "BadBoundNotSupported";
-  StatusCode2[StatusCode2["BadDataLost"] = 2157772800] = "BadDataLost";
-  StatusCode2[StatusCode2["BadDataUnavailable"] = 2157838336] = "BadDataUnavailable";
-  StatusCode2[StatusCode2["BadEntryExists"] = 2157903872] = "BadEntryExists";
-  StatusCode2[StatusCode2["BadNoEntryExists"] = 2157969408] = "BadNoEntryExists";
-  StatusCode2[StatusCode2["BadTimestampNotSupported"] = 2158034944] = "BadTimestampNotSupported";
-  StatusCode2[StatusCode2["GoodEntryInserted"] = 10616832] = "GoodEntryInserted";
-  StatusCode2[StatusCode2["GoodEntryReplaced"] = 10682368] = "GoodEntryReplaced";
-  StatusCode2[StatusCode2["UncertainDataSubNormal"] = 1084489728] = "UncertainDataSubNormal";
-  StatusCode2[StatusCode2["GoodNoData"] = 10813440] = "GoodNoData";
-  StatusCode2[StatusCode2["GoodMoreData"] = 10878976] = "GoodMoreData";
-  StatusCode2[StatusCode2["BadAggregateListMismatch"] = 2161377280] = "BadAggregateListMismatch";
-  StatusCode2[StatusCode2["BadAggregateNotSupported"] = 2161442816] = "BadAggregateNotSupported";
-  StatusCode2[StatusCode2["BadAggregateInvalidInputs"] = 2161508352] = "BadAggregateInvalidInputs";
-  StatusCode2[StatusCode2["BadAggregateConfigurationRejected"] = 2161770496] = "BadAggregateConfigurationRejected";
-  StatusCode2[StatusCode2["GoodDataIgnored"] = 14221312] = "GoodDataIgnored";
-  StatusCode2[StatusCode2["BadRequestNotAllowed"] = 2162425856] = "BadRequestNotAllowed";
-  StatusCode2[StatusCode2["BadRequestNotComplete"] = 2165506048] = "BadRequestNotComplete";
-  StatusCode2[StatusCode2["GoodEdited"] = 14417920] = "GoodEdited";
-  StatusCode2[StatusCode2["GoodPostActionFailed"] = 14483456] = "GoodPostActionFailed";
-  StatusCode2[StatusCode2["UncertainDominantValueChanged"] = 1088290816] = "UncertainDominantValueChanged";
-  StatusCode2[StatusCode2["GoodDependentValueChanged"] = 14680064] = "GoodDependentValueChanged";
-  StatusCode2[StatusCode2["BadDominantValueChanged"] = 2162229248] = "BadDominantValueChanged";
-  StatusCode2[StatusCode2["UncertainDependentValueChanged"] = 1088552960] = "UncertainDependentValueChanged";
-  StatusCode2[StatusCode2["BadDependentValueChanged"] = 2162360320] = "BadDependentValueChanged";
-  StatusCode2[StatusCode2["GoodEditedDependentValueChanged"] = 18219008] = "GoodEditedDependentValueChanged";
-  StatusCode2[StatusCode2["GoodEditedDominantValueChanged"] = 18284544] = "GoodEditedDominantValueChanged";
-  StatusCode2[StatusCode2["GoodEditedDominantValueChangedDependentValueChanged"] = 18350080] = "GoodEditedDominantValueChangedDependentValueChanged";
-  StatusCode2[StatusCode2["BadEditedOutOfRange"] = 2165899264] = "BadEditedOutOfRange";
-  StatusCode2[StatusCode2["BadInitialValueOutOfRange"] = 2165964800] = "BadInitialValueOutOfRange";
-  StatusCode2[StatusCode2["BadOutOfRangeDominantValueChanged"] = 2166030336] = "BadOutOfRangeDominantValueChanged";
-  StatusCode2[StatusCode2["BadEditedOutOfRangeDominantValueChanged"] = 2166095872] = "BadEditedOutOfRangeDominantValueChanged";
-  StatusCode2[StatusCode2["BadOutOfRangeDominantValueChangedDependentValueChanged"] = 2166161408] = "BadOutOfRangeDominantValueChangedDependentValueChanged";
-  StatusCode2[StatusCode2["BadEditedOutOfRangeDominantValueChangedDependentValueChanged"] = 2166226944] = "BadEditedOutOfRangeDominantValueChangedDependentValueChanged";
-  StatusCode2[StatusCode2["GoodCommunicationEvent"] = 10944512] = "GoodCommunicationEvent";
-  StatusCode2[StatusCode2["GoodShutdownEvent"] = 11010048] = "GoodShutdownEvent";
-  StatusCode2[StatusCode2["GoodCallAgain"] = 11075584] = "GoodCallAgain";
-  StatusCode2[StatusCode2["GoodNonCriticalTimeout"] = 11141120] = "GoodNonCriticalTimeout";
-  StatusCode2[StatusCode2["BadInvalidArgument"] = 2158690304] = "BadInvalidArgument";
-  StatusCode2[StatusCode2["BadConnectionRejected"] = 2158755840] = "BadConnectionRejected";
-  StatusCode2[StatusCode2["BadDisconnect"] = 2158821376] = "BadDisconnect";
-  StatusCode2[StatusCode2["BadConnectionClosed"] = 2158886912] = "BadConnectionClosed";
-  StatusCode2[StatusCode2["BadInvalidState"] = 2158952448] = "BadInvalidState";
-  StatusCode2[StatusCode2["BadEndOfStream"] = 2159017984] = "BadEndOfStream";
-  StatusCode2[StatusCode2["BadNoDataAvailable"] = 2159083520] = "BadNoDataAvailable";
-  StatusCode2[StatusCode2["BadWaitingForResponse"] = 2159149056] = "BadWaitingForResponse";
-  StatusCode2[StatusCode2["BadOperationAbandoned"] = 2159214592] = "BadOperationAbandoned";
-  StatusCode2[StatusCode2["BadExpectedStreamToBlock"] = 2159280128] = "BadExpectedStreamToBlock";
-  StatusCode2[StatusCode2["BadWouldBlock"] = 2159345664] = "BadWouldBlock";
-  StatusCode2[StatusCode2["BadSyntaxError"] = 2159411200] = "BadSyntaxError";
-  StatusCode2[StatusCode2["BadMaxConnectionsReached"] = 2159476736] = "BadMaxConnectionsReached";
-  return StatusCode2;
-})(StatusCode || {});
-
 // src/services/attributeService.ts
 var AttributeService = class extends ServiceBase {
-  async ReadValue(nodeIds) {
+  logger = opcjsBase.getLogger("services.AttributeService");
+  /**
+   * Reads the Value attribute of one or more Nodes (OPC UA Part 4, Section 5.10.2).
+   * @param nodeIds - NodeIds of the Nodes to read.
+   * @param maxAge - Maximum age of the cached value in milliseconds the server may return. 0 = always current value.
+   * @param timestampsToReturn - Which timestamps to include in results. Default: Source.
+   * @returns Array of results containing value and raw status code number, one per requested NodeId.
+   */
+  async ReadValue(nodeIds, maxAge = 0, timestampsToReturn = opcjsBase.TimestampsToReturnEnum.Source) {
     const readValueIds = nodeIds.map((ni) => {
       const readValueId = new opcjsBase.ReadValueId();
       readValueId.nodeId = ni;
@@ -443,18 +235,18 @@ var AttributeService = class extends ServiceBase {
     });
     const request = new opcjsBase.ReadRequest();
     request.requestHeader = this.createRequestHeader();
-    request.maxAge = 6e4;
-    request.timestampsToReturn = opcjsBase.TimestampsToReturnEnum.Source;
+    request.maxAge = maxAge;
+    request.timestampsToReturn = timestampsToReturn;
     request.nodesToRead = readValueIds;
-    console.log("Sending ReadRequest...");
+    this.logger.debug("Sending ReadRequest...");
     const response = await this.secureChannel.issueServiceRequest(request);
+    this.checkServiceResult(response.responseHeader?.serviceResult, "ReadRequest");
     const results = new Array();
     for (const dataValue of response.results ?? []) {
-      const result = {
-        status: StatusCodeToString(dataValue.statusCode),
+      results.push({
+        statusCode: dataValue.statusCode ?? opcjsBase.StatusCode.Good,
         value: dataValue.value
-      };
-      results.push(result);
+      });
     }
     return results;
   }
@@ -465,9 +257,9 @@ var AttributeService = class extends ServiceBase {
 
 // src/readValueResult.ts
 var ReadValueResult = class {
-  constructor(value, status) {
+  constructor(value, statusCode) {
     this.value = value;
-    this.status = status;
+    this.statusCode = statusCode;
   }
 };
 
@@ -482,13 +274,17 @@ var SubscriptionHandlerEntry = class {
 };
 
 // src/subscriptionHandler.ts
+var NODE_ID_DATA_CHANGE_NOTIFICATION = 811;
+var NODE_ID_STATUS_CHANGE_NOTIFICATION = 818;
 var SubscriptionHandler = class {
   constructor(subscriptionService, monitoredItemService) {
     this.subscriptionService = subscriptionService;
     this.monitoredItemService = monitoredItemService;
   }
+  logger = opcjsBase.getLogger("SubscriptionHandler");
   entries = new Array();
   nextHandle = 0;
+  isRunning = false;
   async subscribe(ids, callback) {
     if (this.entries.length > 0) {
       throw new Error("Subscribing more than once is not implemented");
@@ -496,80 +292,111 @@ var SubscriptionHandler = class {
     const subscriptionId = await this.subscriptionService.createSubscription();
     const items = [];
     for (const id of ids) {
-      const entry = new SubscriptionHandlerEntry(
-        subscriptionId,
-        this.nextHandle++,
-        id,
-        callback
-      );
+      const entry = new SubscriptionHandlerEntry(subscriptionId, this.nextHandle++, id, callback);
       this.entries.push(entry);
-      const item = {
-        id,
-        handle: entry.handle
-      };
-      items.push(item);
+      items.push({ id, handle: entry.handle });
     }
     await this.monitoredItemService.createMonitoredItems(subscriptionId, items);
-    this.publish([]);
-  }
-  async publish(acknowledgeSequenceNumbers) {
-    const acknowledgements = [];
-    for (let i = 0; i < acknowledgeSequenceNumbers.length; i++) {
-      const acknowledgement = new opcjsBase.SubscriptionAcknowledgement();
-      acknowledgement.subscriptionId = this.entries[i].subscriptionId;
-      acknowledgement.sequenceNumber = acknowledgeSequenceNumbers[i];
-      acknowledgements.push(acknowledgement);
+    this.isRunning = true;
+    void this.publishLoop([]);
+  }
+  // https://reference.opcfoundation.org/Core/Part4/v105/docs/5.14.5
+  async publishLoop(pendingAcknowledgements) {
+    if (!this.isRunning) return;
+    let response;
+    try {
+      response = await this.subscriptionService.publish(pendingAcknowledgements);
+    } catch (err) {
+      this.logger.error(`Publish failed, stopping publish loop: ${err}`);
+      this.isRunning = false;
+      return;
+    }
+    const { subscriptionId, availableSequenceNumbers, moreNotifications, notificationMessage } = response;
+    const notificationDatas = notificationMessage?.notificationData ?? [];
+    const seqNumber = notificationMessage?.sequenceNumber;
+    const nextAcknowledgements = [];
+    const isKeepAlive = notificationDatas.length === 0;
+    if (!isKeepAlive && seqNumber !== void 0) {
+      const isAvailable = !availableSequenceNumbers || availableSequenceNumbers.includes(seqNumber);
+      if (isAvailable) {
+        const ack = new opcjsBase.SubscriptionAcknowledgement();
+        ack.subscriptionId = subscriptionId;
+        ack.sequenceNumber = seqNumber;
+        nextAcknowledgements.push(ack);
+      }
     }
-    const response = await this.subscriptionService.publish(acknowledgements);
-    const messagesToAcknowledge = response.notificationMessage.sequenceNumber;
-    const notificationDatas = response.notificationMessage.notificationData;
     for (const notificationData of notificationDatas) {
       const decodedData = notificationData.data;
       const typeNodeId = notificationData.typeId;
-      if (typeNodeId.namespace === 0 && typeNodeId.identifier === 811) {
+      if (typeNodeId.namespace === 0 && typeNodeId.identifier === NODE_ID_DATA_CHANGE_NOTIFICATION) {
         const dataChangeNotification = decodedData;
         for (const item of dataChangeNotification.monitoredItems) {
-          const clientHandle = item.clientHandle;
-          const value = item.value;
-          const entry = this.entries.find((e) => e.handle == clientHandle);
-          entry?.callback([{
-            id: entry.id,
-            value: value.value?.value
-          }]);
+          const entry = this.entries.find((e) => e.handle === item.clientHandle);
+          entry?.callback([{ id: entry.id, value: item.value.value?.value }]);
         }
+      } else if (typeNodeId.namespace === 0 && typeNodeId.identifier === NODE_ID_STATUS_CHANGE_NOTIFICATION) {
+        const statusChange = decodedData;
+        this.logger.warn(
+          `Subscription ${subscriptionId} status changed: 0x${statusChange.status?.toString(16).toUpperCase()}`
+        );
+        this.isRunning = false;
+        return;
       } else {
-        console.log(`The change notification data type ${typeNodeId.namespace}:${typeNodeId.identifier} is not supported.`);
+        this.logger.warn(
+          `Notification data type ${typeNodeId.namespace}:${typeNodeId.identifier} is not supported.`
+        );
       }
     }
-    setTimeout(() => {
-      this.publish([messagesToAcknowledge]);
-    }, 500);
+    if (moreNotifications) {
+      void this.publishLoop(nextAcknowledgements);
+    } else {
+      setTimeout(() => void this.publishLoop(nextAcknowledgements), 0);
+    }
   }
 };
 var SubscriptionService = class extends ServiceBase {
+  logger = opcjsBase.getLogger("services.SubscriptionService");
+  /**
+   * Creates a new subscription on the server (OPC UA Part 4, Section 5.14.2).
+   * @param options - Optional subscription parameters; server revises all values.
+   * @returns The server-assigned subscription ID.
+   */
   // https://reference.opcfoundation.org/Core/Part4/v105/docs/5.14.2
-  async createSubscription() {
+  async createSubscription(options) {
     const request = new opcjsBase.CreateSubscriptionRequest();
     request.requestHeader = this.createRequestHeader();
-    request.requestedPublishingInterval = 2e3;
-    request.requestedLifetimeCount = 36e4;
-    request.requestedMaxKeepAliveCount = 6e4;
-    request.maxNotificationsPerPublish = 200;
+    request.requestedPublishingInterval = options?.requestedPublishingInterval ?? 2e3;
+    request.requestedLifetimeCount = options?.requestedLifetimeCount ?? 36e4;
+    request.requestedMaxKeepAliveCount = options?.requestedMaxKeepAliveCount ?? 6e4;
+    request.maxNotificationsPerPublish = options?.maxNotificationsPerPublish ?? 200;
     request.publishingEnabled = true;
-    request.priority = 1;
-    console.log("Sending createSubscription...");
+    request.priority = options?.priority ?? 1;
+    this.logger.debug("Sending CreateSubscriptionRequest...");
     const response = await this.secureChannel.issueServiceRequest(request);
-    console.log("Subscription created with id:", response.subscriptionId);
+    const serviceResult = response.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`CreateSubscriptionRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)}`);
+    }
+    this.logger.debug(`Subscription created with id: ${response.subscriptionId}`);
     return response.subscriptionId;
   }
+  /**
+   * Sends a publish request to receive notifications from active subscriptions (OPC UA Part 4, Section 5.14.5).
+   * @param acknowledgements - Sequence numbers to acknowledge from previous publish responses.
+   * @returns The publish response containing notification data.
+   */
   // https://reference.opcfoundation.org/Core/Part4/v105/docs/5.14.5
   async publish(acknowledgements) {
     const request = new opcjsBase.PublishRequest();
     request.requestHeader = this.createRequestHeader();
     request.subscriptionAcknowledgements = acknowledgements;
-    console.log("Sending publish...");
+    this.logger.debug("Sending PublishRequest...");
     const response = await this.secureChannel.issueServiceRequest(request);
-    console.log("Received publish response.");
+    const serviceResult = response.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`PublishRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)}`);
+    }
+    this.logger.debug("Received PublishResponse.");
     return response;
   }
   constructor(authToken, secureChannel) {
@@ -577,7 +404,15 @@ var SubscriptionService = class extends ServiceBase {
   }
 };
 var MonitoredItemService = class extends ServiceBase {
-  async createMonitoredItems(subscriptionId, ids) {
+  logger = opcjsBase.getLogger("services.MonitoredItemService");
+  /**
+   * Creates monitored items within a subscription (OPC UA Part 4, Section 5.13.2).
+   * @param subscriptionId - ID of the subscription to add monitored items to.
+   * @param ids - Array of NodeIds and client handles identifying the items to monitor.
+   * @param samplingInterval - Requested sampling interval in milliseconds. -1 = use subscription publishing interval.
+   * @param queueSize - Requested queue size for each monitored item.
+   */
+  async createMonitoredItems(subscriptionId, ids, samplingInterval = 1e3, queueSize = 100) {
     const items = ids.map((ni) => {
       const readValueId = new opcjsBase.ReadValueId();
       readValueId.nodeId = ni.id;
@@ -586,9 +421,9 @@ var MonitoredItemService = class extends ServiceBase {
       readValueId.dataEncoding = new opcjsBase.QualifiedName(0, "");
       const monitoringParameters = new opcjsBase.MonitoringParameters();
       monitoringParameters.clientHandle = ni.handle;
-      monitoringParameters.samplingInterval = 1e3;
+      monitoringParameters.samplingInterval = samplingInterval;
       monitoringParameters.filter = opcjsBase.ExtensionObject.newEmpty();
-      monitoringParameters.queueSize = 100;
+      monitoringParameters.queueSize = queueSize;
       monitoringParameters.discardOldest = true;
       const monitoredItemCreateRequest = new opcjsBase.MonitoredItemCreateRequest();
       monitoredItemCreateRequest.itemToMonitor = readValueId;
@@ -601,26 +436,38 @@ var MonitoredItemService = class extends ServiceBase {
     request.subscriptionId = subscriptionId;
     request.timestampsToReturn = opcjsBase.TimestampsToReturnEnum.Source;
     request.itemsToCreate = items;
-    console.log("Sending createMonitoredItems...");
-    await this.secureChannel.issueServiceRequest(request);
+    this.logger.debug("Sending CreateMonitoredItemsRequest...");
+    const response = await this.secureChannel.issueServiceRequest(request);
+    const serviceResult = response.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`CreateMonitoredItemsRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)}`);
+    }
+    for (const result of response.results ?? []) {
+      if (result.statusCode !== void 0 && result.statusCode !== opcjsBase.StatusCode.Good) {
+        this.logger.warn(`Failed to create monitored item: ${opcjsBase.StatusCodeToString(result.statusCode)}`);
+      }
+    }
   }
   constructor(authToken, secureChannel) {
     super(authToken, secureChannel);
   }
 };
 var MethodService = class extends ServiceBase {
+  logger = opcjsBase.getLogger("services.MethodService");
   /**
    * Calls one or more methods on the server (OPC UA Part 4, Section 5.11.2).
    * @param methodsToCall - Array of CallMethodRequest describing each method to invoke.
-   * @returns Array of CallMethodResult, one per requested method.
+   * @returns Array of results containing output argument values and raw status code number, one per requested method.
    */
   async call(methodsToCall) {
     const request = new opcjsBase.CallRequest();
     request.requestHeader = this.createRequestHeader();
     request.methodsToCall = methodsToCall;
+    this.logger.debug("Sending CallRequest...");
     const response = await this.secureChannel.issueServiceRequest(request);
+    this.checkServiceResult(response.responseHeader?.serviceResult, "CallRequest");
     return response.results.map((result) => ({
-      status: StatusCodeToString(result.statusCode),
+      statusCode: result.statusCode ?? opcjsBase.StatusCode.Good,
       value: result.outputArguments.map((arg) => arg.value)
     }));
   }
@@ -631,12 +478,18 @@ var MethodService = class extends ServiceBase {
 
 // src/callMethodResult.ts
 var CallMethodResult = class {
-  constructor(values, status) {
+  constructor(values, statusCode) {
     this.values = values;
-    this.status = status;
+    this.statusCode = statusCode;
   }
 };
 var BrowseService = class extends ServiceBase {
+  logger = opcjsBase.getLogger("services.BrowseService");
+  /**
+   * Browses one or more Nodes and returns their References (OPC UA Part 4, Section 5.9.2).
+   * @param nodesToBrowse - Array of BrowseDescriptions specifying nodes and filter criteria.
+   * @returns Array of BrowseResult, one per requested node.
+   */
   async browse(nodesToBrowse) {
     const view = new opcjsBase.ViewDescription();
     view.viewId = opcjsBase.NodeId.newNumeric(0, 0);
@@ -647,15 +500,25 @@ var BrowseService = class extends ServiceBase {
     request.view = view;
     request.requestedMaxReferencesPerNode = 0;
     request.nodesToBrowse = nodesToBrowse;
+    this.logger.debug("Sending BrowseRequest...");
     const response = await this.secureChannel.issueServiceRequest(request);
+    this.checkServiceResult(response.responseHeader?.serviceResult, "BrowseRequest");
     return response.results ?? [];
   }
+  /**
+   * Continues a Browse operation using continuation points (OPC UA Part 4, Section 5.9.3).
+   * @param continuationPoints - Continuation points returned by a prior Browse or BrowseNext call.
+   * @param releaseContinuationPoints - If true, releases the continuation points without returning results.
+   * @returns Array of BrowseResult, one per continuation point.
+   */
   async browseNext(continuationPoints, releaseContinuationPoints) {
     const request = new opcjsBase.BrowseNextRequest();
     request.requestHeader = this.createRequestHeader();
     request.releaseContinuationPoints = releaseContinuationPoints;
     request.continuationPoints = continuationPoints;
+    this.logger.debug("Sending BrowseNextRequest...");
     const response = await this.secureChannel.issueServiceRequest(request);
+    this.checkServiceResult(response.responseHeader?.serviceResult, "BrowseNextRequest");
     return response.results ?? [];
   }
   constructor(authToken, secureChannel) {
@@ -692,12 +555,50 @@ var Client = class {
   session;
   subscriptionHandler;
   logger;
+  // Stored after connect() so that refreshSession() can recreate services.
+  secureChannel;
+  sessionHandler;
   getSession() {
     if (!this.session) {
       throw new Error("No session available");
     }
     return this.session;
   }
+  /**
+   * (Re-)initialises all session-scoped services from the current `this.session`.
+   * Called both after the initial `connect()` and after a session refresh.
+   */
+  initServices() {
+    const authToken = this.session.getAuthToken();
+    const sc = this.secureChannel;
+    this.attributeService = new AttributeService(authToken, sc);
+    this.methodService = new MethodService(authToken, sc);
+    this.browseService = new BrowseService(authToken, sc);
+    this.subscriptionHandler = new SubscriptionHandler(
+      new SubscriptionService(authToken, sc),
+      new MonitoredItemService(authToken, sc)
+    );
+  }
+  /**
+   * Executes `fn` and, if it throws a `SessionInvalidError`, creates a fresh
+   * session and retries the operation exactly once.
+   *
+   * This covers the reactive case: a service call reveals that the server has
+   * already dropped the session (e.g. due to timeout). The new session is
+   * established transparently before re-running the original operation.
+   */
+  async withSessionRefresh(fn) {
+    try {
+      return await fn();
+    } catch (err) {
+      if (!(err instanceof SessionInvalidError)) throw err;
+      this.logger.info(`Session invalid (${err.statusCode.toString(16)}), refreshing session...`);
+      this.session = await this.sessionHandler.createNewSession(this.identity);
+      this.initServices();
+      this.logger.info("Session refreshed, retrying operation.");
+      return await fn();
+    }
+  }
   async connect() {
     const wsOptions = { endpoint: this.endpointUrl };
     const ws = new opcjsBase.WebSocketFascade(wsOptions);
@@ -742,24 +643,21 @@ var Client = class {
     await sc.openSecureChannel();
     this.logger.debug("Secure channel established.");
     this.logger.debug("Creating session...");
-    const sessionHandler = new SessionHandler(sc, this.configuration);
-    this.session = await sessionHandler.createNewSession(this.identity);
+    this.sessionHandler = new SessionHandler(sc, this.configuration);
+    this.secureChannel = sc;
+    this.session = await this.sessionHandler.createNewSession(this.identity);
     this.logger.debug("Session created.");
     this.logger.debug("Initializing services...");
-    this.attributeService = new AttributeService(this.session.getAuthToken(), sc);
-    this.methodService = new MethodService(this.session.getAuthToken(), sc);
-    this.browseService = new BrowseService(this.session.getAuthToken(), sc);
-    this.subscriptionHandler = new SubscriptionHandler(
-      new SubscriptionService(this.session.getAuthToken(), sc),
-      new MonitoredItemService(this.session.getAuthToken(), sc)
-    );
+    this.initServices();
   }
   async disconnect() {
     this.logger.info("Disconnecting from OPC UA server...");
   }
   async read(ids) {
-    const result = await this.attributeService?.ReadValue(ids);
-    return result?.map((r) => new ReadValueResult(r.value, r.status)) || [];
+    return this.withSessionRefresh(async () => {
+      const result = await this.attributeService?.ReadValue(ids);
+      return result?.map((r) => new ReadValueResult(r.value, r.statusCode)) ?? [];
+    });
   }
   /**
    * Method for calling a single method on the server.
@@ -769,17 +667,21 @@ var Client = class {
    * @returns The CallMethodResult for the invoked method.
    */
   async callMethod(objectId, methodId, inputArguments = []) {
-    const request = new opcjsBase.CallMethodRequest();
-    request.objectId = objectId;
-    request.methodId = methodId;
-    request.inputArguments = inputArguments.map((arg) => opcjsBase.Variant.newFrom(arg));
-    const responses = await this.methodService.call([request]);
-    const response = responses[0];
-    return new CallMethodResult(response.value, response.status);
+    return this.withSessionRefresh(async () => {
+      const request = new opcjsBase.CallMethodRequest();
+      request.objectId = objectId;
+      request.methodId = methodId;
+      request.inputArguments = inputArguments.map((arg) => opcjsBase.Variant.newFrom(arg));
+      const responses = await this.methodService.call([request]);
+      const response = responses[0];
+      return new CallMethodResult(response.value, response.statusCode);
+    });
   }
   async browse(nodeId, recursive = false) {
-    const visited = /* @__PURE__ */ new Set();
-    return this.browseRecursive(nodeId, recursive, visited);
+    return this.withSessionRefresh(() => {
+      const visited = /* @__PURE__ */ new Set();
+      return this.browseRecursive(nodeId, recursive, visited);
+    });
   }
   async browseRecursive(nodeId, recursive, visited) {
     const nodeKey = `${nodeId.namespace}:${nodeId.identifier}`;
@@ -928,6 +830,7 @@ var UserIdentity = class _UserIdentity {
 exports.BrowseNodeResult = BrowseNodeResult;
 exports.Client = Client;
 exports.ConfigurationClient = ConfigurationClient;
+exports.SessionInvalidError = SessionInvalidError;
 exports.UserIdentity = UserIdentity;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map