postio-integrations

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

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

Пакеты

Related MCP server: APITier MCP Server

Структура

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.

Лицензия

MIT.