@openlifelog/sdk 1.0.0

package/client.ts

@@ -0,0 +1,190 @@
+import { mergeConfig, type OpenLifeLogConfig, type ResolvedConfig } from './config';
+import { HttpClient } from './utils/http';
+import { createUnitConverter, type UnitConverter } from './utils/units';
+import { AuthResource } from './resources/auth';
+import { UsersResource } from './resources/users';
+import { FoodsResource } from './resources/foods';
+import { FoodLogsResource } from './resources/food-logs';
+import { ExercisesResource } from './resources/exercises';
+import { WorkoutsResource } from './resources/workouts';
+import { SessionsResource } from './resources/sessions';
+import { ProgramsResource } from './resources/programs';
+import { MetricsResource } from './resources/metrics';
+import { GoalsResource } from './resources/goals';
+import { AIResource } from './resources/ai';
+import type { CreateFoodLogRequest, FoodLog } from './types';
+
+/**
+ * OpenLifeLog SDK Client
+ *
+ * Main entry point for interacting with the OpenLifeLog API
+ *
+ * @example
+ * ```typescript
+ * import { OpenLifeLog } from '@openlifelog/sdk';
+ *
+ * // Initialize the client
+ * const client = new OpenLifeLog({
+ *   apiKey: 'your-jwt-token',
+ *   baseUrl: 'http://localhost:8080',
+ *   autoConvertUnits: true
+ * });
+ *
+ * // Or initialize without API key and login
+ * const client = new OpenLifeLog();
+ * await client.auth.login({ email: '...', password: '...' });
+ *
+ * // Use the client
+ * const user = await client.users.me();
+ * const foods = await client.foods.list();
+ * ```
+ */
+export class OpenLifeLog {
+  private config: ResolvedConfig;
+  private httpClient: HttpClient;
+  private unitConverter: UnitConverter;
+
+  // Resource instances
+  public readonly auth: AuthResource;
+  public readonly users: UsersResource;
+  public readonly foods: FoodsResource;
+  public readonly foodLogs: FoodLogsResource;
+  public readonly exercises: ExercisesResource;
+  public readonly workouts: WorkoutsResource;
+  public readonly sessions: SessionsResource;
+  public readonly programs: ProgramsResource;
+  public readonly metrics: MetricsResource;
+  public readonly goals: GoalsResource;
+  public readonly ai: AIResource;
+
+  constructor(config: OpenLifeLogConfig = {}) {
+    this.config = mergeConfig(config);
+    this.httpClient = new HttpClient(this.config);
+    this.unitConverter = createUnitConverter(this.config.measurementSystem);
+
+    // Initialize all resources
+    this.auth = new AuthResource(this.httpClient);
+    this.users = new UsersResource(this.httpClient);
+    this.foods = new FoodsResource(this.httpClient);
+    this.foodLogs = new FoodLogsResource(this.httpClient);
+    this.exercises = new ExercisesResource(this.httpClient);
+    this.workouts = new WorkoutsResource(this.httpClient);
+    this.sessions = new SessionsResource(this.httpClient);
+    this.programs = new ProgramsResource(this.httpClient);
+    this.metrics = new MetricsResource(this.httpClient);
+    this.goals = new GoalsResource(this.httpClient);
+    this.ai = new AIResource(this.httpClient);
+  }
+
+  /**
+   * Update the API key (JWT token)
+   *
+   * @example
+   * ```typescript
+   * client.setApiKey('new-jwt-token');
+   * ```
+   */
+  setApiKey(apiKey: string): void {
+    this.httpClient.setApiKey(apiKey);
+  }
+
+  /**
+   * Get the current API key
+   */
+  getApiKey(): string | undefined {
+    return this.httpClient.getApiKey();
+  }
+
+  /**
+   * Get the unit converter instance
+   */
+  getUnitConverter(): UnitConverter {
+    return this.unitConverter;
+  }
+
+  /**
+   * Update the measurement system preference
+   *
+   * @example
+   * ```typescript
+   * client.setMeasurementSystem('imperial');
+   * ```
+   */
+  setMeasurementSystem(system: 'metric' | 'imperial'): void {
+    this.config.measurementSystem = system;
+    this.unitConverter.setMeasurementSystem(system);
+  }
+
+  /**
+   * Get the current measurement system
+   */
+  getMeasurementSystem(): 'metric' | 'imperial' {
+    return this.config.measurementSystem;
+  }
+
+  /**
+   * Convenience method: Log food (combines food lookup and logging)
+   *
+   * This is a high-level method that developers love - simple and intuitive.
+   *
+   * @example
+   * ```typescript
+   * const log = await client.logFood({
+   *   foodId: 'food-uuid',
+   *   name: 'Chicken Breast',
+   *   servingSizeName: 'breast (200g)',
+   *   quantity: 1.5,
+   *   mealType: 'lunch',
+   *   notes: 'Grilled with olive oil'
+   * });
+   * ```
+   */
+  async logFood(request: CreateFoodLogRequest): Promise<FoodLog> {
+    return this.foodLogs.create(request);
+  }
+
+  /**
+   * Convenience method: Get today's nutrition summary
+   *
+   * @example
+   * ```typescript
+   * const summary = await client.getTodayNutrition();
+   * console.log(`Calories: ${summary.totalCalories}`);
+   * ```
+   */
+  async getTodayNutrition() {
+    const today = new Date().toISOString().split('T')[0];
+    return this.foodLogs.getDailySummary({ date: today });
+  }
+
+  /**
+   * Convenience method: Get today's goal progress
+   *
+   * @example
+   * ```typescript
+   * const progress = await client.getTodayProgress();
+   * ```
+   */
+  async getTodayProgress() {
+    return this.goals.getProgress();
+  }
+
+  /**
+   * Convenience method: Get today's nutrition progress
+   *
+   * @example
+   * ```typescript
+   * const progress = await client.getTodayNutritionProgress();
+   * ```
+   */
+  async getTodayNutritionProgress() {
+    return this.goals.getNutritionProgress();
+  }
+
+  /**
+   * Check if user is authenticated
+   */
+  isAuthenticated(): boolean {
+    return !!this.httpClient.getApiKey();
+  }
+}

