postio-integrations

Name: Postio
Author: postio-uk

Die npm-Pakete der JS-Familie, die KI-/Agenten-Oberfläche und der cdn.postio.co.uk Worker, der das Browser-Drop-in von Postio betreibt.

Die Postio-API + OpenAPI-Spezifikation befinden sich unter postio-uk/postio-api. Die Spezifikation wird auch als @postio/openapi veröffentlicht.

Pakete

Paket	Was es ist
`@postio/api-types`	TypeScript-Typen, die aus der OpenAPI-Spezifikation generiert wurden.
`@postio/core`	Laufzeitunabhängiger typisierter Client (Browser / Node / Workers / Bun / Deno).
`@postio/node`	Node SDK auf Basis von `core` — Wiederholungsversuche mit exponentiellem Backoff, strukturierter Logger-Hook.
`@postio/postman-collection`	Postman v2.1-Sammlung für jeden Endpunkt.
`@postio/address-finder`	Browser-Adress-Autovervollständigung — ARIA-Combobox, thematisierbar, framework-unabhängige Quelle.
`@postio/address-finder-bundled`	Dieselbe Komponente, vorgefertigt für die Verwendung mit `<script>`-Tags.
`@postio/react`	React-Hooks + `<AddressFinder />`-Komponente, TanStack Query im Hintergrund.
`@postio/mcp`	Model Context Protocol Server — `npx -y @postio/mcp` für Claude Desktop / Cursor / Windsurf / Zed.

Layout

packages/         pnpm workspace; one publishable npm package per subdir
ai/               AI / agent surface (Claude Skill, GPT Action, recommendation prompts)
cdn-worker/       Cloudflare Worker that serves the address-finder bundles
.github/workflows/  CI for publishing + deploying

Erstellung

cd packages
pnpm install
pnpm -r run build

Jedes Paket wird unabhängig erstellt (pnpm -F @postio/<name> run build). Das address-finder-Bundle hat eine Besonderheit beim topologischen Build — verwenden Sie das ...-Suffix, damit die Workspace-Abhängigkeit zuerst erstellt wird:

pnpm -F "@postio/address-finder-bundled..." run build

Mitwirken

PRs sind willkommen. Konventionen:

Node 22+, pnpm 10+, nur ESM, MIT-lizenziert.
stage ist der Arbeitszweig; master stellt bereit / veröffentlicht über CI.
Wenn möglich, eine Paketänderung pro PR.
Die Versionen der einzelnen Pakete sind unabhängige SemVer; erhöhen Sie die Version in package.json, wenn Sie eine Veröffentlichung planen.

Der vollständige Integrationsindex — einschließlich der Server-SDKs in ihren eigenen Repos und dem WordPress-Plugin — befindet sich unter postio.co.uk/integrations.