matecitodb-rn
v0.0.2
Published
SDK oficial de Matecito para React Native
Maintainers
Readme
🧉 matecitodb-rn v0.0.1 (Beta)
Nota: Este SDK es un complemento totalmente individual de
matecitodb. Está optimizado específicamente para las necesidades nativas de React Native, operando de forma independiente para ofrecer persistencia y comunicación en tiempo real.
🚀 Instalación
npm install matecitodb-rn
npm install @react-native-async-storage/async-storage⚡ Quick Start (RN Hook)
La forma más fácil de usarlo es mediante el hook useMatecito:
import { useMatecito } from 'matecitodb-rn'
const App = () => {
const { db, user, isLoggedIn, loading } = useMatecito('https://miapp.matecito.dev')
if (loading) return <ActivityIndicator />
return (
<View>
{isLoggedIn ? <Text>Hola {user.name}</Text> : <Button title="Login" />}
</View>
)
}🔐 Inicialización Manual
Si no usas el hook, recuerda llamar a initialize() para cargar la sesión desde el almacenamiento persistente:
import { createClient } from 'matecitodb-rn'
const db = createClient('https://miapp.matecito.dev')
async function startup() {
await db.auth.initialize() // Carga sesión desde AsyncStorage
if (db.auth.isLoggedIn) {
console.log('Sesión recuperada')
}
}📁 Subida de Archivos en RN
A diferencia de la versión web, aquí usamos objetos con uri:
await db.from('fotos').insert({
titulo: 'Nueva foto',
imagen: {
uri: 'file:///path/to/image.jpg',
name: 'perfil.jpg',
type: 'image/jpeg'
}
})📡 Realtime vía WebSockets
Debido a que React Native no soporta EventSource, este SDK usa WebSockets nativos e implementa el protocolo de Matecito automáticamente.
const unsubscribe = db.from('mensajes').subscribe((event) => {
console.log('Nuevo mensaje:', event.record.texto)
})🏗️ Requisitos
- React Native >= 0.70
- @react-native-async-storage/async-storage
Hecho con ❤️ por Matecito. 🧉 Mantenlo móvil, mantenlo matecito.
