@modelhealth/modelhealth 0.1.17

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAuBH,IAAI,UAAU,GAAQ,IAAI,CAAC;AAC3B,IAAI,eAAe,GAAG,KAAK,CAAC;AAC5B,IAAI,eAAe,GAAyB,IAAI,CAAC;AAEjD;;;;;;;GAOG;AACH,KAAK,UAAU,QAAQ;IACrB,IAAI,eAAe;QACjB,OAAO;IAET,IAAI,eAAe;QACjB,OAAO,eAAe,CAAC;IAEzB,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE;QAC5B,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YAC1D,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;YACxB,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,GAAG,IAAI,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,eAAe,CAAC;AACzB,CAAC;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,kBAAkB;IAK7B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,MAAyB;QAzB7B,eAAU,GAAQ,IAAI,CAAC;QAEvB,gBAAW,GAAG,KAAK,CAAC;QAwB1B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;SAClC,CAAC;QAEF,+BAA+B;QAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC1B,OAAO,CAAC,KAAK,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,WAAW;YAClB,OAAO;QAET,MAAM,QAAQ,EAAE,CAAC;QAEjB,sCAAsC;QACtC,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACK,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yBAAyB;IAEzB;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;IACjD,CAAC;IAED,mBAAmB;IAEnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,aAAa,CAAY,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,aAAa,CAAU,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,aAAa,CAAU,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,KAAK,CAAC,eAAe,CACnB,OAAgB,EAChB,mBAAwC,EACxC,cAAmD;QAEnD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,UAAU,GAAG,CAAC,UAAe,EAAE,EAAE;YACrC,cAAc,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,MAAM,UAAU,CAAC,eAAe,CAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,OAAO,EACP,mBAAmB,EACnB,UAAU,CACX,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,oBAAoB,CACxB,OAAgB,EAChB,OAAgB,EAChB,cAAmD;QAEnD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,UAAU,GAAG,CAAC,UAAe,EAAE,EAAE;YACrC,cAAc,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,MAAM,UAAU,CAAC,oBAAoB,CACnC,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,OAAO,EACP,OAAO,EACP,UAAU,CACX,CAAC;IACJ,CAAC;IAED,mBAAmB;IAEnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,aAAa,CAAY,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,KAAK,CAAC,aAAa,CAAC,UAA6B;QAC/C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,aAAa,CAAU,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,8BAA8B;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,KAAK,CAAC,uBAAuB,CAC3B,SAAiB,EACjB,UAAkB,EAClB,KAAa,EACb,IAAkB;QAElB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAC1D,SAAS,EACT,UAAU,EACV,KAAK,EACL,IAAI,CACL,CAAC;QACF,OAAO,IAAI,CAAC,aAAa,CAAa,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,aAAa,CAAW,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,cAAc,CAAC,QAAkB;QACrC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,aAAa,CAAW,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,cAAc,CAAC,QAAkB;QACrC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC,aAAa,CAAgB,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,qBAAqB;IAErB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,aAAa,CAAa,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,sBAAsB,CAC1B,QAAkB,EAClB,UAAwB,QAAQ;QAEhC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,mBAAmB,CACtD,QAAQ,EACR,OAAO,CACR,CAAC;QAEF,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,KAAK,CAAC,0BAA0B,CAC9B,QAAkB,EAClB,SAA2B;QAE3B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,0BAA0B,CAC7D,QAAQ,EACR,SAAS,CACV,CAAC;QAEF,OAAO,IAAI,CAAC,aAAa,CAAe,MAAM,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,KAAK,CAAC,kCAAkC,CACtC,QAAkB,EAClB,SAAmC;QAEnC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,+BAA+B,CAClE,QAAQ,EACR,SAAS,CACV,CAAC;QAEF,OAAO,IAAI,CAAC,aAAa,CAAuB,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED,+BAA+B;IAE/B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,MAAM,CAAC,YAAoB,EAAE,OAAgB;QACjD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,aAAa,CAAW,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,KAAK,CAAC,SAAS,CAAC,QAAkB;QAChC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,aAAa,CAA2B,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,aAAa,CACjB,YAA0B,EAC1B,QAAkB,EAClB,OAAgB;QAEhB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAChD,YAAY,EACZ,QAAQ,EACR,OAAO,CACR,CAAC;QAEF,OAAO,IAAI,CAAC,aAAa,CAAe,MAAM,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAkB;QACxC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,aAAa,CAAqB,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,oBAAoB;IAEpB;;;;;;OAMG;IACK,aAAa,CAAI,KAAU;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;QAChC,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,CAAC;CACF;AAED,kBAAkB;AAElB,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,494 @@
+/**
+ * Model Health SDK TypeScript Types
+ *
+ * Complete type definitions for the Model Health biomechanics SDK.
+ *
+ * @packageDocumentation
+ */
+/**
+ * A session represents a collection of activities recorded together.
+ *
+ * Sessions contain multiple activities, each with their own videos and analysis results.
+ * Sessions can be shared publicly or kept private.
+ */
+export interface Session {
+    id: string;
+    user: number;
+    public: boolean;
+    name: string;
+    session_name: string;
+    qrcode?: string;
+    activities: Activity[];
+    subject?: number;
+    activities_count: number;
+}
+/**
+ * Gender identity options for subject demographics.
+ */
+export type Gender = "woman" | "man" | "transgender" | "non_binary" | "no_response";
+/**
+ * Sex assigned at birth options for subject demographics.
+ */
+export type Sex = "woman" | "man" | "intersex" | "not_listed" | "no_response";
+/**
+ * Subject information for biomechanical analysis.
+ *
+ * Subjects represent individuals being analyzed. Their anthropometric
+ * data is used for scaling musculoskeletal models and calculating
+ * personalized biomechanical metrics.
+ */
+export interface Subject {
+    id: number;
+    name: string;
+    weight?: number;
+    height?: number;
+    age?: number;
+    birth_year?: number;
+    gender: Gender;
+    sex_at_birth: Sex;
+    characteristics: string;
+    subject_tags: string[];
+}
+/**
+ * Parameters required for creating a new subject.
+ */
+export interface SubjectParameters {
+    name: string;
+    weight: number;
+    height: number;
+    birth_year: number;
+    sex_at_birth: Sex;
+    gender: Gender;
+    characteristics: string;
+    subject_tags: string[];
+    terms: boolean;
+}
+/**
+ * Video file associated with an activity.
+ */
+export interface Video {
+    id: string;
+    activity: string;
+    video?: string;
+    video_thumb?: string;
+}
+/**
+ * An activity represents a single recording within a session.
+ *
+ * Activities contain the captured videos, processing status, and analysis results.
+ */
+export interface Activity {
+    id: string;
+    session: string;
+    name?: string;
+    status: string;
+    videos: Video[];
+    results: ActivityResult[];
+}
+/**
+ * Sort order for activity lists.
+ *
+ * Specifies how activities should be ordered when retrieved from the API.
+ *
+ * @example
+ * ```typescript
+ * const activities = await client.getActivitiesForSubject(
+ *   subjectId,
+ *   0,
+ *   20,
+ *   "updated_at"
+ * );
+ * ```
+ */
+export type ActivitySort = "updated_at";
+/**
+ * A tag that can be applied to activities for categorization.
+ *
+ * Activity tags provide a way to organize and filter activities.
+ * Common tags might include activity types (e.g., "CMJ", "Squat"),
+ * conditions (e.g., "Baseline", "Post-Training"), or any custom categorization.
+ *
+ * @example
+ * ```typescript
+ * const tags = await client.getActivityTags();
+ * const cmjTag = tags.find(t => t.value === "cmj");
+ * console.log(`CMJ activities: ${cmjTag?.label ?? ""}`);
+ * ```
+ */
+export interface ActivityTag {
+    value: string;
+    label: string;
+}
+/**
+ * Result file associated with an activity.
+ *
+ * Results can include analysis outputs, synchronized videos,
+ * kinematic data, and visualization data.
+ */
+export interface ActivityResult {
+    id: number;
+    activity: string;
+    tag?: string;
+    media?: string;
+}
+/**
+ * Processing status of an activity.
+ *
+ * Indicates the current state of video upload and processing.
+ */
+export type ActivityProcessingStatus = {
+    type: "uploading";
+    uploaded: number;
+    total: number;
+} | {
+    type: "processing";
+} | {
+    type: "ready";
+} | {
+    type: "failed";
+};
+/**
+ * Video version types available for download.
+ */
+export type VideoVersion = "raw" | "synced";
+/**
+ * Result data types available for download from activities, including the desired file format.
+ *
+ * Each variant encodes both the data type and the requested format, matching
+ * the `ResultDataTypeWire` discriminants used in the Rust core:
+ * - `"animation"` — JSON only
+ * - `"kinematics_mot"` — Kinematics in OpenSim MOT format
+ * - `"kinematics_csv"` — Kinematics in CSV format
+ * - `"markers_trc"` — Marker trajectories in TRC format
+ * - `"markers_csv"` — Marker trajectories in CSV format
+ * - `"model"` — OpenSim model (.osim), only available in neutral activities
+ */
+export type ResultDataType = "animation" | "kinematics_mot" | "kinematics_csv" | "markers_trc" | "markers_csv" | "model";
+/**
+ * File format types for downloaded result data.
+ */
+export type FileType = "json" | "csv" | "mot" | "trc" | "o_sim";
+/**
+ * Downloaded result data from an activity.
+ *
+ * The `result_data_type` identifies both what was requested and the implicit
+ * file format — use it to determine how to parse `data`.
+ */
+export interface ResultData {
+    result_data_type: ResultDataType;
+    data: Uint8Array;
+}
+/**
+ * Type of analysis result data to download from a completed activity.
+ *
+ * The file format is implicit in the type:
+ * - `"metrics"` — JSON containing computed biomechanical metrics
+ * - `"data"` — ZIP containing raw analysis data
+ * - `"report"` — PDF report
+ */
+export type AnalysisResultDataType = 
+/** Computed biomechanical metrics. Always JSON format. */
+"metrics"
+/** Raw analysis data. Always ZIP format. */
+ | "data"
+/** Analysis report. Always PDF format. */
+ | "report";
+/**
+ * Downloaded analysis result data from a completed activity.
+ *
+ * The `result_data_type` identifies both what was requested and the implicit
+ * file format — use it to determine how to parse `data`.
+ */
+export interface AnalysisResultData {
+    result_data_type: AnalysisResultDataType;
+    data: Uint8Array;
+}
+/**
+ * Orientation of the checkerboard during camera calibration.
+ */
+export type CheckerboardPlacement = "perpendicular" | "parallel";
+/**
+ * Configuration for checkerboard-based camera calibration.
+ */
+export interface CheckerboardDetails {
+    rows: number;
+    columns: number;
+    square_size: number;
+    placement: CheckerboardPlacement;
+}
+/**
+ * Status updates during calibration process.
+ */
+export type CalibrationStatus = {
+    type: "recording";
+} | {
+    type: "uploading";
+    uploaded: number;
+    total: number;
+} | {
+    type: "processing";
+    percent?: number;
+} | {
+    type: "done";
+};
+/**
+ * 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 declare const AnalysisType: {
+    /** Counter Movement Jump */
+    readonly CounterMovementJump: "counter_movement_jump";
+    /** Overground Walking */
+    readonly Gait: "gait";
+    /** Treadmill Running */
+    readonly TreadmillRunning: "treadmill_running";
+    /** Sit-to-Stand Transfer */
+    readonly SitToStand: "sit_to_stand";
+    /** Squat Exercise */
+    readonly Squats: "squats";
+    /** Range of Motion (ROM) */
+    readonly RangeOfMotion: "range_of_motion";
+    /** Overground Running */
+    readonly OvergroundRunning: "overground_running";
+    /** Drop Vertical Jump */
+    readonly DropJump: "drop_jump";
+    /** Hop Test */
+    readonly Hop: "hop";
+    /** Treadmill Walking */
+    readonly TreadmillGait: "treadmill_gait";
+    /** 5-0-5 Test */
+    readonly ChangeOfDirection: "change_of_direction";
+    /** Cutting Maneuver */
+    readonly Cut: "cut";
+};
+export type AnalysisType = (typeof AnalysisType)[keyof typeof AnalysisType];
+/**
+ * Identifier for a running analysis task.
+ */
+export interface AnalysisTask {
+    task_id: string;
+}
+/**
+ * Status of an analysis task.
+ */
+export type AnalysisTaskStatus = {
+    type: "processing";
+} | {
+    type: "completed";
+} | {
+    type: "failed";
+};
+/**
+ * Results from a biomechanical analysis.
+ *
+ * Contains computed metrics like jump height, peak velocities,
+ * asymmetries, and other biomechanical parameters.
+ */
+export interface AnalysisResult {
+    analysis_title: string;
+    analysis_description: string;
+    metrics: Record<string, Metric>;
+}
+/**
+ * Individual biomechanical metric from an analysis.
+ */
+export interface Metric {
+    label: string;
+    bilateral: boolean;
+    value: MetricValue;
+    info: string;
+    decimal_places: number;
+}
+/**
+ * Value of a metric (single measurement or bilateral left/right).
+ */
+export type MetricValue = {
+    type: "single";
+    value: number;
+} | {
+    type: "bilateral";
+    left: number;
+    right: number;
+};
+/**
+ * Interface for storing authentication tokens securely.
+ *
+ * Implement this interface to provide custom token storage
+ * (e.g., encrypted storage, secure cookies, etc.)
+ *
+ * @example
+ * ```typescript
+ * class SecureTokenStorage implements TokenStorage {
+ *   async getToken(): Promise<string | null> {
+ *     // Retrieve from encrypted storage
+ *   }
+ *   async setToken(token: string): Promise<void> {
+ *     // Store in encrypted storage
+ *   }
+ *   async removeToken(): Promise<void> {
+ *     // Remove from storage
+ *   }
+ * }
+ * ```
+ */
+export interface TokenStorage {
+    /**
+     * Retrieve the stored authentication token.
+     *
+     * @returns The token string, or null if no token is stored
+     */
+    getToken(): Promise<string | null>;
+    /**
+     * Store an authentication token securely.
+     *
+     * @param token The token to store
+     */
+    setToken(token: string): Promise<void>;
+    /**
+     * Remove the stored authentication token.
+     */
+    removeToken(): Promise<void>;
+}
+/**
+ * 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 declare class MemoryTokenStorage implements TokenStorage {
+    private token;
+    getToken(): Promise<string | null>;
+    setToken(token: string): Promise<void>;
+    removeToken(): Promise<void>;
+}
+/**
+ * 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 declare class LocalStorageTokenStorage implements TokenStorage {
+    private key;
+    /**
+     * Create a LocalStorage token storage.
+     *
+     * @param key Storage key name (default: "modelhealth_token")
+     */
+    constructor(key?: string);
+    getToken(): Promise<string | null>;
+    setToken(token: string): Promise<void>;
+    removeToken(): Promise<void>;
+}
+/**
+ * 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 declare function getJumpHeight(result: AnalysisResult): number | 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 declare function getJumpTime(result: AnalysisResult): number | 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 declare function getConcentricEccentricTimeRatio(result: AnalysisResult): number | 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 declare function getReactiveStrengthIndex(result: AnalysisResult): number | 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 declare function getPeakVerticalVelocity(result: AnalysisResult): number | 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 declare function getPeakKneeExtensionSpeed(result: AnalysisResult): {
+    left: number;
+    right: number;
+} | 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 declare function getPeakHipExtensionSpeed(result: AnalysisResult): {
+    left: number;
+    right: number;
+} | 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 declare function getPeakKneeFlexionLanding(result: AnalysisResult): {
+    left: number;
+    right: number;
+} | 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 declare function getPeakKneeValgusLanding(result: AnalysisResult): {
+    left: number;
+    right: number;
+} | 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 declare function getPeakHipFlexionLanding(result: AnalysisResult): {
+    left: number;
+    right: number;
+} | 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 declare function getPeakTrunkFlexionLanding(result: AnalysisResult): number | 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 declare function getPeakTrunkLeanLanding(result: AnalysisResult): number | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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