Skip to content

Releases: poli-page/sdk-go

Release list

v0.9.0

Choose a tag to compare

@Mickael45 Mickael45 released this 17 Jun 15:33

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