@couch-kit/host 1.0.0 → 1.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/host",
-  "version": "1.0.0",
+  "version": "1.1.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

@@ -0,0 +1,107 @@
+import { useEffect, useState } from "react";
+import { Paths, Directory, File } from "expo-file-system";
+import { Platform } from "react-native";
+import { toErrorMessage } from "@couch-kit/core";
+
+export interface AssetManifest {
+  files: string[];
+}
+
+export interface ExtractAssetsResult {
+  /** The filesystem path to the extracted www directory, or undefined if not ready */
+  staticDir: string | undefined;
+  /** Whether extraction is in progress */
+  loading: boolean;
+  /** Error message if extraction failed */
+  error: string | null;
+}
+
+/**
+ * Extracts bundled web assets from the APK to the filesystem so the native
+ * HTTP server can serve them.
+ *
+ * On Android, assets live inside the APK and cannot be served directly by
+ * a native HTTP server. This hook copies each file listed in the manifest
+ * from `asset:///www/<file>` to `<Paths.document>/www/<file>`.
+ *
+ * On iOS, assets are accessible from the bundle directory, so extraction
+ * is skipped and `staticDir` is returned as `undefined` (the server falls
+ * back to the bundle path).
+ *
+ * @param manifest - The asset manifest generated by `couch-kit bundle`.
+ *                   Contains a `files` array listing all relative paths.
+ */
+export function useExtractAssets(manifest: AssetManifest): ExtractAssetsResult {
+  const [staticDir, setStaticDir] = useState<string | undefined>(undefined);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    // iOS: skip extraction, server uses bundle path fallback
+    if (Platform.OS !== "android") {
+      setLoading(false);
+      return;
+    }
+
+    let cancelled = false;
+
+    const extractAssets = async () => {
+      try {
+        const documentDir = Paths.document;
+        const targetDir = new Directory(documentDir, "www");
+
+        // Clean previous extraction to ensure fresh assets after app updates
+        if (targetDir.exists) {
+          targetDir.delete();
+        }
+
+        // Create the root target directory
+        targetDir.create({ intermediates: true });
+
+        // Copy each file from APK assets to filesystem
+        for (const filePath of manifest.files) {
+          if (cancelled) return;
+
+          const sourceFile = new File(`asset:///www/${filePath}`);
+          const destFile = new File(targetDir, filePath);
+
+          // Ensure subdirectory exists (e.g., "assets/" in "assets/index.js")
+          const lastSlash = filePath.lastIndexOf("/");
+          if (lastSlash > 0) {
+            const subDir = new Directory(
+              targetDir,
+              filePath.substring(0, lastSlash),
+            );
+            subDir.create({ intermediates: true, idempotent: true });
+          }
+
+          sourceFile.copy(destFile);
+        }
+
+        if (cancelled) return;
+
+        // Strip file:// prefix for the native HTTP server
+        const rawPath = targetDir.uri.replace(/^file:\/\//, "");
+        setStaticDir(rawPath);
+      } catch (e) {
+        if (!cancelled) {
+          const message = toErrorMessage(e);
+          console.warn("[CouchKit] Asset extraction failed:", message);
+          setError(message);
+        }
+      } finally {
+        if (!cancelled) {
+          setLoading(false);
+        }
+      }
+    };
+
+    extractAssets();
+
+    return () => {
+      cancelled = true;
+    };
+  }, [manifest]);
+
+  return { staticDir, loading, error };
+}

package/src/declarations.d.ts

@@ -2,6 +2,9 @@
  * Minimal type definition for the raw TCP socket provided by react-native-tcp-socket.
  * Covers only the API surface used by GameWebSocketServer.
  */
+
+import type { Buffer } from "buffer";
+
 export interface TcpSocketInstance {
   write(data: string | Buffer): void;
   destroy(): void;

package/src/index.tsx

@@ -1,4 +1,5 @@
-export * from './provider';
-export * from './server';
-export * from './websocket';
-export * from './network';
+export * from "./provider";
+export * from "./server";
+export * from "./websocket";
+export * from "./network";
+export * from "./assets";

package/src/server.ts

@@ -51,9 +51,9 @@ export const useStaticServer = (config: CouchKitHostConfig) => {
       try {
         // Use staticDir if provided (required on Android where bundle path is undefined),
         // otherwise fall back to the iOS bundle directory via expo-file-system
+        const bundleUri = Paths.bundle.uri;
         const path =
-          config.staticDir ||
-          `${Paths.bundle.uri.replace(/^file:\/\//, "")}www`;
+          config.staticDir || `${bundleUri.replace(/^file:\/\//, "")}www`;
         const port = config.port || DEFAULT_HTTP_PORT;
 
         server = new StaticServer();