Which QAIL SDK is registry-published today?

TypeScript is published as @qail/client (0.1.0). Swift and Kotlin are currently consumed from the monorepo source modules.

Do Swift and Kotlin clients expose the same query patterns as TypeScript?

Yes. Swift and Kotlin expose builder-oriented query paths, raw DSL/batch requests, aggregate helpers, and utility endpoints aligned with the TypeScript track.

What realtime path is available in the SDK layer?

SDK clients support WebSocket subscribe and unsubscribe flows for realtime updates, matching gateway/websocket endpoint semantics.

When should I use /sdk versus /rust or /zig?

Use /sdk for app-level client integration in TypeScript/Swift/Kotlin. Use /rust or /zig when you need direct PostgreSQL driver/runtime control.

QAIL SDKs: Official TypeScript, Swift & Kotlin Clients

SDK Capability Matrix

Matrix below is sourced directly from qail.rs/sdk project files: TypeScript package metadata and client source, Swift package config/client source, and Kotlin Gradle/client source.

SDK	Package	Version	Runtime	Source	Notes
TypeScript	@qail/client	0.1.0	Node.js >= 18	sdk/typescript	Builder API, raw DSL query/batch, schema type generation, and WebSocket subscription support.
Swift	Qail (Swift package)	swift-tools-version 6.0	iOS 15+, macOS 12+, tvOS 15+, watchOS 8+	sdk/swift	Async/await SDK with fluent builders, aggregate helpers, openapi/schema utilities, and WebSocket subscription support.
Kotlin	io.qail (Gradle module)	0.1.0	Kotlin JVM 2.3.0 + Ktor 3.0.3	sdk/kotlin	Fluent builders, aggregate and upsert helpers, raw DSL query/batch, schema/openapi helpers, and WebSocket subscription support.

Feature Parity Snapshot

TypeScript

@qail/client exposes builder APIs (from/into/update/delete), raw DSL (query, batch), utility endpoints (health/openapi/schema/generateTypes), and WebSocket subscriptions.

Swift

Swift package client provides async/await query builders, aggregate and upsert helpers, raw DSL and batch paths, utility endpoints, plus WebSocket subscribe/unsubscribe flow.

Kotlin

Kotlin JVM SDK (Ktor-based) mirrors builder/query semantics with typed responses, aggregate/upsert helpers, openapi/schema utilities, and WebSocket subscription support.

Getting Started

1. TypeScript Package

Install the published TypeScript SDK package.

npm install @qail/client

2. Swift SDK Source Module

Swift SDK currently lives in the monorepo source path.

git clone https://github.com/qail-io/qail.git
cd qail/sdk/swift
swift test

3. Kotlin SDK Source Module

Kotlin SDK is provided as a Gradle JVM module in the monorepo.

git clone https://github.com/qail-io/qail.git
cd qail/sdk/kotlin
./gradlew test

PostgreSQL drivers - direct Rust and Zig runtime pages.
Gateway AutoREST page - runtime API surface for SDK clients.
Rust driver page - qail-pg protocol driver intent.
Zig driver page - qail-zig driver intent.
Changelog - release timeline and dedicated page links.

Gateway PostgreSQL Drivers

FAQ

Which SDK is published in a package registry right now?

TypeScript is available as @qail/client version 0.1.0. Swift and Kotlin are consumed from sdk/swift and sdk/kotlin in the monorepo.

Do Swift and Kotlin have the same query model as TypeScript?

Mostly yes. All three tracks expose builder-style queries, raw DSL/batch paths, aggregate helpers, and schema/openapi utility surfaces.

How does realtime work in the SDK layer?

Each SDK includes WebSocket subscription primitives so clients can subscribe/unsubscribe to gateway realtime streams without hand-writing protocol frames.

When should I choose SDKs versus the native drivers?

Choose /sdk for app integration. Choose /rust or /zig when you need transport-level PostgreSQL behavior, pooling internals, and protocol control.

Build Faster with Official SDKs