feat: Implement SecureReq class for enhanced HTTPS requests

[piquark6046]

• Add request-helpers.ts for utility functions to determine expected response types and handle errors.
• Introduce request-schema.ts to define and validate HTTPS request options using Zod.
• Create secure-req.ts to implement the SecureReq class, supporting HTTP/1.1 and HTTP/2 protocols with compression negotiation.
• Update type.ts to include new types for HTTP methods, protocols, and request options.
• Enhance utils.ts with functions for handling streams, headers, and payloads.
• Add comprehensive tests for SecureReq, covering protocol negotiation, response decoding, and streaming uploads/downloads.
• Implement a test server in support/server.ts to facilitate testing of various response types and encodings.
• Create TLS certificate generation in support/tls.ts for secure testing.

[Copilot]

Pull request overview

This PR replaces the previous function-based HTTPS helpers with a new SecureReq class that adds per-origin protocol/compression negotiation, streaming request/response support, and a local TLS-backed test server to validate HTTP/1.1 ↔ HTTP/2 behavior.

Changes:

• Introduces SecureReq with HTTP/1.1 + HTTP/2 transports, response decompression, streaming payloads, and origin capability caching.
• Adds request option validation (Zod) plus new shared constants/types/utilities to support protocol/compression negotiation and streaming.
• Replaces external-network tests with a local HTTP/2 (allowHTTP1) TLS test server, including on-the-fly certificate generation.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
sources/secure-req.ts	Implements SecureReq request flow, HTTP/2 session caching, response decoding, and origin capability tracking.
sources/utils.ts	Adds stream/header helpers, payload normalization, compression parsing, and decoding stream creation.
sources/type.ts	Expands public types for protocols, methods, payloads, and richer response metadata.
sources/request-schema.ts	Adds Zod validation for request options (including streaming payload support).
sources/request-helpers.ts	Adds helpers for response type inference and error normalization.
sources/constants.ts	Centralizes default TLS/header/compression settings and header filtering sets.
sources/index.ts	Switches public API surface to export SecureReq, GlobalSecureReq, and updated types.
tests/support/tls.ts	Generates ephemeral TLS cert/key via OpenSSL for local HTTPS testing.
tests/support/server.ts	Adds local HTTP/2 secure test server (HTTP/1.1 allowed) with compression + streaming endpoints.
tests/index.test.ts	Replaces external HTTP tests with comprehensive SecureReq tests against the local server.
README.md	Updates docs to reflect the class-based API, negotiation behavior, compression, and streaming.
eslint.config.js	Updates naming-convention rule to include class methods.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.