node-opcua-transport 2.170.0 → 2.173.0

package/source/index.browser.ts

@@ -0,0 +1,62 @@
+/*!
+ * The MIT License (MIT)
+ * Copyright (c) 2022-2025  Sterfive SAS - 833264583 RCS ORLEANS - France  (https://www.sterfive.com)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ *   The above copyright notice and this permission notice shall be included in all
+ *   copies or substantial portions of the Software.
+ */
+/**
+ * @module node-opcua-transport/browser
+ *
+ * Browser-safe subset of `node-opcua-transport`. Selected automatically by
+ * bundlers (esbuild, webpack, vite, rollup) via the `"browser"` condition in
+ * this package's `exports` map.
+ *
+ * Excludes Node-only modules whose top-level `import "node:net" | "node:os"`
+ * statements would otherwise crash a `platform: "browser"` bundle even though
+ * the runtime never reaches them:
+ *   - `client_tcp_transport`        — opens a `net.Socket`
+ *   - `default_client_transport_factory` — instantiates `ClientTCP_transport`
+ *   - `server_tcp_transport`        — Node-side server endpoint
+ *
+ * Browser-side OPC UA transports (e.g. `ClientWS_transport` from
+ * `node-opcua-client-browser`) extend `ClientTransportBase` from this entry,
+ * implement their own `connect()`, and inherit the inherited HEL/ACK,
+ * packet-assembly, and lifecycle machinery.
+ *
+ * ## Bundler configuration required
+ *
+ * Several files still re-exported here import `node:events` (e.g.
+ * `tcp_transport.ts`, `message_builder_base.ts`). Browser bundlers do not
+ * auto-polyfill `node:`-prefixed built-ins; consumers must alias them to
+ * polyfill packages. Example (esbuild):
+ *
+ *   alias: {
+ *     "node:events": "events",
+ *     "node:util":   "util",
+ *     "node:buffer": "buffer"
+ *   }
+ *
+ * Transitively, `node-opcua-debug` and `node-opcua-utils` also need these
+ * aliases. We deliberately do not declare the polyfills as dependencies of
+ * the transport package — Node consumers would pay the install cost for no
+ * benefit, and Node would prefer the npm port over its own built-in.
+ */
+export * from "./AcknowledgeMessage";
+export * from "./client_transport_base";
+export * from "./HelloMessage";
+export * from "./i_client_transport";
+export * from "./i_hello_ack_limits";
+export * from "./message_builder_base";
+export * from "./status_codes";
+export * from "./TCPErrorMessage";
+export * from "./tcp_transport";
+export * from "./tools";
+export * from "./utils";

package/source/index.ts

@@ -25,7 +25,10 @@
  */
 export * from "./AcknowledgeMessage";
 export * from "./client_tcp_transport";
+export * from "./client_transport_base";
+export * from "./default_client_transport_factory";
 export * from "./HelloMessage";
+export * from "./i_client_transport";
 export * from "./i_hello_ack_limits";
 export * from "./message_builder_base";
 export * from "./server_tcp_transport";