@openlifelog/sdk 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlifelog/sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "TypeScript SDK for the OpenLifeLog API - A comprehensive fitness and nutrition tracking platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/resources/goals.ts

@@ -1,4 +1,5 @@
 import type { HttpClient } from '../utils/http';
+import type { ResolvedConfig } from '../config';
 import type {
   UserGoal,
   CreateUserGoalRequest,
@@ -13,13 +14,14 @@ import type {
   ListNutritionGoalsHistoryParams,
   ListResponse,
 } from '../types';
+import { convertNutritionGoalsToMetric, convertNutritionGoalsFromMetric } from '../utils/units';
 
 /**
  * Goals resource
- * Handles user goals and nutrition goals
+ * Handles user goals and nutrition goals with automatic unit conversion
  */
 export class GoalsResource {
-  constructor(private http: HttpClient) {}
+  constructor(private http: HttpClient, private config: ResolvedConfig) {}
 
   /**
    * Get active user goals
@@ -81,6 +83,11 @@ export class GoalsResource {
    */
   async getNutritionGoals(): Promise<UserNutritionGoals> {
     const response = await this.http.get<UserNutritionGoals>('/v1/nutrition/goals');
+
+    if (this.config.autoConvertUnits) {
+      return convertNutritionGoalsFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -89,6 +96,11 @@ export class GoalsResource {
    */
   async getNutritionGoalsByDate(date: string): Promise<UserNutritionGoals> {
     const response = await this.http.get<UserNutritionGoals>(`/v1/nutrition/goals/date/${date}`);
+
+    if (this.config.autoConvertUnits) {
+      return convertNutritionGoalsFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -96,7 +108,16 @@ export class GoalsResource {
    * Create nutrition goals
    */
   async createNutritionGoals(request: CreateNutritionGoalsRequest): Promise<UserNutritionGoals> {
-    const response = await this.http.post<UserNutritionGoals>('/v1/nutrition/goals', request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertNutritionGoalsToMetric(request, this.config.measurementSystem)
+      : request;
+
+    const response = await this.http.post<UserNutritionGoals>('/v1/nutrition/goals', requestToSend);
+
+    if (this.config.autoConvertUnits) {
+      return convertNutritionGoalsFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -104,7 +125,16 @@ export class GoalsResource {
    * Update nutrition goals for a specific date
    */
   async updateNutritionGoals(date: string, request: UpdateNutritionGoalsRequest): Promise<UserNutritionGoals> {
-    const response = await this.http.put<UserNutritionGoals>(`/v1/nutrition/goals/date/${date}`, request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertNutritionGoalsToMetric(request, this.config.measurementSystem)
+      : request;
+
+    const response = await this.http.put<UserNutritionGoals>(`/v1/nutrition/goals/date/${date}`, requestToSend);
+
+    if (this.config.autoConvertUnits) {
+      return convertNutritionGoalsFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -134,6 +164,11 @@ export class GoalsResource {
    */
   async getNutritionGoalsHistory(params?: ListNutritionGoalsHistoryParams): Promise<ListResponse<UserNutritionGoals>> {
     const response = await this.http.get<ListResponse<UserNutritionGoals>>('/v1/nutrition/goals/history', params);
+
+    if (this.config.autoConvertUnits) {
+      return convertNutritionGoalsFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 

package/resources/metrics.ts

@@ -1,4 +1,5 @@
 import type { HttpClient } from '../utils/http';
+import type { ResolvedConfig } from '../config';
 import type {
   Metric,
   MetricEvent,
@@ -11,13 +12,14 @@ import type {
   ListResponse,
 } from '../types';
 import { createPaginatedIterator, type PaginatedIterator } from '../utils/pagination';
+import { WeightConverter } from '../utils/units';
 
 /**
  * Metrics resource
- * Handles metric tracking operations
+ * Handles metric tracking operations with automatic unit conversion
  */
 export class MetricsResource {
-  constructor(private http: HttpClient) {}
+  constructor(private http: HttpClient, private config: ResolvedConfig) {}
 
   /**
    * List available metrics
@@ -48,6 +50,15 @@ export class MetricsResource {
    */
   async getDailyMetric(metricKey: string, params?: GetDailyMetricParams): Promise<DailyMetricAggregate> {
     const response = await this.http.get<DailyMetricAggregate>(`/v1/metrics/daily/${metricKey}`, params);
+
+    // Convert weight metrics from kg to user preference
+    if (this.config.autoConvertUnits && response.data.value !== null && response.data.value !== undefined) {
+      const isWeightMetric = metricKey.includes('weight') || metricKey.includes('bodyweight');
+      if (isWeightMetric) {
+        response.data.value = WeightConverter.fromMetric(response.data.value, this.config.measurementSystem);
+      }
+    }
+
     return response.data;
   }
 
@@ -56,6 +67,23 @@ export class MetricsResource {
    */
   async listEvents(params?: ListMetricEventsParams): Promise<ListResponse<MetricEvent>> {
     const response = await this.http.get<ListResponse<MetricEvent>>('/v1/metric-events', params);
+
+    // Convert weight values in metric events
+    if (this.config.autoConvertUnits && response.data.data) {
+      response.data.data = response.data.data.map((event: MetricEvent) => {
+        if (event.value !== null && event.value !== undefined) {
+          const isWeightMetric = event.metricKey?.includes('weight') || event.metricKey?.includes('bodyweight');
+          if (isWeightMetric) {
+            return {
+              ...event,
+              value: WeightConverter.fromMetric(event.value, this.config.measurementSystem),
+            };
+          }
+        }
+        return event;
+      });
+    }
+
     return response.data;
   }
 
@@ -73,6 +101,15 @@ export class MetricsResource {
    */
   async getEvent(eventId: string): Promise<MetricEvent> {
     const response = await this.http.get<MetricEvent>(`/v1/metric-events/${eventId}`);
+
+    // Convert weight value if it's a weight metric
+    if (this.config.autoConvertUnits && response.data.value !== null && response.data.value !== undefined) {
+      const isWeightMetric = response.data.metricKey?.includes('weight') || response.data.metricKey?.includes('bodyweight');
+      if (isWeightMetric) {
+        response.data.value = WeightConverter.fromMetric(response.data.value, this.config.measurementSystem);
+      }
+    }
+
     return response.data;
   }
 
@@ -80,7 +117,25 @@ export class MetricsResource {
    * Log a metric value (convenience method)
    */
   async log(request: CreateMetricEventRequest): Promise<MetricEvent> {
-    const response = await this.http.post<MetricEvent>('/v1/metric-events', request);
+    // Convert weight value to metric before sending
+    const requestToSend = { ...request };
+    if (this.config.autoConvertUnits && requestToSend.value !== null && requestToSend.value !== undefined) {
+      const isWeightMetric = requestToSend.metricKey?.includes('weight') || requestToSend.metricKey?.includes('bodyweight');
+      if (isWeightMetric) {
+        requestToSend.value = WeightConverter.toMetric(requestToSend.value, this.config.measurementSystem);
+      }
+    }
+
+    const response = await this.http.post<MetricEvent>('/v1/metric-events', requestToSend);
+
+    // Convert response back to user preference
+    if (this.config.autoConvertUnits && response.data.value !== null && response.data.value !== undefined) {
+      const isWeightMetric = response.data.metricKey?.includes('weight') || response.data.metricKey?.includes('bodyweight');
+      if (isWeightMetric) {
+        response.data.value = WeightConverter.fromMetric(response.data.value, this.config.measurementSystem);
+      }
+    }
+
     return response.data;
   }
 
@@ -95,14 +150,42 @@ export class MetricsResource {
    * Bulk create metric events
    */
   async bulkCreateEvents(request: BulkCreateMetricEventsRequest): Promise<void> {
-    await this.http.post('/v1/metric-events/bulk', request);
+    // Convert weight values in bulk request
+    const requestToSend = { ...request };
+    if (this.config.autoConvertUnits && requestToSend.metrics) {
+      requestToSend.metrics = requestToSend.metrics.map((event: CreateMetricEventRequest) => {
+        if (event.value !== null && event.value !== undefined) {
+          const isWeightMetric = event.metricKey?.includes('weight') || event.metricKey?.includes('bodyweight');
+          if (isWeightMetric) {
+            return {
+              ...event,
+              value: WeightConverter.toMetric(event.value, this.config.measurementSystem),
+            };
+          }
+        }
+        return event;
+      });
+    }
+
+    await this.http.post('/v1/metric-events/bulk', requestToSend);
   }
 
   /**
    * Update a metric event
+   * Note: metricKey cannot be changed, so we can't determine if this is a weight metric from the request alone.
+   * We'll convert the value assuming it follows the user's preference setting.
    */
   async updateEvent(eventId: string, request: UpdateMetricEventRequest): Promise<MetricEvent> {
     const response = await this.http.put<MetricEvent>(`/v1/metric-events/${eventId}`, request);
+
+    // Convert response back to user preference
+    if (this.config.autoConvertUnits && response.data.value !== null && response.data.value !== undefined) {
+      const isWeightMetric = response.data.metricKey?.includes('weight') || response.data.metricKey?.includes('bodyweight');
+      if (isWeightMetric) {
+        response.data.value = WeightConverter.fromMetric(response.data.value, this.config.measurementSystem);
+      }
+    }
+
     return response.data;
   }
 

package/resources/programs.ts

@@ -1,4 +1,5 @@
 import type { HttpClient } from '../utils/http';
+import type { ResolvedConfig } from '../config';
 import type {
   Program,
   CreateProgramRequest,
@@ -11,19 +12,25 @@ import type {
   ListResponse,
   ListParams,
 } from '../types';
+import { convertWorkoutDataToMetric, convertWorkoutDataFromMetric } from '../utils/units';
 
 /**
  * Programs resource
- * Handles training program operations
+ * Handles training program operations with automatic unit conversion
  */
 export class ProgramsResource {
-  constructor(private http: HttpClient) {}
+  constructor(private http: HttpClient, private config: ResolvedConfig) {}
 
   /**
    * List user's programs and enrollments
    */
   async list(params?: ListParams): Promise<ListResponse<Program>> {
     const response = await this.http.get<ListResponse<Program>>('/v1/programs', params);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -32,6 +39,11 @@ export class ProgramsResource {
    */
   async listTemplates(params?: ListParams): Promise<ListResponse<Program>> {
     const response = await this.http.get<ListResponse<Program>>('/v1/programs/templates', params);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -39,7 +51,16 @@ export class ProgramsResource {
    * Create a new program
    */
   async create(request: CreateProgramRequest): Promise<Program> {
-    const response = await this.http.post<Program>('/v1/programs', request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertWorkoutDataToMetric(request, this.config.measurementSystem)
+      : request;
+
+    const response = await this.http.post<Program>('/v1/programs', requestToSend);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -48,6 +69,11 @@ export class ProgramsResource {
    */
   async get(programId: string): Promise<Program> {
     const response = await this.http.get<Program>(`/v1/programs/${programId}`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -55,7 +81,16 @@ export class ProgramsResource {
    * Update a program
    */
   async update(programId: string, request: UpdateProgramRequest): Promise<Program> {
-    const response = await this.http.put<Program>(`/v1/programs/${programId}`, request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertWorkoutDataToMetric(request, this.config.measurementSystem)
+      : request;
+
+    const response = await this.http.put<Program>(`/v1/programs/${programId}`, requestToSend);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -118,6 +153,11 @@ export class ProgramsResource {
    */
   async getCurrentWeek(enrollmentId: string): Promise<CurrentWeekSchedule> {
     const response = await this.http.get<CurrentWeekSchedule>(`/v1/enrollments/${enrollmentId}/current-week`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 }

package/resources/sessions.ts

@@ -1,4 +1,5 @@
 import type { HttpClient } from '../utils/http';
+import type { ResolvedConfig } from '../config';
 import type {
   WorkoutSession,
   CreateWorkoutSessionRequest,
@@ -11,19 +12,25 @@ import type {
   AddExerciseItem,
 } from '../types';
 import { createPaginatedIterator, type PaginatedIterator } from '../utils/pagination';
+import { convertWorkoutDataToMetric, convertWorkoutDataFromMetric } from '../utils/units';
 
 /**
  * Workout Sessions resource
- * Handles workout performance tracking
+ * Handles workout performance tracking with automatic unit conversion
  */
 export class SessionsResource {
-  constructor(private http: HttpClient) {}
+  constructor(private http: HttpClient, private config: ResolvedConfig) {}
 
   /**
    * List workout sessions with filtering
    */
   async list(params?: ListWorkoutSessionsParams): Promise<ListResponse<WorkoutSession>> {
     const response = await this.http.get<ListResponse<WorkoutSession>>('/v1/workout-sessions', params);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -40,7 +47,16 @@ export class SessionsResource {
    * Create a new workout session
    */
   async create(request: CreateWorkoutSessionRequest): Promise<WorkoutSession> {
-    const response = await this.http.post<WorkoutSession>('/v1/workout-sessions', request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertWorkoutDataToMetric(request, this.config.measurementSystem)
+      : request;
+
+    const response = await this.http.post<WorkoutSession>('/v1/workout-sessions', requestToSend);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -56,6 +72,11 @@ export class SessionsResource {
    */
   async get(sessionId: string): Promise<WorkoutSession> {
     const response = await this.http.get<WorkoutSession>(`/v1/workout-sessions/${sessionId}`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -63,7 +84,16 @@ export class SessionsResource {
    * Update a workout session
    */
   async update(sessionId: string, request: UpdateWorkoutSessionRequest): Promise<WorkoutSession> {
-    const response = await this.http.patch<WorkoutSession>(`/v1/workout-sessions/${sessionId}`, request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertWorkoutDataToMetric(request, this.config.measurementSystem)
+      : request;
+
+    const response = await this.http.patch<WorkoutSession>(`/v1/workout-sessions/${sessionId}`, requestToSend);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -105,6 +135,11 @@ export class SessionsResource {
    */
   async getSessionsByWorkout(workoutId: string, params?: ListWorkoutSessionsParams): Promise<ListResponse<WorkoutSession>> {
     const response = await this.http.get<ListResponse<WorkoutSession>>(`/v1/workouts/${workoutId}/sessions`, params);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -113,6 +148,11 @@ export class SessionsResource {
    */
   async getExerciseHistory(exerciseId: string): Promise<ExerciseHistory> {
     const response = await this.http.get<ExerciseHistory>(`/v1/exercises/${exerciseId}/history`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -121,6 +161,11 @@ export class SessionsResource {
    */
   async getPersonalRecords(): Promise<ListResponse<PersonalRecord>> {
     const response = await this.http.get<ListResponse<PersonalRecord>>('/v1/personal-records');
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -129,6 +174,11 @@ export class SessionsResource {
    */
   async getExercisePersonalRecords(exerciseId: string): Promise<ListResponse<PersonalRecord>> {
     const response = await this.http.get<ListResponse<PersonalRecord>>(`/v1/exercises/${exerciseId}/personal-records`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -137,6 +187,11 @@ export class SessionsResource {
    */
   async getPersonalRecordHistory(exerciseId: string): Promise<ListResponse<PersonalRecordHistory>> {
     const response = await this.http.get<ListResponse<PersonalRecordHistory>>(`/v1/exercises/${exerciseId}/personal-records/history`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 }

package/resources/workouts.ts

@@ -1,4 +1,5 @@
 import type { HttpClient } from '../utils/http';
+import type { ResolvedConfig } from '../config';
 import type {
   Workout,
   CreateWorkoutRequest,
@@ -10,19 +11,25 @@ import type {
   CountResponse,
 } from '../types';
 import { createPaginatedIterator, type PaginatedIterator } from '../utils/pagination';
+import { convertWorkoutDataToMetric, convertWorkoutDataFromMetric } from '../utils/units';
 
 /**
  * Workouts resource
- * Handles workout template operations
+ * Handles workout template operations with automatic unit conversion
  */
 export class WorkoutsResource {
-  constructor(private http: HttpClient) {}
+  constructor(private http: HttpClient, private config: ResolvedConfig) {}
 
   /**
    * List workout templates
    */
   async list(params?: ListWorkoutsParams): Promise<ListResponse<Workout>> {
     const response = await this.http.get<ListResponse<Workout>>('/v1/workouts', params);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -48,6 +55,11 @@ export class WorkoutsResource {
    */
   async search(params: { q: string; limit?: number; cursor?: string }): Promise<ListResponse<Workout>> {
     const response = await this.http.get<ListResponse<Workout>>('/v1/workouts/search', params);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -56,6 +68,11 @@ export class WorkoutsResource {
    */
   async get(workoutId: string): Promise<Workout> {
     const response = await this.http.get<Workout>(`/v1/workouts/${workoutId}`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -64,6 +81,11 @@ export class WorkoutsResource {
    */
   async create(request: CreateWorkoutRequest): Promise<Workout> {
     const response = await this.http.post<Workout>('/v1/workouts', request);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -72,6 +94,11 @@ export class WorkoutsResource {
    */
   async update(workoutId: string, request: UpdateWorkoutRequest): Promise<Workout> {
     const response = await this.http.put<Workout>(`/v1/workouts/${workoutId}`, request);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -80,6 +107,11 @@ export class WorkoutsResource {
    */
   async clone(workoutId: string): Promise<Workout> {
     const response = await this.http.post<Workout>(`/v1/workouts/${workoutId}/clone`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -94,7 +126,11 @@ export class WorkoutsResource {
    * Add exercises to workout
    */
   async addExercises(workoutId: string, request: AddExercisesToWorkoutRequest): Promise<void> {
-    await this.http.post(`/v1/workouts/${workoutId}/exercises`, request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertWorkoutDataToMetric(request, this.config.measurementSystem)
+      : request;
+
+    await this.http.post(`/v1/workouts/${workoutId}/exercises`, requestToSend);
   }
 
   /**
@@ -105,7 +141,11 @@ export class WorkoutsResource {
     exerciseId: string,
     request: UpdateWorkoutExerciseRequest
   ): Promise<void> {
-    await this.http.put(`/v1/workouts/${workoutId}/exercises/${exerciseId}`, request);
+    const requestToSend = this.config.autoConvertUnits
+      ? convertWorkoutDataToMetric(request, this.config.measurementSystem)
+      : request;
+
+    await this.http.put(`/v1/workouts/${workoutId}/exercises/${exerciseId}`, requestToSend);
   }
 
   /**
@@ -120,6 +160,11 @@ export class WorkoutsResource {
    */
   async getWorkoutsByExercise(exerciseId: string): Promise<ListResponse<Workout>> {
     const response = await this.http.get<ListResponse<Workout>>(`/v1/exercises/${exerciseId}/workouts`);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 
@@ -128,6 +173,11 @@ export class WorkoutsResource {
    */
   async getFavorites(params?: ListWorkoutsParams): Promise<ListResponse<Workout>> {
     const response = await this.http.get<ListResponse<Workout>>('/v1/workouts/favorites', params);
+
+    if (this.config.autoConvertUnits) {
+      return convertWorkoutDataFromMetric(response.data, this.config.measurementSystem);
+    }
+
     return response.data;
   }
 

package/types/exercise.ts

@@ -18,7 +18,7 @@ import type {
  */
 export interface ExerciseCapabilities {
   supportsWeight: boolean;
-  supportsBodyweightOnly: boolean;
+  isBodyweight: boolean;
   supportsAssistance: boolean;
   supportsDistance: boolean;
   supportsDuration: boolean;