postio-integrations

JS 계열 npm 패키지, AI/에이전트 인터페이스, 그리고 Postio의 브라우저 드롭인을 구동하는 cdn.postio.co.uk 워커입니다.

Postio API 및 OpenAPI 사양은 postio-uk/postio-api에 있습니다. 해당 사양은 @postio/openapi로도 게시됩니다.

패키지

레이아웃

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 번들에는 위상 빌드(topological-build) 특이 사항이 있으므로 ... 접미사를 사용하여 워크스페이스 의존성이 먼저 빌드되도록 하십시오:

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.