lib: deprecate _stream_wrap

Its unused by node, and doesn't have a reasonable use outside of node.

See: #25153
See: #16158

PR-URL: #26245
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Tobias Nießen <[email protected]>

Author: sam-github

doc/api/deprecations.md

@@ -2349,6 +2349,19 @@ Type: Runtime
 
 This property is a reference to the instance itself.
 
+<a id="DEP0XXX"></a>
+### DEP0XXX: require('\_stream\_wrap')
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/26245
+    description: Runtime deprecation.
+-->
+
+Type: Runtime
+
+The `_stream_wrap` module is deprecated.
+
 [`--pending-deprecation`]: cli.html#cli_pending_deprecation
 [`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size
 [`Buffer.from(array)`]: buffer.html#buffer_class_method_buffer_from_array

lib/_stream_wrap.js

@@ -1,3 +1,5 @@
 'use strict';
 
 module.exports = require('internal/js_stream_socket');
+process.emitWarning('The _stream_wrap module is deprecated.',
+                    'DeprecationWarning', 'DEP0XXX');

test/parallel/test-warn-stream-wrap.js

@@ -0,0 +1,10 @@
+'use strict';
+
+const common = require('../common');
+
+// _stream_wrap is deprecated.
+
+common.expectWarning('DeprecationWarning',
+                     'The _stream_wrap module is deprecated.', 'DEP0XXX');
+
+require('_stream_wrap');