crowdplaysdk 0.6.0 → 0.6.2

package/README.md

@@ -165,6 +165,7 @@ CrowdPlay.addListener('phase', …)         // idle / connecting / connected / f
 CrowdPlay.addListener('participants', …)  // who to render tiles for
 CrowdPlay.addListener('uploads', …)       // per-session progress
 CrowdPlay.addListener('warning', …)       // micSilent / clipping / crossTalk: show these
+CrowdPlay.addListener('storageWarning', …) // optional: message set = storage low (audio only or stopped)
 CrowdPlay.addListener('recording', …)     // error means NOT capturing; offer retryRecording()
 CrowdPlay.addListener('audioRoute', …)    // current output device, for the output menu
 CrowdPlay.setAudioOutput('speaker')       // or 'automatic' (the connected device)
@@ -223,29 +224,39 @@ backend reachability and your app key. Every failing check names its own
 fix. Then record a one-minute session on a real device and confirm the
 upload finishes.
 
-## Accessing your recordings
+## Checking your sessions
 
-Your app key is also your data-access credential: plain HTTPS, no AWS
+Your app key also lists the sessions it recorded, over plain HTTPS: no AWS
 account, no SDK required.
 
 ```bash
-BASE=https://dashboard.crowdplay.ai
-
-curl -H "x-liva-key: $APP_KEY" $BASE/sessions
-curl -H "x-liva-key: $APP_KEY" $BASE/sessions/<sessionId>/files
+curl -H "x-liva-key: $APP_KEY" https://dashboard.crowdplay.ai/sessions
 ```
 
-`deliverable/` holds what you actually use: one clean audio file per
-person, aligned so they play together with no offset, plus a mixed version
-and a quality report. You can only reach sessions recorded with your key.
+Each row carries the session id, its state (`uploading`, `ok`, `partial`
+or `failed`), the participants, participant minutes and any quality
+warnings. You only see sessions recorded with your key, and the dashboard
+shows the same list. Use it to confirm that sessions upload and render.
+
+The recordings themselves stay in CrowdPlay's storage. There is no
+download endpoint for builders: `GET /sessions/<sessionId>/files` answers
+403 to an app key, and the dashboard does not offer downloads either.
 
 ## Things to know
 
 - **Don't force-quit the app** after a session: iOS pauses background
   transfers until next launch. They resume automatically and nothing is
   lost.
-- Sessions are roughly 2 GB per participant-hour, dominated by video. The
-  SDK refuses to join below 8 GB free disk.
+- With video, a session uses about 6.8 GB per participant-hour on the phone
+  (1080p HEVC at 14 Mbps plus 24-bit audio); audio-only is about 0.5 GB.
+  Files are deleted as each one uploads. Video waits for WiFi, so on
+  cellular it stays on the phone until then. The SDK never fills the phone
+  (0.6.2+, engine 0.5.4): under 2 GB free the recording continues audio
+  only, under 500 MB it stops, and the call itself always continues. This
+  happens silently: the SDK shows nothing on screen. The `storageWarning`
+  event says when it happens, if you want to ask the user to free up space.
+  `doctor()` also checks free disk (8 GiB by default); joining never
+  refuses for storage.
 - Participants should wear **wired or closed-back headphones**. A
   loudspeaker pipes the far end into the local mic and contaminates the
   track; the SDK surfaces this live through the `warning` event.

package/ios/CrowdPlayRNModule.swift

@@ -63,6 +63,15 @@ final class CrowdPlayRNCore {
                 ])
             }.store(in: &cancellables)
 
