Repository navigation
Releases: poli-page/sdk-go
Releases · poli-page/sdk-go
Release list
v0.9.0
First public release of the Go SDK for Poli Page.
The 0.9.x line is the API-frozen pre-1.0 stabilization series: the public
surface listed below is what 1.0 will ship; only bug fixes and additive,
backwards-compatible changes are expected before then.
Highlights
- Rendering: Render.PDF, Render.PDFStream, Render.Preview, Render.Document
- Stored documents: Documents.Get, Documents.Preview, Documents.Thumbnails,
Documents.Delete, DocumentDescriptor.DownloadPDF - Helper: RenderToFile (stream-to-disk, bounded memory)
- Sealed RenderInput interface — project vs inline mode enforced at compile
time; PDF / PDFStream / Document require project mode - Single error type (*polipage.Error) with errors.Is / errors.As sentinels
and lifecycle codes (PaymentRequired, OrganizationCancelled, Gone, ...) - Retries on 5xx / 429 / network / timeout with exponential backoff + jitter,
honoring Retry-After (cap 30s); auto Idempotency-Key (UUID v4) on every POST - Configurable via the option subpackage: WithAPIKey, WithBaseURL,
WithMaxRetries, WithRetryDelay, WithTimeout, WithHTTPClient, WithLogger,
WithOnRetry, WithOnError; per-call WithIdempotencyKey, WithRequestTimeout,
WithHeader - log/slog integration + synchronous, panic-safe retry/error hooks
- Zero runtime dependencies; Go 1.25+; safe for concurrent use
Install
go get github.com/poli-page/sdk-go@v0.9.0
Documentation: https://poli-page.github.io/sdk-go/
API reference: https://pkg.go.dev/github.com/poli-page/sdk-go