postio-integrations

Name: Postio
Author: postio-uk

JS-пакеты npm, интерфейс для ИИ/агентов и воркер cdn.postio.co.uk, обеспечивающий работу браузерного виджета Postio.

API Postio и спецификация OpenAPI находятся в репозитории postio-uk/postio-api. Спецификация также опубликована как @postio/openapi.

Пакеты

Пакет	Описание
`@postio/api-types`	TypeScript-типы, сгенерированные из спецификации OpenAPI.
`@postio/core`	Типизированный клиент, не зависящий от среды выполнения (браузер / Node / Workers / Bun / Deno).
`@postio/node`	Node SDK поверх `core` — повторные попытки с экспоненциальной задержкой, хук для структурированного логирования.
`@postio/postman-collection`	Коллекция Postman v2.1 для каждого эндпоинта.
`@postio/address-finder`	Браузерный автокомплит адресов — ARIA combobox, поддержка тем, не зависит от фреймворка.
`@postio/address-finder-bundled`	Тот же компонент, предварительно собранный для использования через тег `<script>`.
`@postio/react`	React-хуки + компонент `<AddressFinder />`, под капотом TanStack Query.
`@postio/mcp`	Сервер Model Context Protocol — `npx -y @postio/mcp` для Claude Desktop / Cursor / Windsurf / Zed.

Структура

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

Сборка

cd packages
pnpm install
pnpm -r run build

Каждый пакет собирается независимо (pnpm -F @postio/<name> run build). У бандла address-finder есть особенность топологической сборки — используйте суффикс ..., чтобы сначала собралась зависимость рабочего пространства:

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

Участие в разработке

PR приветствуются. Соглашения:

Node 22+, pnpm 10+, только ESM, лицензия MIT.
stage — рабочая ветка; master развертывается/публикуется через CI.
По возможности одно изменение пакета на один PR.
Версии каждого пакета независимы (SemVer); увеличивайте версию в package.json, когда планируете релиз.

Полный индекс интеграций, включая серверные SDK в отдельных репозиториях и плагин для WordPress, находится по адресу postio.co.uk/integrations.