+        // Storage (D-148): its own event, not a 'warning' kind, so an app
+        // that renders every warning does not start showing it. Sent on
+        // every change, since the text moves from audio-only to stopped.
+        engine.$storageWarning
+            .removeDuplicates()
+            .sink { [weak self] message in
+                self?.send("crowdplay:storageWarning", ["message": message as Any])
+            }.store(in: &cancellables)
+
         engine.$uploads
             .combineLatest(engine.$uploadsOnWiFi)
             .sink { [weak self] uploads, onWifi in
@@ -231,7 +240,7 @@ public final class CrowdPlayRNModule: RCTEventEmitter {
     public override static func requiresMainQueueSetup() -> Bool { true }
 
     public override func supportedEvents() -> [String]! {
-        ["crowdplay:phase", "crowdplay:recording", "crowdplay:uploads", "crowdplay:participants", "crowdplay:warning", "crowdplay:audioRoute", "crowdplay:voiceActivity", "crowdplay:caption", "crowdplay:agentToolCall"]
+        ["crowdplay:phase", "crowdplay:recording", "crowdplay:uploads", "crowdplay:participants", "crowdplay:warning", "crowdplay:storageWarning", "crowdplay:audioRoute", "crowdplay:voiceActivity", "crowdplay:caption", "crowdplay:agentToolCall"]
     }
 
     @objc public func startVoiceActivityUpdates() {

package/ios/wire.rb

@@ -30,7 +30,8 @@ SDK_URL = 'https://github.com/symbiateam/crowdplaysdk'
 # D-103 the bridge calls 0.5.0 APIs, and npm 0.5.0 to 0.5.2 shipped with
 # this still at 0.4.0, which broke every install (D-121). publish_rn.sh now
 # compiles the bridge against exactly this release before publishing.
-SDK_VERSION = '0.5.2'
+# 0.5.4: the storage guard and engine.storageWarning (D-148).
+SDK_VERSION = '0.5.4'
 BRIDGE_FILES = ['CrowdPlayRNModule.swift', 'CrowdPlayRNVideoView.swift', 'CrowdPlayReactNative.m'].freeze
 
 project_name = ARGV[0] or abort 'usage: ruby wire.rb <YourProjectName>'

package/lib/index.d.ts

@@ -62,7 +62,7 @@ export interface CrowdPlayConfig {
 }
 /** The CrowdPlay Terms of Use and Privacy Notice every participant accepts,
  * as a PDF. CrowdPlayConsentScreen links here; a custom consent UI must too. */
-export declare const CROWDPLAY_TERMS_URL = "https://dashboard.crowdplay.ai/legal/terms.pdf";
+export declare const CROWDPLAY_TERMS_URL = "https://www.crowdplay.ai/legal/consumer-terms";
 /** Proof the participant agreed. Produce it with CrowdPlayConsentScreen, or,
  * if you render your own consent UI, call CrowdPlay.consentText() to show the
  * REQUIRED wording and construct the grant at the moment of agreement. */
@@ -177,6 +177,14 @@ export interface CrowdPlayEvents {
         active: boolean;
         message: string;
     };
+    /** This iPhone is running out of storage (D-148): under 2 GB free the
+     * recording continues audio only, under 500 MB it stops; the call always
+     * continues. `message` is null when storage is fine. The SDK shows
+     * nothing on screen; listening is optional. Separate from `warning` so
+     * apps that render every warning do not start showing it. */
+    storageWarning: {
+        message: string | null;
+    };
     /** The audio output route: current device by name ("AirPods Pro",
      * "iPhone speaker"), connected candidates, and whether headphones are
      * attached. Drive the call screen's output menu from this (D-079). */

package/lib/index.js

@@ -26,7 +26,7 @@ exports.useLatestCaption = exports.useVoiceActivity = exports.VoiceReactive = ex
 const react_native_1 = require("react-native");
 /** The CrowdPlay Terms of Use and Privacy Notice every participant accepts,
  * as a PDF. CrowdPlayConsentScreen links here; a custom consent UI must too. */
-exports.CROWDPLAY_TERMS_URL = 'https://dashboard.crowdplay.ai/legal/terms.pdf';
+exports.CROWDPLAY_TERMS_URL = 'https://www.crowdplay.ai/legal/consumer-terms';
 function native() {
     const module = react_native_1.NativeModules.CrowdPlayReactNative;
     if (!module) {

package/llms.txt

@@ -141,11 +141,6 @@ BARE REACT NATIVE (no Expo):
     detail names its own fix. NOTE: on a fresh install the "permissions"
     check reports "not requested yet (NORMAL)"; iOS prompts at first join.
     That is not an integration bug; only a DENIED state needs action.
-    KNOWN ENGINE BUG: on engine 0.5.1 and 0.5.2 the "consent_terms" check
-    fails on every device (the engine's own hash bookkeeping, fixed in
-    engine 0.5.3 / crowdplaysdk 0.6.1). Nothing in your app causes it and
-    nothing in your app fixes it; the consent screen and the recorded
-    consent are correct. Every other check in that run is valid.
 11. Hand off (REQUIRED final message): the Simulator has no camera or
     mic, so nothing is proven until the app runs on a real iPhone. Do
     not end with "the implementation is complete"; your FINAL message
@@ -329,22 +324,40 @@ Events (CrowdPlay.addListener):
                  // mic; crossTalk = loudspeaker leaking the far end into
                  // this mic (wear headphones); micPolicy = unexpected
                  // input device.
+  'storageWarning' { message: string | null }
+                 // 0.6.2+: non-null = the phone is low on storage: under
+                 // 2 GB free the recording is audio only, under 500 MB it
+                 // stopped. The call continues. The SDK shows nothing
+                 // itself; listening is optional. Kept out of 'warning' so
+                 // apps that render every warning do not show it.
 
-## Accessing recordings (no AWS, no SDK, plain HTTPS)
+## Checking sessions (no AWS, no SDK, plain HTTPS)
 
-The app key doubles as the data credential:
+The app key lists the sessions it recorded, metadata only:
   GET https://dashboard.crowdplay.ai/sessions            (x-liva-key header)
-  GET https://dashboard.crowdplay.ai/sessions/<id>/files (x-liva-key header)
-    -> [{path, bytes, url}]   // url = 1-hour presigned download
-deliverable/ holds the usable output: speaker-<name>.wav per participant
-(drift-corrected; all files play together with NO offset),
-conversation.wav, qc.json. raw/ is the untouched per-device capture.
-Humans use https://dashboard.crowdplay.ai directly (sign in, download).
+    -> [{sessionId, state ("uploading"|"ok"|"partial"|"failed"),
+         participants, participantMinutes, warnings, warningNotes,
+         uploadedAt}]
+A key sees only its own app's sessions; `state: "ok"` proves the
+integration works end to end. The dashboard shows the same list.
+
+Recordings NEVER leave CrowdPlay's storage. There is no download endpoint
+for builders: GET /sessions/<id>/files answers 403 to an app key and to
+dashboard accounts, and the dashboard has no download button. Do NOT
+build any feature that fetches, plays, shows, or analyses a recording
+after the session; the app has no way to obtain one. During the session
+the app can use the `caption` event (voice-AI transcript lines) and
+`snapshot()` (capture health).
 
 ## Facts, limits, troubleshooting
 
-- iOS 17+, React Native >= 0.71. Storage ~2 GB per participant-hour;
-  join refuses below 8 GB free.
+- iOS 17+, React Native >= 0.71. Storage ~6.8 GB per participant-hour with
+  video, ~0.5 GB audio-only (deleted as files upload; video waits for WiFi,
+  so on cellular it stays on the phone until then). The SDK never fills the
+  phone (0.6.2+): under 2 GB free the recording continues audio only, under
+  500 MB it stops, the call always continues, silently ('storageWarning'
+  says so if you listen). doctor() also checks free disk (8 GiB default);
+  join never refuses for storage.
 - Keep the screen awake during sessions (e.g. react-native-keep-awake or
   the idle-timer API); a locked phone suspends capture. Force-quitting
   pauses uploads until next launch (nothing lost).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crowdplaysdk",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "CrowdPlay lossless conversation capture for React Native (iOS). Studio-grade per-participant recording during live video calls, delivered to CrowdPlay automatically.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/index.ts

@@ -71,7 +71,7 @@ export interface CrowdPlayConfig {
 
 /** The CrowdPlay Terms of Use and Privacy Notice every participant accepts,
  * as a PDF. CrowdPlayConsentScreen links here; a custom consent UI must too. */
-export const CROWDPLAY_TERMS_URL = 'https://dashboard.crowdplay.ai/legal/terms.pdf';
+export const CROWDPLAY_TERMS_URL = 'https://www.crowdplay.ai/legal/consumer-terms';
 
 /** Proof the participant agreed. Produce it with CrowdPlayConsentScreen, or,
  * if you render your own consent UI, call CrowdPlay.consentText() to show the
@@ -180,6 +180,12 @@ export interface CrowdPlayEvents {
    * micSilent (dead mic), clipping (too-hot mic), crossTalk (loudspeaker
    * leaking the far end into this mic), micPolicy (unexpected input). */
   warning: { kind: 'audioStalled' | 'micSilent' | 'clipping' | 'crossTalk' | 'micPolicy'; active: boolean; message: string };
+  /** This iPhone is running out of storage (D-148): under 2 GB free the
+   * recording continues audio only, under 500 MB it stops; the call always
+   * continues. `message` is null when storage is fine. The SDK shows
+   * nothing on screen; listening is optional. Separate from `warning` so
+   * apps that render every warning do not start showing it. */
+  storageWarning: { message: string | null };
   /** The audio output route: current device by name ("AirPods Pro",
    * "iPhone speaker"), connected candidates, and whether headphones are
    * attached. Drive the call screen's output menu from this (D-079). */