The goals:
- Generic: Works with any Iceberg REST Catalog implementation, not tied to any specific vendor
- Minimal: Thin HTTP wrapper over the official REST API, no engine-specific logic
- Type-safe: First-class TypeScript support with strongly-typed request/response models
- Fetch-based: Uses native fetch API with support for custom implementations
- Universal: Targets Node 20+ and modern browsers (ES2020)
- Catalog-only: Focused on catalog operations at this stage
Although Iceberg is becoming very popular, we were surprised that the developer tooling is so nascent. This library is our contribution back to the ecosystem. The goal is to keep it minimal and well-maintained, so that developers can manage their warehouse from any JS server.
We are using it with AWS's new "S3 Tables". If it doesn't support other REST catalogs we'd welcome contributions