package/config.ts

@@ -0,0 +1,96 @@
+import type { MeasurementSystem } from './types/common';
+
+/**
+ * Configuration options for the OpenLifeLog SDK
+ */
+export interface OpenLifeLogConfig {
+  /**
+   * API key (JWT token) for authenticated requests.
+   * Can be omitted if using auth methods to obtain token.
+   */
+  apiKey?: string;
+
+  /**
+   * Base URL for the API
+   * @default "https://api.openlifelog.com"
+   */
+  baseUrl?: string;
+
+  /**
+   * Measurement system preference (metric or imperial)
+   * @default "metric"
+   */
+  measurementSystem?: MeasurementSystem;
+
+  /**
+   * Automatically convert units based on measurement system preference
+   * @default true
+   */
+  autoConvertUnits?: boolean;
+
+  /**
+   * Request timeout in milliseconds
+   * @default 30000 (30 seconds)
+   */
+  timeout?: number;
+
+  /**
+   * Maximum number of retry attempts for failed requests
+   * @default 3
+   */
+  maxRetries?: number;
+
+  /**
+   * Enable automatic retries for network errors and 5xx errors
+   * @default true
+   */
+  enableRetries?: boolean;
+
+  /**
+   * Custom headers to include in all requests
+   */
+  headers?: Record<string, string>;
+
+  /**
+   * Enable debug logging
+   * @default false
+   */
+  debug?: boolean;
+
+  /**
+   * Custom fetch implementation (useful for Node.js < 18 or testing)
+   */
+  fetch?: typeof fetch;
+}
+
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG: Required<Omit<OpenLifeLogConfig, 'apiKey' | 'fetch' | 'headers'>> = {
+  baseUrl: 'https://api.openlifelog.com',
+  measurementSystem: 'metric',
+  autoConvertUnits: true,
+  timeout: 30000,
+  maxRetries: 3,
+  enableRetries: true,
+  debug: false,
+};
+
+/**
+ * Resolved configuration with all defaults applied
+ */
+export type ResolvedConfig = Required<Omit<OpenLifeLogConfig, 'apiKey'>> & { apiKey?: string };
+
+/**
+ * Merge user config with defaults
+ */
+export function mergeConfig(userConfig: OpenLifeLogConfig): ResolvedConfig {
+  return {
+    ...DEFAULT_CONFIG,
+    ...userConfig,
+    apiKey: userConfig.apiKey,
+    headers: userConfig.headers || {},
+    // Bind fetch to globalThis to preserve context
+    fetch: userConfig.fetch || globalThis.fetch.bind(globalThis),
+  };
+}

