@modelhealth/modelhealth 0.1.17

package/dist/types.js

@@ -0,0 +1,237 @@
+/**
+ * Model Health SDK TypeScript Types
+ *
+ * Complete type definitions for the Model Health biomechanics SDK.
+ *
+ * @packageDocumentation
+ */
+// MARK: - Analysis
+/**
+ * Represents available analysis functions for motion capture data.
+ *
+ * Each analysis type processes activity data to extract specific biomechanical metrics
+ * and insights. Analysis can only be performed on activities that have completed processing.
+ */
+export const AnalysisType = {
+    /** Counter Movement Jump */
+    CounterMovementJump: "counter_movement_jump",
+    /** Overground Walking */
+    Gait: "gait",
+    /** Treadmill Running */
+    TreadmillRunning: "treadmill_running",
+    /** Sit-to-Stand Transfer */
+    SitToStand: "sit_to_stand",
+    /** Squat Exercise */
+    Squats: "squats",
+    /** Range of Motion (ROM) */
+    RangeOfMotion: "range_of_motion",
+    /** Overground Running */
+    OvergroundRunning: "overground_running",
+    /** Drop Vertical Jump */
+    DropJump: "drop_jump",
+    /** Hop Test */
+    Hop: "hop",
+    /** Treadmill Walking */
+    TreadmillGait: "treadmill_gait",
+    /** 5-0-5 Test */
+    ChangeOfDirection: "change_of_direction",
+    /** Cutting Maneuver */
+    Cut: "cut",
+};
+/**
+ * In-memory token storage implementation.
+ *
+ * **Warning**: Not secure - tokens are lost on page refresh.
+ * Only use for development and testing.
+ *
+ * For production, use:
+ * - Encrypted IndexedDB
+ * - HttpOnly cookies with CSRF protection
+ * - Platform-specific secure storage
+ */
+export class MemoryTokenStorage {
+    constructor() {
+        this.token = null;
+    }
+    async getToken() {
+        return this.token;
+    }
+    async setToken(token) {
+        this.token = token;
+    }
+    async removeToken() {
+        this.token = null;
+    }
+}
+/**
+ * LocalStorage-based token storage implementation.
+ *
+ * **Warning**: LocalStorage is not encrypted. Use secure
+ * HTTP-only cookies or encrypted storage for production.
+ *
+ * @example
+ * ```typescript
+ * const storage = new LocalStorageTokenStorage("my_app_token");
+ * const client = new ModelHealthService({ storage });
+ * ```
+ */
+export class LocalStorageTokenStorage {
+    /**
+     * Create a LocalStorage token storage.
+     *
+     * @param key Storage key name (default: "modelhealth_token")
+     */
+    constructor(key = "modelhealth_token") {
+        this.key = key;
+    }
+    async getToken() {
+        if (typeof localStorage === "undefined") {
+            return null;
+        }
+        return localStorage.getItem(this.key);
+    }
+    async setToken(token) {
+        if (typeof localStorage === "undefined") {
+            throw new Error("localStorage is not available");
+        }
+        localStorage.setItem(this.key, token);
+    }
+    async removeToken() {
+        if (typeof localStorage === "undefined") {
+            return;
+        }
+        localStorage.removeItem(this.key);
+    }
+}
+// MARK: - Helper Functions for Analysis Results
+/**
+ * Extract jump height from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Jump height in centimeters, or null if not available
+ */
+export function getJumpHeight(result) {
+    const metric = result.metrics["00_jump_height_COM"];
+    return metric?.value.type === "single" ? metric.value.value : null;
+}
+/**
+ * Extract jump time from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Jump time in seconds, or null if not available
+ */
+export function getJumpTime(result) {
+    const metric = result.metrics["01_jump_time"];
+    return metric?.value.type === "single" ? metric.value.value : null;
+}
+/**
+ * Extract concentric/eccentric time ratio from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Time ratio, or null if not available
+ */
+export function getConcentricEccentricTimeRatio(result) {
+    const metric = result.metrics["02_ratio_concentric_eccentric_time"];
+    return metric?.value.type === "single" ? metric.value.value : null;
+}
+/**
+ * Extract reactive strength index from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Reactive strength index, or null if not available
+ */
+export function getReactiveStrengthIndex(result) {
+    const metric = result.metrics["03_reactive_strength_index_COM"];
+    return metric?.value.type === "single" ? metric.value.value : null;
+}
+/**
+ * Extract peak vertical velocity from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Peak velocity in m/s, or null if not available
+ */
+export function getPeakVerticalVelocity(result) {
+    const metric = result.metrics["04_peak_vertical_COM_speed_during_takeoff"];
+    return metric?.value.type === "single" ? metric.value.value : null;
+}
+/**
+ * Extract peak knee extension speed during takeoff from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Object with left and right values in deg/s, or null if not available
+ */
+export function getPeakKneeExtensionSpeed(result) {
+    const metric = result.metrics["05_peak_knee_extension_speed_during_takeoff"];
+    return metric?.value.type === "bilateral"
+        ? { left: metric.value.left, right: metric.value.right }
+        : null;
+}
+/**
+ * Extract peak hip extension speed during takeoff from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Object with left and right values in deg/s, or null if not available
+ */
+export function getPeakHipExtensionSpeed(result) {
+    const metric = result.metrics["06_peak_hip_extension_speed_during_takeoff"];
+    return metric?.value.type === "bilateral"
+        ? { left: metric.value.left, right: metric.value.right }
+        : null;
+}
+/**
+ * Extract peak knee flexion angle during landing from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Object with left and right values in degrees, or null if not available
+ */
+export function getPeakKneeFlexionLanding(result) {
+    const metric = result.metrics["07_peak_knee_flexion_angle_during_landing"];
+    return metric?.value.type === "bilateral"
+        ? { left: metric.value.left, right: metric.value.right }
+        : null;
+}
+/**
+ * Extract peak knee valgus angle during landing from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Object with left and right values in degrees, or null if not available
+ */
+export function getPeakKneeValgusLanding(result) {
+    const metric = result.metrics["08_peak_dynamic_knee_valgus_angle_during_landing"];
+    return metric?.value.type === "bilateral"
+        ? { left: metric.value.left, right: metric.value.right }
+        : null;
+}
+/**
+ * Extract peak hip flexion angle during landing from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Object with left and right values in degrees, or null if not available
+ */
+export function getPeakHipFlexionLanding(result) {
+    const metric = result.metrics["09_peak_hip_flexion_angle_during_landing"];
+    return metric?.value.type === "bilateral"
+        ? { left: metric.value.left, right: metric.value.right }
+        : null;
+}
+/**
+ * Extract peak trunk flexion during landing from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Trunk flexion angle in degrees, or null if not available
+ */
+export function getPeakTrunkFlexionLanding(result) {
+    const metric = result.metrics["10_peak_trunk_flexion_relative_to_ground_during_landing"];
+    return metric?.value.type === "single" ? metric.value.value : null;
+}
+/**
+ * Extract peak trunk lean during landing from CMJ analysis results.
+ *
+ * @param result Analysis result from counter-movement jump
+ * @returns Trunk lean angle in degrees, or null if not available
+ */
+export function getPeakTrunkLeanLanding(result) {
+    const metric = result.metrics["11_peak_trunk_lean_relative_to_ground_during_landing"];
+    return metric?.value.type === "single" ? metric.value.value : null;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@modelhealth/modelhealth",
+  "version": "0.1.17",
+  "description": "Model Health SDK for TypeScript/JavaScript",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "wasm",
+    "model_health_wasm.js",
+    "model_health_wasm.d.ts",
+    "model_health_wasm_bg.wasm",
+    "model_health_wasm_bg.wasm.d.ts"
+  ],
+  "scripts": {
+    "build:wasm": "wasm-pack build ../model-health-wasm --target web --out-dir ../../model-health-ts/wasm --scope modelhealth",
+    "build:ts": "tsc",
+    "build": "npm run build:wasm && npm run build:ts",
+    "dev": "npm run build:wasm -- --dev && tsc --watch",
+    "clean": "rm -rf dist wasm node_modules"
+  },
+  "keywords": [
+    "modelhealth",
+    "biomechanics",
+    "motion-analysis",
+    "sdk"
+  ],
+  "author": "Model Health",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/model-health/model-health"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typedoc": "^0.28.15",
+    "typescript": "^5.3.0"
+  }
+}