@syra.fm/sdk 0.7.0 → 0.9.0

package/lib/typescript/module/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,mFAAmF;AACnF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,yBAAyB;AACzB,MAAM,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,mFAAmF;AACnF,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,yBAAyB;AACzB,MAAM,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syra.fm/sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Syra SDK — headless, isomorphic catalog client (Node/React-free, public reads + 30s previews) that also ships the Syra live-rooms engine (audio rooms over LiveKit) on React Native and web.",
   "source": "src/index.ts",
   "main": "lib/commonjs/index.js",
@@ -51,6 +51,7 @@
   },
   "scripts": {
     "build": "bob build",
+    "prepare": "bun run build",
     "clean": "rm -rf lib",
     "typecheck": "tsc --noEmit -p tsconfig.build.json",
     "test": "bun test src",
@@ -82,14 +83,14 @@
     ]
   },
   "dependencies": {
-    "zod": "^3.25.76"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "react": "^19.2.3",
     "react-native": "^0.85.3",
     "react-native-reanimated": "^4.3.1",
     "react-native-safe-area-context": "^5.7.0",
-    "@oxyhq/services": "^15.0.0",
+    "@oxyhq/services": "^22.13.1 || ^23.0.0 || ^24.0.0 || ^25.0.0 || ^26.0.0",
     "livekit-client": "^2.20.0",
     "@livekit/react-native": "^2.11.1",
     "expo-audio": "~56.0.12",
@@ -150,7 +151,7 @@
     "react-native": "^0.85.3",
     "react-native-reanimated": "^4.3.1",
     "react-native-safe-area-context": "^5.7.0",
-    "@oxyhq/services": "^15.0.0",
+    "@oxyhq/services": "^25.0.1",
     "livekit-client": "^2.20.0",
     "@livekit/react-native": "^2.11.1",
     "expo-audio": "~56.0.12",

package/src/index.native.ts

@@ -1,2 +1,8 @@
+// Native/web-app entrypoint. The package `exports` map routes the `react-native`
+// and `browser` conditions HERE, so Expo/RN consumers get the live-rooms engine on
+// top of the base SDK. Plain Node resolution (`import`/`require`/`default`) lands on
+// `./index`, which deliberately omits `./live` — the engine needs react-native peers
+// that cannot load off-device. Exposure of live is therefore a property of the
+// CONSUMER's resolution conditions, not of `@syra.fm/sdk`.
 export * from './index';
 export * from './live';

package/src/index.ts

@@ -1,3 +1,8 @@
+// Base entrypoint: the platform-agnostic API client + schemas. The live-rooms
+// engine is intentionally NOT re-exported here — it needs react-native peers, so it
+// ships from `./index.native`, which the `exports` map serves to the `react-native`
+// and `browser` conditions. A Node consumer resolving `@syra.fm/sdk` gets THIS file
+// and will not find the live exports; that is by design, not a missing export.
 export {
   createSyraClient,
   DEFAULT_SYRA_BASE_URL,

package/src/live/hooks/useRoomAudio.ts

@@ -6,7 +6,11 @@ import { useLiveConfig } from '../context/LiveConfigContext';
 
 let AudioSession: { startAudioSession: () => void; stopAudioSession: () => void } | null = null;
 if (Platform.OS !== 'web') {
-  try { AudioSession = require('@livekit/react-native').AudioSession; } catch {}
+  try {
+    AudioSession = require('@livekit/react-native').AudioSession;
+  } catch (err) {
+    console.warn('[RoomAudio] @livekit/react-native AudioSession unavailable; continuing without explicit audio session management:', err);
+  }
 }
 
 interface UseRoomAudioOptions {
@@ -37,7 +41,9 @@ export function useRoomAudio({ roomId, isSpeaker, isMuted, isConnected }: UseRoo
     (async () => {
       try {
         await setAudioModeAsync({ shouldPlayInBackground: true, playsInSilentMode: true, interruptionMode: 'duckOthers' });
-      } catch {}
+      } catch (err) {
+        console.warn('[RoomAudio] Failed to set audio mode:', err);
+      }
       if (AudioSession) AudioSession.startAudioSession();
     })();
     return () => { if (AudioSession) AudioSession.stopAudioSession(); };

package/src/live/hooks/useRoomConnection.ts

@@ -112,7 +112,12 @@ export function useRoomConnection({
         setParticipants(res.participants);
         hasJoined.current = true;
         if (introSound) {
-          try { const player = createAudioPlayer(introSound); player.play(); } catch {}
+          try {
+            const player = createAudioPlayer(introSound);
+            player.play();
+          } catch (err) {
+            console.warn('[RoomConnection] Failed to play intro sound:', err);
+          }
         }
       }
     });

package/src/live/services/spaceSocketService.ts

@@ -26,7 +26,7 @@ export class RoomSocketService {
       this.socket = null;
     }
 
-    const baseUrl = this.socketUrl || 'ws://localhost:3000';
+    const baseUrl = this.socketUrl || 'ws://localhost:4120';
 
     this.socket = io(`${baseUrl}/rooms`, {
       transports: ['websocket', 'polling'],

package/src/live/services/spacesService.ts

@@ -1,4 +1,4 @@
-import type { Room, Recording, House, HttpClient } from '../types';
+import type { Room, Recording, House, HouseVisibility, HttpClient } from '../types';
 import { validateRooms, validateRoom, validateRecordings, validateRecording, validateHouse, ZStartStreamResponse, ZGenerateStreamKeyResponse } from '../validation';
 
 export interface CreateRoomData {
@@ -45,8 +45,8 @@ export interface EpisodeListItem {
 /**
  * A single Syra music track row for the listening-party picker. Like the podcast
  * rows it carries NO audio URL — the playable source (presigned original /
- * tokenized HLS / Audius passthrough) stays server-owned and is resolved at
- * stream-start by the backend from the opaque `trackId` alone.
+ * tokenized HLS) stays server-owned and is resolved at stream-start by the
+ * backend from the opaque `trackId` alone.
  */
 export interface MusicTrackResult {
   trackId: string;
@@ -630,7 +630,7 @@ export function createRoomsService(httpClient: HttpClient) {
 
     // --- Houses ---
 
-    async createHouse(data: { name: string; description?: string; tags?: string[]; isPublic?: boolean }): Promise<House | null> {
+    async createHouse(data: { name: string; description?: string; tags?: string[]; visibility?: Partial<HouseVisibility> }): Promise<House | null> {
       try {
         const res = await httpClient.post("/houses", data);
         const raw = res.house || res.data || res || null;

package/src/live/types.ts

@@ -6,6 +6,7 @@ export type {
   Recording,
   House,
   HouseMember,
+  HouseVisibility,
   Series,
   SeriesEpisode,
   Recurrence,

package/src/live/validation.ts

@@ -103,6 +103,20 @@ export const ZHouseMember = z.object({
 
 export type HouseMember = z.infer<typeof ZHouseMember>;
 
+/**
+ * House visibility as three orthogonal axes — mirrors the backend `House`
+ * model. `discovery` (who can find it), `rooms` (who can see/enter its rooms),
+ * `join` (how one becomes a member). See the backend model for the full
+ * contract.
+ */
+export const ZHouseVisibility = z.object({
+  discovery: z.enum(['listed', 'unlisted', 'hidden']).default('listed'),
+  rooms: z.enum(['anyone', 'members']).default('anyone'),
+  join: z.enum(['anyone', 'invite']).default('invite'),
+}).passthrough();
+
+export type HouseVisibility = z.infer<typeof ZHouseVisibility>;
+
 export const ZHouse = z.object({
   _id: z.string(),
   id: z.string().optional(),
@@ -110,9 +124,12 @@ export const ZHouse = z.object({
   description: z.string().optional(),
   avatar: z.string().optional().nullable(),
   coverImage: z.string().optional().nullable(),
+  // Withheld from non-members of a `rooms: members` house; `memberCount` is sent
+  // in its place. Both survive `.passthrough()`.
   members: z.array(ZHouseMember).default([]),
+  memberCount: z.number().optional(),
   createdBy: z.string(),
-  isPublic: z.boolean().default(true),
+  visibility: ZHouseVisibility.default({ discovery: 'listed', rooms: 'anyone', join: 'invite' }),
   tags: z.array(z.string()).optional(),
   createdAt: z.string(),
 }).passthrough();