test: add Expo compatibility CI job

.github/workflows/ci.yml

@@ -78,12 +78,28 @@ jobs:
         run: |
           supabase start
 
-      - name: Run tests
+      - name: Prepare integration tests
         run: |
           npm clean-install
+          npm run build
+          npm pack
+
+      - name: Run integration tests
+        run: |
           npm run test:integration || npm run test:integration
+
+      - name: Run browser integration tests
+        run: |
           npm run test:integration:browser
 
+      - name: Run expo compatibility tests
+        run: |
+          cd examples/expo-app
+          npm install
+          # make sure we're using the version that was just packed above
+          npm update @supabase/supabase-js
+          npm run test || npm run test
+
       - name: Stop Supabase
         run: |
           supabase stop

examples/expo-app/.gitignore

@@ -0,0 +1,39 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+app-example

examples/expo-app/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "explicit",
+    "source.organizeImports": "explicit",
+    "source.sortMembers": "explicit"
+  }
+}

examples/expo-app/README.md

@@ -0,0 +1,50 @@
+# Welcome to your Expo app 👋
+
+This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app).
+
+## Get started
+
+1. Install dependencies
+
+   ```bash
+   npm install
+   ```
+
+2. Start the app
+
+   ```bash
+   npx expo start
+   ```
+
+In the output, you'll find options to open the app in a
+
+- [development build](https://docs.expo.dev/develop/development-builds/introduction/)
+- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
+- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
+- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
+
+You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
+
+## Get a fresh project
+
+When you're ready, run:
+
+```bash
+npm run reset-project
+```
+
+This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing.
+
+## Learn more
+
+To learn more about developing your project with Expo, look at the following resources:
+
+- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides).
+- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.
+
+## Join the community
+
+Join our community of developers creating universal apps.
+
+- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute.
+- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions.

examples/expo-app/__tests__/Index.test.tsx

@@ -0,0 +1,36 @@
+import { render, waitFor, cleanup } from '@testing-library/react-native'
+import Index from '../app/index.tsx'
+
+describe('Index', () => {
+  afterEach(() => {
+    cleanup()
+  })
+
+  it('should display SUBSCRIBED status when realtime connection is established', async () => {
+    const { getByTestId, unmount } = render(<Index />)
+
+    // Initially, the text should be empty
+    expect(getByTestId('realtime_status')).toHaveTextContent('')
+
+    // Wait for the subscription status to be updated
+    await waitFor(
+      () => {
+        const status = getByTestId('realtime_status').props.children
+        expect(status).toBe('SUBSCRIBED')
+      },
+      {
+        timeout: 30000, // 30 seconds timeout for waitFor
+        interval: 1000, // Check every second
+        onTimeout: (error) => {
+          const currentStatus = getByTestId('realtime_status').props.children
+          throw new Error(
+            `Timeout waiting for SUBSCRIBED status. Current status: ${currentStatus}. ${error.message}`
+          )
+        },
+      }
+    )
+
+    // Unmount the component to trigger cleanup.
+    unmount()
+  }, 35000) // 35 seconds timeout for the entire test
+})

examples/expo-app/app.json

@@ -0,0 +1,42 @@
+{
+  "expo": {
+    "name": "expo-app",
+    "slug": "expo-app",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/images/icon.png",
+    "scheme": "expoapp",
+    "userInterfaceStyle": "automatic",
+    "newArchEnabled": true,
+    "ios": {
+      "supportsTablet": true
+    },
+    "android": {
+      "adaptiveIcon": {
+        "foregroundImage": "./assets/images/adaptive-icon.png",
+        "backgroundColor": "#ffffff"
+      },
+      "edgeToEdgeEnabled": true
+    },
+    "web": {
+      "bundler": "metro",
+      "output": "static",
+      "favicon": "./assets/images/favicon.png"
+    },
+    "plugins": [
+      "expo-router",
+      [
+        "expo-splash-screen",
+        {
+          "image": "./assets/images/splash-icon.png",
+          "imageWidth": 200,
+          "resizeMode": "contain",
+          "backgroundColor": "#ffffff"
+        }
+      ]
+    ],
+    "experiments": {
+      "typedRoutes": true
+    }
+  }
+}

examples/expo-app/app/_layout.tsx

@@ -0,0 +1,5 @@
+import { Stack } from 'expo-router'
+
+export default function RootLayout() {
+  return <Stack />
+}

examples/expo-app/app/index.tsx

@@ -0,0 +1,40 @@
+import { Text, View } from 'react-native'
+import { useState, useEffect } from 'react'
+import { createClient } from '@supabase/supabase-js'
+
+const SUPABASE_URL = 'http://127.0.0.1:54321'
+const ANON_KEY =
+  'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24iLCJleHAiOjE5ODM4MTI5OTZ9.CRXP1A7WOeoJeXxjNni43kdQwgnWNReilDMblYTn_I0'
+
+const supabase = createClient(SUPABASE_URL, ANON_KEY)
+
+export default function Index() {
+  const [realtimeStatus, setRealtimeStatus] = useState<string | null>(null)
+  const channel = supabase.channel('realtime:public:todos')
+
+  useEffect(() => {
+    if (channel.state === 'closed') {
+      channel.subscribe((status) => {
+        if (status === 'SUBSCRIBED') setRealtimeStatus(status)
+      })
+    }
+
+    return () => {
+      channel.unsubscribe()
+      supabase.realtime.disconnect()
+    }
+  }, [])
+
+  return (
+    <View
+      style={{
+        flex: 1,
+        justifyContent: 'center',
+        alignItems: 'center',
+        backgroundColor: '#fff',
+      }}
+    >
+      <Text testID="realtime_status">{realtimeStatus || ''}</Text>
+    </View>
+  )
+}

examples/expo-app/eslint.config.js

@@ -0,0 +1,10 @@
+// https://docs.expo.dev/guides/using-eslint/
+const { defineConfig } = require('eslint/config')
+const expoConfig = require('eslint-config-expo/flat')
+
+module.exports = defineConfig([
+  expoConfig,
+  {
+    ignores: ['dist/*'],
+  },
+])