package/constants/metrics.ts

@@ -0,0 +1,116 @@
+/**
+ * Metric definitions matching the database reference_data.sql
+ * These are the available metrics that users can track
+ */
+
+export interface MetricDefinition {
+  key: string;
+  displayName: string;
+  category: 'body' | 'activity' | 'sleep' | 'vital' | 'wellness';
+  unit: string;
+  aggregation: 'last' | 'sum' | 'avg' | 'min' | 'max';
+  imperialUnit?: string;
+  imperialConversion?: number;
+}
+
+/**
+ * Body Metrics - measurements related to body composition and physical attributes
+ */
+export const BODY_METRICS: MetricDefinition[] = [
+  { key: 'height', displayName: 'Height', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'weight', displayName: 'Body Weight', category: 'body', unit: 'kg', aggregation: 'last', imperialUnit: 'lbs', imperialConversion: 2.20462 },
+  { key: 'body_fat', displayName: 'Body Fat %', category: 'body', unit: '%', aggregation: 'last' },
+  { key: 'muscle_mass', displayName: 'Muscle Mass', category: 'body', unit: 'kg', aggregation: 'last', imperialUnit: 'lbs', imperialConversion: 2.20462 },
+  { key: 'bone_mass', displayName: 'Bone Mass', category: 'body', unit: 'kg', aggregation: 'last', imperialUnit: 'lbs', imperialConversion: 2.20462 },
+  { key: 'body_water', displayName: 'Body Water %', category: 'body', unit: '%', aggregation: 'last' },
+  { key: 'bmi', displayName: 'BMI', category: 'body', unit: 'kg/m²', aggregation: 'last' },
+  { key: 'waist', displayName: 'Waist Circumference', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'hip', displayName: 'Hip Circumference', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'chest', displayName: 'Chest Circumference', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'neck', displayName: 'Neck Circumference', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'left_bicep', displayName: 'Left Bicep', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'right_bicep', displayName: 'Right Bicep', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'left_forearm', displayName: 'Left Forearm', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'right_forearm', displayName: 'Right Forearm', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'left_thigh', displayName: 'Left Thigh', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'right_thigh', displayName: 'Right Thigh', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'left_calf', displayName: 'Left Calf', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+  { key: 'right_calf', displayName: 'Right Calf', category: 'body', unit: 'cm', aggregation: 'last', imperialUnit: 'in', imperialConversion: 0.393701 },
+];
+
+/**
+ * Activity Metrics - measurements related to daily activity and exercise
+ */
+export const ACTIVITY_METRICS: MetricDefinition[] = [
+  { key: 'steps', displayName: 'Steps', category: 'activity', unit: 'steps', aggregation: 'sum' },
+  { key: 'distance', displayName: 'Distance', category: 'activity', unit: 'km', aggregation: 'sum', imperialUnit: 'mi', imperialConversion: 0.621371 },
+  { key: 'active_minutes', displayName: 'Active Minutes', category: 'activity', unit: 'min', aggregation: 'sum' },
+  { key: 'exercise_minutes', displayName: 'Exercise Minutes', category: 'activity', unit: 'min', aggregation: 'sum' },
+  { key: 'exercise_calories', displayName: 'Exercise Calories', category: 'activity', unit: 'kcal', aggregation: 'sum' },
+  { key: 'floors_climbed', displayName: 'Floors Climbed', category: 'activity', unit: 'floors', aggregation: 'sum' },
+  { key: 'standing_hours', displayName: 'Standing Hours', category: 'activity', unit: 'hours', aggregation: 'sum' },
+  { key: 'vo2_max', displayName: 'VO2 Max', category: 'activity', unit: 'ml/kg/min', aggregation: 'last' },
+];
+
+/**
+ * Sleep Metrics - measurements related to sleep quality and duration
+ */
+export const SLEEP_METRICS: MetricDefinition[] = [
+  { key: 'sleep_duration', displayName: 'Sleep Duration', category: 'sleep', unit: 'hours', aggregation: 'last' },
+  { key: 'deep_sleep', displayName: 'Deep Sleep', category: 'sleep', unit: 'hours', aggregation: 'last' },
+  { key: 'rem_sleep', displayName: 'REM Sleep', category: 'sleep', unit: 'hours', aggregation: 'last' },
+  { key: 'light_sleep', displayName: 'Light Sleep', category: 'sleep', unit: 'hours', aggregation: 'last' },
+  { key: 'sleep_quality', displayName: 'Sleep Quality', category: 'sleep', unit: 'score', aggregation: 'avg' },
+  { key: 'sleep_efficiency', displayName: 'Sleep Efficiency', category: 'sleep', unit: '%', aggregation: 'avg' },
+  { key: 'time_to_fall_asleep', displayName: 'Time to Fall Asleep', category: 'sleep', unit: 'min', aggregation: 'avg' },
+  { key: 'times_awakened', displayName: 'Times Awakened', category: 'sleep', unit: 'count', aggregation: 'sum' },
+];
+
+/**
+ * Vital Metrics - measurements related to vital signs and health indicators
+ */
+export const VITAL_METRICS: MetricDefinition[] = [
+  { key: 'heart_rate', displayName: 'Heart Rate', category: 'vital', unit: 'bpm', aggregation: 'avg' },
+  { key: 'resting_heart_rate', displayName: 'Resting Heart Rate', category: 'vital', unit: 'bpm', aggregation: 'min' },
+  { key: 'heart_rate_variability', displayName: 'Heart Rate Variability', category: 'vital', unit: 'ms', aggregation: 'avg' },
+  { key: 'blood_pressure_systolic', displayName: 'Blood Pressure (Systolic)', category: 'vital', unit: 'mmHg', aggregation: 'last' },
+  { key: 'blood_pressure_diastolic', displayName: 'Blood Pressure (Diastolic)', category: 'vital', unit: 'mmHg', aggregation: 'last' },
+  { key: 'blood_glucose', displayName: 'Blood Glucose', category: 'vital', unit: 'mg/dL', aggregation: 'avg' },
+  { key: 'blood_oxygen', displayName: 'Blood Oxygen', category: 'vital', unit: '%', aggregation: 'avg' },
+  { key: 'respiratory_rate', displayName: 'Respiratory Rate', category: 'vital', unit: 'breaths/min', aggregation: 'avg' },
+  { key: 'body_temperature', displayName: 'Body Temperature', category: 'vital', unit: '°C', aggregation: 'avg', imperialUnit: '°F', imperialConversion: 1.8 }, // Note: Fahrenheit conversion requires adding 32, handle separately
+];
+
+/**
+ * Wellness Metrics - measurements related to mental health and well-being
+ */
+export const WELLNESS_METRICS: MetricDefinition[] = [
+  { key: 'mood', displayName: 'Mood', category: 'wellness', unit: 'score', aggregation: 'avg' },
+  { key: 'energy_level', displayName: 'Energy Level', category: 'wellness', unit: 'score', aggregation: 'avg' },
+  { key: 'stress_level', displayName: 'Stress Level', category: 'wellness', unit: 'score', aggregation: 'avg' },
+];
+
+/**
+ * All available metrics
+ */
+export const ALL_METRICS: MetricDefinition[] = [
+  ...BODY_METRICS,
+  ...ACTIVITY_METRICS,
+  ...SLEEP_METRICS,
+  ...VITAL_METRICS,
+  ...WELLNESS_METRICS,
+];
+
+/**
+ * Helper function to get a metric definition by key
+ */
+export function getMetricDefinition(key: string): MetricDefinition | undefined {
+  return ALL_METRICS.find(m => m.key === key);
+}
+
+/**
+ * Helper function to get metrics by category
+ */
+export function getMetricsByCategory(category: MetricDefinition['category']): MetricDefinition[] {
+  return ALL_METRICS.filter(m => m.category === category);
+}