Crate TypeScript client #

@crate/client is a source-first HTTP client generated from the Rust server's actual Poem handlers and response enums. It is an adapter for the optional Crate web backend, not a replacement for ATProto Lexicons or an independently writable OpenAPI specification.

import { createCrateClient } from "@crate/client"

const api = createCrateClient()
const result = await api.GET("/api/v1/files", { params: { query: {} } })
if (result.error) throw new Error(result.error.message)
console.log(result.data.files)

The checked-in src/schema.ts needs no build step to import or typecheck. Its types do not validate arbitrary JSON at runtime; requests are validated by Poem, and response serialization uses the same Rust DTOs as the generated schema. The Swift client additionally decodes responses into generated Codable values. Browsers supply the mutation Origin automatically. Non-browser fetch transports must send the configured backend's canonical origin as well as their own session; the backend rejects mutation requests without an accepted origin.

Run just generate-api after Rust contract changes, and just check-contracts to check drift. This package's pinned TypeScript 6 dependency supplies the AST API required by OpenAPI code generation; root workspace checks use TypeScript 7. just check runs those root project-reference checks, generated-client tests, and the complete drift/Swift compilation check.

Never edit openapi.json or src/schema.ts directly. Binary request types are generated as Blob so web uploads require no unsafe type assertion. Send the body with bodySerializer: (body) => body and Content-Type: application/octet-stream; the mimeType query parameter preserves the file's actual media type.