Leyenda de estados
Cada SDK a continuación lleva una de dos etiquetas de estado, alineadas con la matriz de soporte de la plataforma XID. Ninguna etiqueta es una declaración de disponibilidad para producción.
| Estado | Significado |
|---|---|
| Paquete actual | Paquete TypeScript mantenido en el repositorio XID con código fuente, pruebas y configuración de workspace. |
| Implementado · verificado localmente | SDK nativo que compila y pasa su suite de pruebas unitarias en una cadena de herramientas local. Una prueba de ida y vuelta contra un IdP real de producción aún requiere verificación manual. |
SDK del lado del servidor
Los entornos de ejecución compatibles con estándares web (Cloudflare Workers, Node.js, Bun, Deno) comparten @xid-kit/backend a través de Web Crypto. Otros lenguajes disponen de SDK nativos. Todos realizan verificación JWT sin llamadas de red, autenticación de solicitudes y verificación de webhooks.
| Entorno de ejecución o lenguaje | Paquete o directorio | Estado | Responsabilidad |
|---|---|---|---|
| Cloudflare Workers | @xid-kit/backend |
Paquete actual | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Node.js | @xid-kit/backend |
Paquete actual | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Bun | @xid-kit/backend |
Paquete actual | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Deno | @xid-kit/backend |
Paquete actual | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Go | sdk/go |
Implementado · verificado localmente | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Java | sdk/java |
Implementado · verificado localmente | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Rust | sdk/rust |
Implementado · verificado localmente | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| PHP | sdk/php |
Implementado · verificado localmente | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Ruby | sdk/ruby |
Implementado · verificado localmente | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| Python | sdk/python |
Implementado · verificado localmente | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
| .NET | sdk/dotnet |
Implementado · verificado localmente | Verificación de JWT sin red, autenticación de solicitudes y verificación de webhooks. |
SDK de cliente: frameworks web
| Framework | Paquete o directorio | Estado | Responsabilidad |
|---|---|---|---|
| Vanilla JS / Web | @xid-kit/core |
Paquete actual | Cliente de navegador, almacén de sesiones, caché de tokens y utilidades de Management API. |
| React | @xid-kit/react |
Paquete actual | Provider, hooks, componentes de control, interfaz de usuario e interfaz de organización. |
| Next.js | @xid-kit/nextjs |
Paquete actual | Middleware, utilidades de App Router, utilidades de Pages Router y reexportaciones de React. |
| Vue | @xid-kit/vue |
Paquete actual | Provider, hooks o composables, y componentes prediseñados de usuario y organización. |
| Nuxt | @xid-kit/nuxt |
Paquete actual | Provider, hooks o composables, y componentes prediseñados de usuario y organización. |
| Svelte / SvelteKit | @xid-kit/svelte |
Paquete actual | Provider, hooks o composables, y componentes prediseñados de usuario y organización. |
| Angular | @xid-kit/angular |
Paquete actual | Provider, hooks o composables, y componentes prediseñados de usuario y organización. |
| Remix | @xid-kit/remix |
Paquete actual | Provider, hooks o composables, y componentes prediseñados de usuario y organización. |
| Astro | @xid-kit/astro |
Paquete actual | Provider, hooks o composables, y componentes prediseñados de usuario y organización. |
| SolidJS | @xid-kit/solid |
Paquete actual | Provider, hooks o composables, y componentes prediseñados de usuario y organización. |
SDK de cliente: móvil
| Plataforma | Paquete o directorio | Estado | Responsabilidad |
|---|---|---|---|
| React Native | @xid-kit/react-native |
Paquete actual | Contrato de redirección alojada, callback de enlace profundo, PKCE S256 y adaptador de almacenamiento seguro. |
| Expo | @xid-kit/expo |
Paquete actual | Integración con Expo Router, AuthSession y adaptador SecureStore. |
| Flutter | sdk/flutter |
Implementado · verificado localmente | Redirección a Hosted Auth, callback de app link y adaptador de almacenamiento seguro. |
| iOS | sdk/ios |
Implementado · verificado localmente | ASWebAuthenticationSession, almacenamiento en Keychain y PKCE S256. |
| Android | sdk/android |
Implementado · verificado localmente | Custom Tabs, App Links, almacenamiento respaldado por Keystore y PKCE S256. |
SDK de cliente: escritorio
| Plataforma | Paquete o directorio | Estado | Responsabilidad |
|---|---|---|---|
| macOS | sdk/macos |
Implementado · verificado localmente | ASWebAuthenticationSession, almacenamiento en Keychain y PKCE S256. |
| Windows | sdk/windows |
Implementado · verificado localmente | Redirección WebView2, almacenamiento seguro DPAPI y PKCE S256. |
| Linux | sdk/linux |
Implementado · verificado localmente | Redirección del navegador del sistema, almacenamiento en Secret Service y PKCE S256. |
| Electron | @xid-kit/electron |
Paquete actual | Bridge entre proceso principal y renderer, safeStorage y callbacks de loopback o esquema personalizado. |
| Tauri | @xid-kit/tauri |
Paquete actual | Bridge backend en Rust, llavero del SO y PKCE S256. |
Contrato nativo compartido
- Los clientes públicos nativos usan código de autorización con PKCE S256. El flujo implícito y el grant de contraseña no son compatibles.
- Los callbacks de redirección son enlaces de aplicación reclamados, enlaces universales, esquemas personalizados o URLs de callback equivalentes de la plataforma.
- Los adaptadores de almacenamiento mantienen los refresh tokens o los valores de caché de sesión en el almacenamiento seguro de la plataforma y nunca almacenan secretos de cliente.
- Los SDK nativos JS y TS (React Native, Expo) usan un modelo de provider React más hooks: XidProvider, useSignIn y useSignOut.
- Los demás SDK nativos (iOS, Android, Flutter, escritorio) usan una superficie de API funcional con configure, signIn y handleRedirect.
Guías de paquetes
Cada SDK tiene una página de referencia dedicada con pasos de instalación, tablas de API y ejemplos listos para copiar. El grupo de paquetes SDK en la barra lateral lista todas las páginas de referencia; los paquetes web más usados son:
- @xid-kit/core — sesión en navegador, tokens, utilidades de la API de administración.
- @xid-kit/backend — verificación JWT sin llamadas de red, autenticación de solicitudes, webhooks.
- @xid-kit/react — provider, hooks, componentes de control e interfaz.
- @xid-kit/nextjs — middleware y utilidades de servidor para App Router y Pages Router.
- @xid-kit/react-native — redirección a Hosted Auth, PKCE S256 y almacenamiento seguro de tokens para apps nativas.