Skip to content

development.mdx

Latest commit

 

History

History
44 lines (36 loc) · 1.6 KB

development.mdx

File metadata and controls

44 lines (36 loc) · 1.6 KB
title SDKs
description Official client libraries for the Pocketenv API.

Pocketenv provides official SDKs for multiple languages. All SDKs wrap the same XRPC API and follow similar conventions.

`@pocketenv/sdk` — tagged template literals, builder pattern, full sub-resource support. `pocketenv` on hex.pm — type-safe, functional, pipe-friendly API. `io.pocketenv/pocketenv` on Clojars — idiomatic Clojure with `->` chaining. `pocketenv_ex` on hex.pm — pipe-friendly, OTP-ready, config via `config.exs`.

Authentication

All SDKs resolve your token from the same sources, in priority order:

  1. Passed explicitly at the call site
  2. POCKETENV_TOKEN environment variable
  3. ~/.pocketenv/token.json — written by pocketenv login

Common concepts

Every SDK covers the same core resources:

Resource Description
Sandbox Create, start, stop, delete, exec
Environment variables Plaintext key-value config
Secrets Encrypted credentials (redacted in responses)
Files Read/write files inside a sandbox
Ports Expose sandbox ports to the internet
Services Long-running processes
Volumes Persistent storage
Backups Point-in-time directory snapshots