@pose-tracker/react-native-pose-estimation-light 0.1.0 → 0.2.0

package/src/models/poseModels.ts

@@ -5,9 +5,9 @@
  * MoveNet SinglePose Lightning hosted at app.posetracker.com (same URL as
  * `usePoseDetection` / tracking WebView `modelUrl`).
  *
- * BlazePose is accepted as a `model` alias for API parity but is not wired
- * in the RN WebView yet (needs MediaPipe). Pass a TF.js `modelUrl` for any
- * custom graph model.
+ * BlazePose loads via CDN `@tensorflow-models/pose-detection` inside the
+ * WebView (no graph `modelUrl`). Pass a TF.js `modelUrl` for any custom
+ * graph model.
  */
 
 /** Production MoveNet SinglePose Lightning topology (Front default). */
@@ -32,17 +32,20 @@ export interface ResolvePoseModelOptions {
   modelUrl?: string;
 }
 
+export type PoseModelKind = 'movenet-graph' | 'blazepose' | 'custom-graph' | 'unsupported';
+
 export interface ResolvedPoseModel {
   /** Stable id reported in diagnostics / track params. */
   modelId: string;
-  /** TF.js `loadGraphModel` URL, or null when unsupported without override. */
+  kind: PoseModelKind;
+  /** TF.js `loadGraphModel` URL when kind is movenet-graph or custom-graph. */
   modelUrl: string | null;
-  /** Human-readable reason when {@link modelUrl} is null. */
+  /** Human-readable reason when kind is unsupported. */
   unsupportedReason?: string;
 }
 
 /**
- * Resolve which TF.js graph model the light WebView should fetch.
+ * Resolve which online pose model the light WebView should run.
  * Default: MoveNet SinglePose Lightning (product URL).
  */
 export function resolvePoseModel(options: ResolvePoseModelOptions = {}): ResolvedPoseModel {
@@ -55,30 +58,30 @@ export function resolvePoseModel(options: ResolvePoseModelOptions = {}): Resolve
       typeof options.model === 'string' && options.model.trim().length > 0
         ? options.model.trim()
         : 'custom';
-    return { modelId: alias, modelUrl: explicit };
+    return { modelId: alias, kind: 'custom-graph', modelUrl: explicit };
   }
 
   const key = (options.model ?? 'movenet').trim().toLowerCase();
   if (key === 'movenet' || key === 'movenet-singlepose-lightning' || key === 'lightning') {
     return {
       modelId: 'movenet-singlepose-lightning',
+      kind: 'movenet-graph',
       modelUrl: DEFAULT_MOVENET_LIGHTNING_URL,
     };
   }
   if (key === 'blazepose') {
     return {
       modelId: 'blazepose',
+      kind: 'blazepose',
       modelUrl: null,
-      unsupportedReason:
-        'BlazePose is not wired in the light RN WebView yet (needs MediaPipe). ' +
-        'Use model="movenet" or pass a TF.js graph modelUrl.',
     };
   }
   return {
     modelId: key,
+    kind: 'unsupported',
     modelUrl: null,
     unsupportedReason:
-      `Unknown model "${options.model}". Use "movenet" (default) or pass modelUrl.`,
+      `Unknown model "${options.model}". Use "movenet" (default), "blazepose", or pass modelUrl.`,
   };
 }
 

package/src/sdkVersion.ts

@@ -1,2 +1,2 @@
 /** AUTO-GENERATED by scripts/sync-sdk-version.mjs — do not edit. */
-export const SDK_VERSION = '0.1.0';
+export const SDK_VERSION = '0.2.0';

package/src/types/events.ts

@@ -38,6 +38,7 @@ export type InitializationStep =
   | 'downloading'
   | 'warming'
   | 'accessing_webcam'
+  | 'loading_media'
   | 'loading_pose_model'
   | 'ready';
 

package/src/types/features.ts

@@ -11,8 +11,8 @@
  * - `keypoints` DURING an exercise session requires a paid plan too
  *   (free may stream keypoints only in pose-only mode, i.e. no exercise).
  * - `blazepose` / `poseEngine` / `mediapipeModel` / `poseBackend` /
- *   `runInWorker` are NOT part of this SDK (MoveNet Lightning only) and are
- *   rejected with a clear error.
+ *   `runInWorker` are NOT feature flags here — select BlazePose with
+ *   `options.model = 'blazepose'` instead of `{ features: { blazepose: true } }`.
  */
 
 import type { MinGrade } from './events';
@@ -75,12 +75,12 @@ const KNOWN_FEATURE_KEYS = new Set<string>([
 ]);
 
 /**
- * WebView params that this SDK deliberately does NOT ship (one SDK, one
- * model: MoveNet Lightning). Passing them (possible from untyped JS hosts)
- * produces a clear `feature_not_supported` error.
+ * WebView params that are NOT feature flags in this SDK.
+ * Note: `options.model = 'blazepose'` is supported on light; passing
+ * `{ blazepose: true }` inside `features` is rejected (WebView query parity).
  */
 const UNSUPPORTED_FEATURE_HINTS: Record<string, string> = {
-  blazepose: 'BlazePose',
+  blazepose: 'BlazePose as a features flag (use options.model = "blazepose" instead)',
   poseEngine: 'pose engine selection (MediaPipe/PoseLandmarker)',
   mediapipeModel: 'MediaPipe model selection',
   poseBackend: 'pose backend selection',
@@ -108,9 +108,8 @@ export const COMBINED_REFERENCE_EXERCISE_MESSAGE =
 export function featureNotSupportedMessage(key: string): string {
   const hint = UNSUPPORTED_FEATURE_HINTS[key] ?? `'${key}'`;
   return (
-    `The '${key}' option (${hint}) is not available in this SDK. ` +
-    'This SDK ships MoveNet Lightning only — pose engine and model cannot be changed. ' +
-    'Remove the option, or use the PoseTracker WebView product if you need it. ' +
+    `The '${key}' option (${hint}) is not available as a features flag. ` +
+    'Remove the option, or use options.model / modelUrl for model selection. ' +
     '(visit: https://posetracker.gitbook.io/posetracker-api/tracking-endpoint)'
   );
 }