@couch-kit/host 1.3.0 → 1.3.1

package/README.md

@@ -26,10 +26,10 @@ Then install the required peer dependencies:
 
 ```bash
 npx expo install expo-file-system expo-network
-bun add react-native-tcp-socket
+bun add react-native-tcp-socket react-native-nitro-modules
 ```
 
-> **Note:** This library requires Expo modules (`expo-file-system`, `expo-network`) and `react-native-tcp-socket` as peer dependencies. These must be installed in your consumer app. React Native's autolinking will handle native setup automatically.
+> **Note:** This library requires Expo modules (`expo-file-system`, `expo-network`), `react-native-tcp-socket`, and `react-native-nitro-modules` as peer dependencies. These must be installed in your consumer app. React Native's autolinking will handle native setup automatically.
 
 ## Compatibility
 
@@ -45,8 +45,6 @@ bun add react-native-tcp-socket
 
 > **New Architecture:** This package supports React Native's New Architecture (Fabric/TurboModules) via React Native 0.83+.
 
-## Usage
-
 ## API
 
 ### `<GameHostProvider config={...}>`
@@ -71,6 +69,36 @@ Returns:
 - `serverUrl`: HTTP URL phones should open (or `devServerUrl` in dev mode)
 - `serverError`: static server error (if startup fails)
 
+### `useExtractAssets(manifest)`
+
+Extracts bundled web assets from the APK to a writable directory so the native HTTP server can serve them.
+
+On Android, assets live inside the APK and cannot be served directly. This hook copies each file listed in the manifest from the APK to the device filesystem. On iOS, extraction is skipped since assets are accessible from the bundle directory.
+
+```tsx
+import { useExtractAssets } from "@couch-kit/host";
+import manifest from "./www/manifest.json";
+
+function App() {
+  const { staticDir, loading, error } = useExtractAssets(manifest);
+
+  if (loading) return <Text>Extracting assets...</Text>;
+  if (error) return <Text>Error: {error}</Text>;
+
+  return (
+    <GameHostProvider config={{ staticDir, reducer, initialState }}>
+      ...
+    </GameHostProvider>
+  );
+}
+```
+
+| Property    | Type                  | Description                                       |
+| ----------- | --------------------- | ------------------------------------------------- |
+| `staticDir` | `string \| undefined` | Filesystem path to extracted assets, or undefined |
+| `loading`   | `boolean`             | Whether extraction is in progress                 |
+| `error`     | `string \| null`      | Error message if extraction failed                |
+
 ## System Actions
 
 The host automatically dispatches internal system actions (`__PLAYER_JOINED__`, `__PLAYER_LEFT__`, `__PLAYER_RECONNECTED__`, `__PLAYER_REMOVED__`, `__HYDRATE__`) into `createGameReducer`, which handles them for you. **You do not need to handle these in your reducer.**
@@ -161,6 +189,8 @@ To iterate on your web controller without rebuilding the Android app constantly:
 ```tsx
 <GameHostProvider
     config={{
+        reducer: gameReducer,
+        initialState,
         devMode: true,
         devServerUrl: 'http://192.168.1.50:5173' // Your laptop's IP
     }}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/host",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "React Native host for local multiplayer party games on Android TV — WebSocket server, state management, and static file serving",
   "license": "MIT",
   "repository": {

package/src/assets.ts

@@ -1,6 +1,6 @@
 import { useEffect, useState } from "react";
 import * as FileSystem from "expo-file-system";
-import { Paths, Directory } from "expo-file-system/next";
+import { Paths, Directory } from "expo-file-system";
 import { Platform } from "react-native";
 import { toErrorMessage } from "@couch-kit/core";
 

package/src/server.ts

@@ -1,6 +1,6 @@
 import { useEffect, useState } from "react";
 import { StaticServer } from "react-native-nitro-http-server";
-import { Paths } from "expo-file-system/next";
+import { Paths } from "expo-file-system";
 import { getBestIpAddress } from "./network";
 import { DEFAULT_HTTP_PORT, toErrorMessage } from "@couch-kit/core";
 
@@ -58,7 +58,7 @@ export const useStaticServer = (config: CouchKitHostConfig) => {
           if (!bundleUri) {
             throw new Error(
               "No staticDir provided and Paths.bundle is unavailable. " +
-              "On Android, you must pass staticDir from useExtractAssets.",
+                "On Android, you must pass staticDir from useExtractAssets.",
             );
           }
           path = `${bundleUri.replace(/^file:\/\//, "")}www`;