opcjs-client 0.1.18-alpha → 0.1.20-alpha

package/dist/index.cjs

@@ -28,6 +28,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 +61,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 +83,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 +99,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 +187,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 +208,21 @@ 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);
+    const serviceResult = response.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`ReadRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)} (${opcjsBase.StatusCodeToStringNumber(serviceResult)})`);
+    }
     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 +233,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;
   }
 };
 
@@ -487,6 +255,7 @@ var SubscriptionHandler = class {
     this.subscriptionService = subscriptionService;
     this.monitoredItemService = monitoredItemService;
   }
+  logger = opcjsBase.getLogger("SubscriptionHandler");
   entries = new Array();
   nextHandle = 0;
   async subscribe(ids, callback) {
@@ -538,7 +307,7 @@ var SubscriptionHandler = class {
           }]);
         }
       } 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(() => {
@@ -547,29 +316,48 @@ var SubscriptionHandler = class {
   }
 };
 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 +365,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 +382,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 +397,41 @@ 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);
+    const serviceResult = response.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`CallRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)} (${opcjsBase.StatusCodeToStringNumber(serviceResult)})`);
+    }
     return response.results.map((result) => ({
-      status: StatusCodeToString(result.statusCode),
+      statusCode: result.statusCode ?? opcjsBase.StatusCode.Good,
       value: result.outputArguments.map((arg) => arg.value)
     }));
   }
@@ -631,12 +442,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 +464,31 @@ 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);
+    const serviceResult = response.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`BrowseRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)}`);
+    }
     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);
+    const serviceResult = response.responseHeader?.serviceResult;
+    if (serviceResult !== void 0 && serviceResult !== opcjsBase.StatusCode.Good) {
+      throw new Error(`BrowseNextRequest failed: ${opcjsBase.StatusCodeToString(serviceResult)}`);
+    }
     return response.results ?? [];
   }
   constructor(authToken, secureChannel) {
@@ -759,7 +592,7 @@ var Client = class {
   }
   async read(ids) {
     const result = await this.attributeService?.ReadValue(ids);
-    return result?.map((r) => new ReadValueResult(r.value, r.status)) || [];
+    return result?.map((r) => new ReadValueResult(r.value, r.statusCode)) || [];
   }
   /**
    * Method for calling a single method on the server.
@@ -775,7 +608,7 @@ var Client = class {
     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 new CallMethodResult(response.value, response.statusCode);
   }
   async browse(nodeId, recursive = false) {
     const visited = /* @__PURE__ */ new Set();