postio-integrations

Name: Postio
Author: postio-uk

Los paquetes npm de la familia JS, la superficie de IA / agente y el Worker cdn.postio.co.uk que impulsa el componente de navegador de Postio.

La API de Postio + la especificación OpenAPI residen en postio-uk/postio-api. La especificación también se publica como @postio/openapi.

Paquetes

Paquete	Qué es
`@postio/api-types`	Tipos de TypeScript generados a partir de la especificación OpenAPI.
`@postio/core`	Cliente tipado independiente del entorno de ejecución (navegador / Node / Workers / Bun / Deno).
`@postio/node`	SDK de Node sobre `core`: reintentos con retroceso exponencial, gancho de registrador estructurado.
`@postio/postman-collection`	Colección de Postman v2.1 para cada endpoint.
`@postio/address-finder`	Autocompletado de direcciones para navegador: cuadro combinado ARIA, personalizable, fuente independiente del framework.
`@postio/address-finder-bundled`	El mismo componente precompilado para su uso mediante etiqueta `<script>`.
`@postio/react`	Hooks de React + componente `<AddressFinder />`, con TanStack Query integrado.
`@postio/mcp`	Servidor del Protocolo de Contexto de Modelo (MCP): `npx -y @postio/mcp` para Claude Desktop / Cursor / Windsurf / Zed.

Estructura

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

Construcción

cd packages
pnpm install
pnpm -r run build

Cada paquete se construye de forma independiente (pnpm -F @postio/<name> run build). El paquete address-finder tiene una peculiaridad de construcción topológica: utilice el sufijo ... para que su dependencia de espacio de trabajo se construya primero:

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

Contribución

Las PR son bienvenidas. Convenciones:

Node 22+, pnpm 10+, solo ESM, con licencia MIT.
stage es la rama de trabajo; master despliega / publica a través de CI.
Un cambio de paquete por PR siempre que sea posible.
Las versiones de cada paquete son SemVer independientes; incremente la versión en package.json cuando pretenda realizar un lanzamiento.

El índice completo de integraciones, incluidos los SDK de servidor en sus propios repositorios y el plugin de WordPress, se encuentra en postio.co.uk/integrations.