Zgodność w 10 liniach kodu
SDK TypeScript bez zależności. Natywny fetch, typowane błędy, pełne pokrycie API.
Od npm install do pierwszej decyzji w mniej niż minutę.
Szybki start
Zainstaluj, skonfiguruj, rozwiąż. Twoja pierwsza audytowalna decyzja w sekundy.
import { OmegaClient } from '@omegaos/sdk';
const client = new OmegaClient({
baseUrl: 'https://your-instance.example.com',
apiKey: 'delk_your_api_key',
tenantId: 'your-tenant-id',
});
const decision = await client.resolve({
evidenceList: [
{ key: 'credit_score', state: 'Indeterminate', source: 'bureau' },
{ key: 'identity_verified', state: 'True', source: 'kyc_provider' },
],
policy: { threshold: 2, requiredSources: ['bureau', 'kyc_provider'] },
});
console.log(decision.state); // "True" | "False" | "Indeterminate" Pełne pokrycie API
Każdy endpoint. Typowane wejścia, typowane wyjścia. Jedna instancja klienta dla całej powierzchni.
| Metoda | Opis |
|---|---|
| client.resolve(request) | Rozstrzyganie pojedynczej decyzji |
| client.resolveBatch(request) | Rozstrzyganie wsadowe (do 1000) |
| client.resolveMulti(request) | Rozstrzyganie multi-regulacyjne |
| client.getDecision(id) | Pobierz decyzję z dowodami |
| client.listDecisions(params) | Lista paginowana kursorem |
| client.createVerificationToken(req) | Utwórz token vfy_ |
| client.listVerificationTokens() | Wyświetl aktywne tokeny |
| client.revokeVerificationToken(id) | Unieważnij token |
| OmegaClient.verify(baseUrl, token) | Weryfikacja publiczna (bez auth) |
| client.health() | Sprawdzanie stanu |
Typowane błędy
Każdy błąd to typowana klasa, nie string.
OmegaAuthError
Nieprawidłowe lub wygasłe dane uwierzytelniające
OmegaForbiddenError
Niewystarczające uprawnienia
OmegaNotFoundError
Zasób nie znaleziony
OmegaBadRequestError
Nieprawidłowe żądanie
OmegaValidationError
Błąd walidacji schematu
OmegaRateLimitError
Przekroczono limit zapytań
Zasady projektowania
Zero zależności
Używa natywnego fetch(). Bez axios, bez node-fetch. Działa w Node.js 18+, Deno, Bun i przeglądarkach.
Bezpieczeństwo typów
Pełne typy TypeScript odzwierciedlające API Rust. TrileanState, Evidence, Policy, ResolveResult — wszystko typowane.
Fail-Fast
Typowane klasy błędów dla każdego statusu HTTP. Bez cichych awarii, bez ogólnych błędów.
Uwierzytelnianie
Trzy metody uwierzytelniania. Wybierz odpowiednią dla swojego kontekstu.
| Metoda | Header | Zastosowanie |
|---|---|---|
| API Key | X-API-Key: delk_... | Serwer-do-serwera, skrypty, CI/CD |
| JWT Bearer | Authorization: Bearer eyJ... | Sesje użytkowników, dashboard |
| Tenant ID | X-Tenant-Id: uuid | Izolacja multi-tenant |
Weryfikacja publiczna
Bez uwierzytelniania. Zweryfikuj dowolną decyzję za pomocą jednego tokena.
// No authentication required
const result = await OmegaClient.verify(
'https://your-instance.example.com',
'vfy_abc123...'
);
console.log(result.valid); // true
console.log(result.state); // "True"
console.log(result.decidedAt); // "2026-01-15T10:30:00Z" Dostępne podczas pilotażu
Pełny pakiet npm z licencją produkcyjną. Rozpocznij integrację podczas programu pilotażowego.