[TS] Http procedure API (#3731)

# Description of Changes

Provides a fetch-alike API on `ctx.http`. I guess it could just be
`ctx.fetch()` instead of `ctx.http.fetch()`, but I'm not sure if that's
a good idea.

# Expected complexity level and risk

2

# Testing

<!-- Describe any testing you've done, and any testing you'd like your
reviewers to do,
so that you're confident that all the changes work as expected! -->

- [x] Need to verify that this actually works
- [ ] <!-- maybe a test you want a reviewer to do, so they can check it
off when they're satisfied. -->

Author: coolreader18

crates/bindings-typescript/package.json

@@ -158,7 +158,10 @@
   "dependencies": {
     "base64-js": "^1.5.1",
     "fast-text-encoding": "^1.0.0",
-    "prettier": "^3.3.3"
+    "headers-polyfill": "^4.0.3",
+    "prettier": "^3.3.3",
+    "statuses": "^2.0.2",
+    "url-polyfill": "^1.1.14"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0-0 || ^19.0.0",
@@ -177,6 +180,7 @@
     "@size-limit/file": "^11.2.0",
     "@types/fast-text-encoding": "^1.0.3",
     "@types/react": "^19.1.13",
+    "@types/statuses": "^2.0.6",
     "@typescript-eslint/eslint-plugin": "^8.18.2",
     "@typescript-eslint/parser": "^8.18.2",
     "@vitest/coverage-v8": "^3.2.4",

crates/bindings-typescript/src/lib/autogen/http_header_pair_type.ts

@@ -0,0 +1,6 @@
+export { default as HttpHeaderPair } from './autogen/http_header_pair_type';
+export { default as HttpHeaders } from './autogen/http_headers_type';
+export { default as HttpMethod } from './autogen/http_method_type';
+export { default as HttpRequest } from './autogen/http_request_type';
+export { default as HttpResponse } from './autogen/http_response_type';
+export { default as HttpVersion } from './autogen/http_version_type';

crates/bindings-typescript/src/lib/autogen/http_headers_type.ts

@@ -2,6 +2,7 @@ import { AlgebraicType, ProductType } from '../lib/algebraic_type';
 import type { ConnectionId } from '../lib/connection_id';
 import type { Identity } from '../lib/identity';
 import type { Timestamp } from '../lib/timestamp';
+import type { HttpClient } from '../server/http_internal';
 import type { ParamsObj } from './reducers';
 import {
   MODULE_DEF,
@@ -23,6 +24,7 @@ export interface ProcedureCtx<S extends UntypedSchemaDef> {
   readonly identity: Identity;
   readonly timestamp: Timestamp;
   readonly connectionId: ConnectionId | null;
+  readonly http: HttpClient;
 }
 
 export function procedure<

crates/bindings-typescript/src/lib/autogen/http_method_type.ts

@@ -8,7 +8,7 @@
 export class SpacetimeHostError extends Error {
   public readonly code: number;
   public readonly message: string;
-  constructor(code: number) {
+  constructor(code: number, message?: string) {
     super();
     const proto = Object.getPrototypeOf(this);
     let cls;
@@ -24,7 +24,7 @@ export class SpacetimeHostError extends Error {
     }
     Object.setPrototypeOf(this, cls.prototype);
     this.code = cls.CODE;
-    this.message = cls.MESSAGE;
+    this.message = message ?? cls.MESSAGE;
   }
   get name(): string {
     return errnoToClass.get(this.code)?.name ?? 'SpacetimeHostError';
@@ -151,6 +151,8 @@ const errorData = {
     20,
     'ABI call can only be made while within a read-only transaction',
   ],
+
+  HttpError: [21, 'The HTTP request failed'],
 } as const;
 
 function mapEntries<const T extends Record<string, any>, U>(