@npy/fetch 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 matheus fernandes
+
+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.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# @npy/fetch
+
+an http/1.1 client built over raw tcp sockets with a fetch-compatible api, per-origin connection pooling, and first-class proxy support.
+
+> [!NOTE]
+> node and bun only — does not work in the browser.
+
+## install
+```sh
+bun add @npy/fetch
+# or
+npm install @npy/fetch
+```
+
+## usage
+
+### simple fetch
+```ts
+import { fetch } from '@npy/fetch'
+
+const response = await fetch('https://httpbin.org/anything')
+const body = await response.json()
+console.log(body)
+
+fetch.close()
+```
+
+### with http/s proxy
+```ts
+import { createFetch, HttpClient } from '@npy/fetch'
+import { ProxyDialer } from '@npy/fetch/dialers'
+
+const fetch = createFetch(new HttpClient({
+    dialer: new ProxyDialer('http://user:pass@proxy.example.com:8080'),
+}))
+
+const response = await fetch('https://httpbin.org/ip')
+console.log(await response.json())
+
+fetch.close()
+```
+
+### with socks proxy
+```ts
+import { createFetch, HttpClient } from '@npy/fetch'
+import { ProxyDialer } from '@npy/fetch/dialers'
+
+const fetch = createFetch(new HttpClient({
+    dialer: new ProxyDialer('socks5://user:pass@proxy.example.com:1080'),
+}))
+
+const response = await fetch('https://httpbin.org/ip')
+console.log(await response.json())
+
+fetch.close()
+```
+
+### custom i/o options
+```ts
+import { HttpClient } from '@npy/fetch'
+
+const client = new HttpClient({
+    poolMaxPerHost: 10,
+    poolMaxIdlePerHost: 5,
+    poolIdleTimeout: 30_000,
+    connect: {
+        keepAlive: true,
+        noDelay: true,
+        timeout: 5_000,
+    },
+    io: {
+        reader: {
+            bufferSize: 32 * 1024,
+            highWaterMark: 16 * 1024,
+            maxHeaderSize: 16 * 1024,
+            maxBodySize: '10mb',
+            decompress: true,
+        },
+        writer: {
+            highWaterMark: 16 * 1024,
+            coalesceBodyMaxBytes: 64 * 1024,
+        },
+    },
+})
+
+const response = await client.send({ url: 'https://httpbin.org/anything', method: 'GET' })
+console.log(await response.json())
+
+await client.close()
+```
+
+### using `HttpClient` directly
+```ts
+import { HttpClient } from '@npy/fetch'
+
+const client = new HttpClient()
+
+const response = await client.send({
+    url: 'https://httpbin.org/post',
+    method: 'POST',
+    headers: new Headers({ 'content-type': 'application/json' }),
+    body: JSON.stringify({ hello: 'world' }),
+})
+
+console.log(await response.json())
+await client.close()
+```
+
+---
+
+based on [deno-simple-fetch](https://github.com/esroyo/deno-simple-fetch).

package/package.json

@@ -0,0 +1,39 @@
+{
+    "name": "@npy/fetch",
+    "type": "module",
+    "version": "0.1.0",
+    "license": "MIT",
+    "scripts": {},
+    "dependencies": {
+        "@fuman/io": "^0.0.19",
+        "@fuman/net": "^0.0.19",
+        "@fuman/node": "^0.0.19",
+        "@fuman/utils": "^0.0.19",
+        "@npy/proxy-kit": "0.1.0",
+        "bytes": "^3.1.2",
+        "generic-pool": "^3.9.0",
+        "mitata": "^1.0.34"
+    },
+    "exports": {
+        ".": {
+            "import": {
+                "types": "./index.d.ts",
+                "default": "./index.js"
+            },
+            "require": {
+                "types": "./index.d.cts",
+                "default": "./index.cjs"
+            }
+        }
+    },
+    "sideEffects": false,
+    "files": [
+        "dist",
+        "LICENSE",
+        "README.md"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/neeopy/npy.git"
+    }
+}