chore: add .gitignore (node_modules/)

.gitignore

@@ -0,0 +1 @@
+node_modules/

index.js

@@ -1,5 +1,12 @@
 import { Readable, Writable, Duplex } from 'stream';
 
+/**
+ * stream-to-push-stream - Convert Node.js streams to push-streams
+ *
+ * Bridges Node.js Readable/Writable/Duplex streams into the push-stream protocol
+ * so they can be composed with `@push-stream-std/*` operators.
+ */
+
 class PushSource {
   constructor(readable) {
     this.readable = readable;
@@ -223,6 +230,11 @@ class PushDuplex {
   }
 }
 
+/**
+ * Wrap a Node.js Readable stream as a push-stream source.
+ * @param {import('stream').Readable} readableStream
+ * @returns {object} A push-stream source
+ */
 export function source(readableStream) {
   if (!(readableStream instanceof Readable)) {
     throw new Error('Expected a Node.js Readable stream');
@@ -230,6 +242,11 @@ export function source(readableStream) {
   return new PushSource(readableStream);
 }
 
+/**
+ * Wrap a Node.js Writable stream as a push-stream sink.
+ * @param {import('stream').Writable} writableStream
+ * @returns {object} A push-stream sink
+ */
 export function sink(writableStream) {
   if (!(writableStream instanceof Writable)) {
     throw new Error('Expected a Node.js Writable stream');
@@ -237,6 +254,11 @@ export function sink(writableStream) {
   return new PushSink(writableStream);
 }
 
+/**
+ * Wrap a Node.js Duplex stream as a push-stream duplex (`{ source, sink }`).
+ * @param {import('stream').Duplex} duplexStream
+ * @returns {{source: object, sink: object}} Push-stream duplex
+ */
 export function duplex(duplexStream) {
   if (!(duplexStream instanceof Duplex)) {
     throw new Error('Expected a Node.js Duplex stream');

package-lock.json

@@ -0,0 +1,16 @@
+{
+  "name": "@push-stream-std/stream-to-push-stream",
+  "version": "1.0.3",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@push-stream-std/stream-to-push-stream",
+      "version": "1.0.3",
+      "license": "SEE LICENSE IN LICENSE",
+      "engines": {
+        "node": ">=22.0.0"
+      }
+    }
+  }
+}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@push-stream-std/stream-to-push-stream",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Convert Node.js streams to push-streams",
   "type": "module",
   "main": "index.js",