ht #

ht stands for HTTP Types. It provides a fetch-first set of Dart HTTP abstractions.

This package focuses on the type and semantics layer only. It does not implement an HTTP client or server runtime.

Features #

• Fetch-style primitives: Request, Response, Headers, URLSearchParams, Blob, File, FormData
• Protocol helpers: HttpMethod, HttpStatus, HttpVersion, MimeType
• Consistent body-read semantics (single-consume), clone semantics, and header normalization
• Designed as a shared HTTP type layer for downstream client/server frameworks

Installation #

dart pub add ht

Or add it manually to pubspec.yaml:

dependencies:
  ht: ^0.1.0

Scope #

• No HTTP client implementation
• No HTTP server implementation
• No routing or middleware framework

The goal is to provide stable and reusable HTTP types and behavior contracts.

Core API #

Quick Example #

import 'package:ht/ht.dart';

Future<void> main() async {
  final request = Request.json(
    Uri.parse('https://api.example.com/tasks'),
    method: HttpMethod.post.value,
    body: {'title': 'rewrite ht'},
  );

  final response = Response.json(
    {'ok': true},
    status: HttpStatus.created,
  );

  print(request.method); // POST
  print(request.headers.get('content-type')); // application/json; charset=utf-8
  print(await response.text());
}

Body Semantics #

Request and Response use a single-consume body model:

• After the first text() / bytes() / json() / blob() call (or stream read), bodyUsed == true
• Reading the same instance again throws StateError
• Use clone() when multiple reads are required

FormData Example #

import 'package:ht/ht.dart';

void main() {
  final form = FormData()
    ..append('name', 'alice')
    ..append('avatar', Blob.text('binary'), filename: 'avatar.txt');

  final multipart = form.encodeMultipart();

  print(multipart.contentType);   // multipart/form-data; boundary=...
  print(multipart.contentLength); // body bytes length
}

Development #

dart pub get
dart format --output=none --set-exit-if-changed .
dart analyze
dart test
dart run example/main.dart

License #

MIT