@nativesquare/soma 0.2.0 → 0.4.0

package/dist/component/validators/samples.d.ts

@@ -141,9 +141,9 @@ export declare const metSample: import("convex/values").VObject<{
     level: import("convex/values").VFloat64<number | undefined, "optional">;
 }, "required", "timestamp" | "level">;
 export declare const tssSample: import("convex/values").VObject<{
-    method?: string | undefined;
     planned?: number | undefined;
     actual?: number | undefined;
+    method?: string | undefined;
     intensity_factor_planned?: number | undefined;
     intensity_factor_actual?: number | undefined;
     normalized_power_watts?: number | undefined;
@@ -154,7 +154,7 @@ export declare const tssSample: import("convex/values").VObject<{
     intensity_factor_planned: import("convex/values").VFloat64<number | undefined, "optional">;
     intensity_factor_actual: import("convex/values").VFloat64<number | undefined, "optional">;
     normalized_power_watts: import("convex/values").VFloat64<number | undefined, "optional">;
-}, "required", "method" | "planned" | "actual" | "intensity_factor_planned" | "intensity_factor_actual" | "normalized_power_watts">;
+}, "required", "planned" | "actual" | "method" | "intensity_factor_planned" | "intensity_factor_actual" | "normalized_power_watts">;
 export declare const lapSample: import("convex/values").VObject<{
     calories?: number | undefined;
     distance_meters?: number | undefined;

package/dist/component/validators/shared.d.ts

@@ -84,22 +84,6 @@ export declare const deviceData: import("convex/values").VObject<{
     software_version: import("convex/values").VString<string | undefined, "optional">;
 }, "required", "name" | "manufacturer" | "serial_number" | "software_version" | "hardware_version" | "last_upload_date" | "activation_timestamp" | "data_provided" | "other_devices" | "sensor_state">;
 export declare const heartRateData: import("convex/values").VObject<{
-    summary?: {
-        avg_hr_bpm?: number | undefined;
-        avg_hrv_rmssd?: number | undefined;
-        avg_hrv_sdnn?: number | undefined;
-        hr_zone_data?: {
-            zone?: number | undefined;
-            start_percentage?: number | undefined;
-            end_percentage?: number | undefined;
-            name?: string | undefined;
-            duration_seconds?: number | undefined;
-        }[] | undefined;
-        max_hr_bpm?: number | undefined;
-        min_hr_bpm?: number | undefined;
-        resting_hr_bpm?: number | undefined;
-        user_max_hr_bpm?: number | undefined;
-    } | undefined;
     detailed?: {
         hr_samples?: {
             timestamp?: string | undefined;
@@ -116,6 +100,22 @@ export declare const heartRateData: import("convex/values").VObject<{
             hrv_sdnn?: number | undefined;
         }[] | undefined;
     } | undefined;
+    summary?: {
+        avg_hr_bpm?: number | undefined;
+        avg_hrv_rmssd?: number | undefined;
+        avg_hrv_sdnn?: number | undefined;
+        hr_zone_data?: {
+            zone?: number | undefined;
+            start_percentage?: number | undefined;
+            end_percentage?: number | undefined;
+            name?: string | undefined;
+            duration_seconds?: number | undefined;
+        }[] | undefined;
+        max_hr_bpm?: number | undefined;
+        min_hr_bpm?: number | undefined;
+        resting_hr_bpm?: number | undefined;
+        user_max_hr_bpm?: number | undefined;
+    } | undefined;
 }, {
     detailed: import("convex/values").VObject<{
         hr_samples?: {
@@ -213,7 +213,7 @@ export declare const heartRateData: import("convex/values").VObject<{
         resting_hr_bpm: import("convex/values").VFloat64<number | undefined, "optional">;
         user_max_hr_bpm: import("convex/values").VFloat64<number | undefined, "optional">;
     }, "optional", "avg_hr_bpm" | "avg_hrv_rmssd" | "avg_hrv_sdnn" | "hr_zone_data" | "max_hr_bpm" | "min_hr_bpm" | "resting_hr_bpm" | "user_max_hr_bpm">;
-}, "required", "summary" | "detailed" | "summary.avg_hr_bpm" | "summary.avg_hrv_rmssd" | "summary.avg_hrv_sdnn" | "summary.hr_zone_data" | "summary.max_hr_bpm" | "summary.min_hr_bpm" | "summary.resting_hr_bpm" | "summary.user_max_hr_bpm" | "detailed.hr_samples" | "detailed.hrv_samples_rmssd" | "detailed.hrv_samples_sdnn">;
+}, "required", "detailed" | "summary" | "detailed.hr_samples" | "detailed.hrv_samples_rmssd" | "detailed.hrv_samples_sdnn" | "summary.avg_hr_bpm" | "summary.avg_hrv_rmssd" | "summary.avg_hrv_sdnn" | "summary.hr_zone_data" | "summary.max_hr_bpm" | "summary.min_hr_bpm" | "summary.resting_hr_bpm" | "summary.user_max_hr_bpm">;
 export declare const oxygenData: import("convex/values").VObject<{
     vo2max_ml_per_min_per_kg?: number | undefined;
     avg_saturation_percentage?: number | undefined;

package/dist/component/validators/sleep.d.ts

@@ -80,22 +80,6 @@ export declare const sleepValidator: {
         software_version: import("convex/values").VString<string | undefined, "optional">;
     }, "optional", "name" | "manufacturer" | "serial_number" | "software_version" | "hardware_version" | "last_upload_date" | "activation_timestamp" | "data_provided" | "other_devices" | "sensor_state">;
     heart_rate_data: import("convex/values").VObject<{
-        summary?: {
-            avg_hr_bpm?: number | undefined;
-            avg_hrv_rmssd?: number | undefined;
-            avg_hrv_sdnn?: number | undefined;
-            hr_zone_data?: {
-                zone?: number | undefined;
-                start_percentage?: number | undefined;
-                end_percentage?: number | undefined;
-                name?: string | undefined;
-                duration_seconds?: number | undefined;
-            }[] | undefined;
-            max_hr_bpm?: number | undefined;
-            min_hr_bpm?: number | undefined;
-            resting_hr_bpm?: number | undefined;
-            user_max_hr_bpm?: number | undefined;
-        } | undefined;
         detailed?: {
             hr_samples?: {
                 timestamp?: string | undefined;
@@ -112,6 +96,22 @@ export declare const sleepValidator: {
                 hrv_sdnn?: number | undefined;
             }[] | undefined;
         } | undefined;
+        summary?: {
+            avg_hr_bpm?: number | undefined;
+            avg_hrv_rmssd?: number | undefined;
+            avg_hrv_sdnn?: number | undefined;
+            hr_zone_data?: {
+                zone?: number | undefined;
+                start_percentage?: number | undefined;
+                end_percentage?: number | undefined;
+                name?: string | undefined;
+                duration_seconds?: number | undefined;
+            }[] | undefined;
+            max_hr_bpm?: number | undefined;
+            min_hr_bpm?: number | undefined;
+            resting_hr_bpm?: number | undefined;
+            user_max_hr_bpm?: number | undefined;
+        } | undefined;
     } | undefined, {
         detailed: import("convex/values").VObject<{
             hr_samples?: {
@@ -209,7 +209,7 @@ export declare const sleepValidator: {
             resting_hr_bpm: import("convex/values").VFloat64<number | undefined, "optional">;
             user_max_hr_bpm: import("convex/values").VFloat64<number | undefined, "optional">;
         }, "optional", "avg_hr_bpm" | "avg_hrv_rmssd" | "avg_hrv_sdnn" | "hr_zone_data" | "max_hr_bpm" | "min_hr_bpm" | "resting_hr_bpm" | "user_max_hr_bpm">;
-    }, "optional", "summary" | "detailed" | "summary.avg_hr_bpm" | "summary.avg_hrv_rmssd" | "summary.avg_hrv_sdnn" | "summary.hr_zone_data" | "summary.max_hr_bpm" | "summary.min_hr_bpm" | "summary.resting_hr_bpm" | "summary.user_max_hr_bpm" | "detailed.hr_samples" | "detailed.hrv_samples_rmssd" | "detailed.hrv_samples_sdnn">;
+    }, "optional", "detailed" | "summary" | "detailed.hr_samples" | "detailed.hrv_samples_rmssd" | "detailed.hrv_samples_sdnn" | "summary.avg_hr_bpm" | "summary.avg_hrv_rmssd" | "summary.avg_hrv_sdnn" | "summary.hr_zone_data" | "summary.max_hr_bpm" | "summary.min_hr_bpm" | "summary.resting_hr_bpm" | "summary.user_max_hr_bpm">;
     metadata: import("convex/values").VObject<{
         summary_id?: string | undefined;
         timestamp_localization?: number | undefined;

package/dist/garmin/activity.d.ts

@@ -0,0 +1,101 @@
+import type { GarminActivity } from "./types.js";
+export type ActivityData = ReturnType<typeof transformActivity>;
+/**
+ * Transform a Garmin activity into a Soma Activity document shape.
+ *
+ * The returned object is ready to be spread into an `ingestActivity` call
+ * alongside `connectionId` and `userId`.
+ *
+ * @param activity - The Garmin activity from the Health API
+ * @returns Soma Activity fields (without connectionId/userId)
+ *
+ * @example
+ * ```ts
+ * const data = transformActivity(garminActivity);
+ * await soma.ingestActivity(ctx, { connectionId, userId, ...data });
+ * ```
+ */
+export declare function transformActivity(activity: GarminActivity): {
+    metadata: {
+        summary_id: string;
+        start_time: string;
+        end_time: string;
+        type: number;
+        upload_type: number;
+        name: string | undefined;
+    };
+    active_durations_data: {
+        activity_seconds: number;
+    };
+    calories_data: {
+        net_activity_calories: number | undefined;
+        BMR_calories: number | undefined;
+        total_burned_calories: number | undefined;
+    } | undefined;
+    device_data: {
+        name: string;
+    } | undefined;
+    distance_data: {
+        summary: {
+            distance_meters: number | undefined;
+            steps: number | undefined;
+            elevation: {
+                gain_actual_meters: number;
+                loss_actual_meters: number | undefined;
+            } | undefined;
+        };
+    } | undefined;
+    heart_rate_data: {
+        summary: {
+            avg_hr_bpm: number | undefined;
+            max_hr_bpm: number | undefined;
+        } | undefined;
+        detailed: {
+            hr_samples: {
+                timestamp: string;
+                bpm: number;
+            }[];
+        } | undefined;
+    } | undefined;
+    movement_data: {
+        avg_speed_meters_per_second: number | undefined;
+        max_speed_meters_per_second: number | undefined;
+        avg_pace_minutes_per_kilometer: number | undefined;
+        max_pace_minutes_per_kilometer: number | undefined;
+        avg_cadence_rpm: number | undefined;
+        max_cadence_rpm: number | undefined;
+        speed_samples: {
+            timestamp: string;
+            speed_meters_per_second: number;
+        }[] | undefined;
+        cadence_samples: {
+            timestamp: string;
+            cadence_rpm: number;
+        }[] | undefined;
+    } | undefined;
+    position_data: {
+        start_pos_lat_lng_deg: number[] | undefined;
+        position_samples: {
+            timestamp: string;
+            coords_lat_lng_deg: number[];
+        }[] | undefined;
+    } | undefined;
+    power_data: {
+        avg_watts: number | undefined;
+        max_watts: number | undefined;
+        power_samples: {
+            timestamp: string;
+            watts: number;
+        }[] | undefined;
+    } | undefined;
+    lap_data: {
+        laps: {
+            start_time: string;
+            end_time: string;
+            distance_meters: number | undefined;
+            avg_hr_bpm: number | undefined;
+            avg_speed_meters_per_second: number | undefined;
+        }[];
+    } | undefined;
+};
+//# sourceMappingURL=activity.d.ts.map

package/dist/garmin/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/garmin/activity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCzD"}

package/dist/garmin/activity.js

@@ -0,0 +1,207 @@
+// ─── Activity Transformer ────────────────────────────────────────────────────
+// Transforms a Garmin activity into the Soma Activity schema shape.
+import { mapActivityType } from "./maps/activity-type.js";
+/**
+ * Transform a Garmin activity into a Soma Activity document shape.
+ *
+ * The returned object is ready to be spread into an `ingestActivity` call
+ * alongside `connectionId` and `userId`.
+ *
+ * @param activity - The Garmin activity from the Health API
+ * @returns Soma Activity fields (without connectionId/userId)
+ *
+ * @example
+ * ```ts
+ * const data = transformActivity(garminActivity);
+ * await soma.ingestActivity(ctx, { connectionId, userId, ...data });
+ * ```
+ */
+export function transformActivity(activity) {
+    const startMs = activity.startTimeInSeconds * 1000;
+    const endMs = startMs + activity.durationInSeconds * 1000;
+    const startDate = new Date(startMs).toISOString();
+    const endDate = new Date(endMs).toISOString();
+    return {
+        metadata: {
+            summary_id: activity.summaryId ?? String(activity.activityId),
+            start_time: startDate,
+            end_time: endDate,
+            type: mapActivityType(activity.activityType),
+            upload_type: activity.manual ? 2 : 1,
+            name: activity.activityName,
+        },
+        active_durations_data: {
+            activity_seconds: activity.durationInSeconds,
+        },
+        calories_data: buildCaloriesData(activity),
+        device_data: activity.deviceName
+            ? { name: activity.deviceName }
+            : undefined,
+        distance_data: buildDistanceData(activity),
+        heart_rate_data: buildHeartRateData(activity),
+        movement_data: buildMovementData(activity),
+        position_data: buildPositionData(activity),
+        power_data: buildPowerData(activity),
+        lap_data: buildLapData(activity),
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildCaloriesData(activity) {
+    if (activity.activeKilocalories == null &&
+        activity.bmrKilocalories == null) {
+        return undefined;
+    }
+    const total = (activity.activeKilocalories ?? 0) + (activity.bmrKilocalories ?? 0);
+    return {
+        net_activity_calories: activity.activeKilocalories,
+        BMR_calories: activity.bmrKilocalories,
+        total_burned_calories: total || undefined,
+    };
+}
+function buildDistanceData(activity) {
+    if (activity.distanceInMeters == null && activity.elevationGainInMeters == null) {
+        return undefined;
+    }
+    return {
+        summary: {
+            distance_meters: activity.distanceInMeters,
+            steps: activity.steps,
+            elevation: activity.elevationGainInMeters != null
+                ? {
+                    gain_actual_meters: activity.elevationGainInMeters,
+                    loss_actual_meters: activity.elevationLossInMeters,
+                }
+                : undefined,
+        },
+    };
+}
+function buildHeartRateData(activity) {
+    const hasHrSummary = activity.averageHeartRateInBeatsPerMinute != null ||
+        activity.maxHeartRateInBeatsPerMinute != null;
+    const hasSamples = activity.samples && activity.samples.length > 0;
+    if (!hasHrSummary && !hasSamples)
+        return undefined;
+    const hrSamples = hasSamples
+        ? activity.samples
+            .filter((s) => s.heartRate != null && s.startTimeInSeconds != null)
+            .map((s) => ({
+            timestamp: new Date(s.startTimeInSeconds * 1000).toISOString(),
+            bpm: s.heartRate,
+        }))
+        : undefined;
+    return {
+        summary: hasHrSummary
+            ? {
+                avg_hr_bpm: activity.averageHeartRateInBeatsPerMinute,
+                max_hr_bpm: activity.maxHeartRateInBeatsPerMinute,
+            }
+            : undefined,
+        detailed: hrSamples && hrSamples.length > 0
+            ? { hr_samples: hrSamples }
+            : undefined,
+    };
+}
+function buildMovementData(activity) {
+    const avgCadence = activity.averageRunCadenceInStepsPerMinute ??
+        activity.averageBikeCadenceInRoundsPerMinute;
+    const maxCadence = activity.maxRunCadenceInStepsPerMinute ??
+        activity.maxBikeCadenceInRoundsPerMinute;
+    const hasMovement = activity.averageSpeedInMetersPerSecond != null ||
+        activity.maxSpeedInMetersPerSecond != null ||
+        avgCadence != null;
+    const hasSamples = activity.samples && activity.samples.length > 0;
+    if (!hasMovement && !hasSamples)
+        return undefined;
+    const speedSamples = hasSamples
+        ? activity.samples
+            .filter((s) => s.speedMetersPerSecond != null && s.startTimeInSeconds != null)
+            .map((s) => ({
+            timestamp: new Date(s.startTimeInSeconds * 1000).toISOString(),
+            speed_meters_per_second: s.speedMetersPerSecond,
+        }))
+        : undefined;
+    const cadenceSamples = hasSamples
+        ? activity.samples
+            .filter((s) => (s.runCadenceInStepsPerMinute != null ||
+            s.bikeCadenceInRPM != null) &&
+            s.startTimeInSeconds != null)
+            .map((s) => ({
+            timestamp: new Date(s.startTimeInSeconds * 1000).toISOString(),
+            cadence_rpm: s.runCadenceInStepsPerMinute ?? s.bikeCadenceInRPM ?? 0,
+        }))
+        : undefined;
+    return {
+        avg_speed_meters_per_second: activity.averageSpeedInMetersPerSecond,
+        max_speed_meters_per_second: activity.maxSpeedInMetersPerSecond,
+        avg_pace_minutes_per_kilometer: activity.averagePaceInMinutesPerKilometer,
+        max_pace_minutes_per_kilometer: activity.maxPaceInMinutesPerKilometer,
+        avg_cadence_rpm: avgCadence,
+        max_cadence_rpm: maxCadence,
+        speed_samples: speedSamples && speedSamples.length > 0 ? speedSamples : undefined,
+        cadence_samples: cadenceSamples && cadenceSamples.length > 0
+            ? cadenceSamples
+            : undefined,
+    };
+}
+function buildPositionData(activity) {
+    const hasStartPos = activity.startingLatitudeInDegree != null &&
+        activity.startingLongitudeInDegree != null;
+    const hasSamples = activity.samples && activity.samples.length > 0;
+    if (!hasStartPos && !hasSamples)
+        return undefined;
+    const positionSamples = hasSamples
+        ? activity.samples
+            .filter((s) => s.latitudeInDegree != null &&
+            s.longitudeInDegree != null &&
+            s.startTimeInSeconds != null)
+            .map((s) => ({
+            timestamp: new Date(s.startTimeInSeconds * 1000).toISOString(),
+            coords_lat_lng_deg: [s.latitudeInDegree, s.longitudeInDegree],
+        }))
+        : undefined;
+    return {
+        start_pos_lat_lng_deg: hasStartPos
+            ? [
+                activity.startingLatitudeInDegree,
+                activity.startingLongitudeInDegree,
+            ]
+            : undefined,
+        position_samples: positionSamples && positionSamples.length > 0
+            ? positionSamples
+            : undefined,
+    };
+}
+function buildPowerData(activity) {
+    const hasPowerSummary = activity.averagePowerInWatts != null ||
+        activity.maxPowerInWatts != null;
+    const hasSamples = activity.samples && activity.samples.length > 0;
+    if (!hasPowerSummary && !hasSamples)
+        return undefined;
+    const powerSamples = hasSamples
+        ? activity.samples
+            .filter((s) => s.powerInWatts != null && s.startTimeInSeconds != null)
+            .map((s) => ({
+            timestamp: new Date(s.startTimeInSeconds * 1000).toISOString(),
+            watts: s.powerInWatts,
+        }))
+        : undefined;
+    return {
+        avg_watts: activity.averagePowerInWatts,
+        max_watts: activity.maxPowerInWatts,
+        power_samples: powerSamples && powerSamples.length > 0 ? powerSamples : undefined,
+    };
+}
+function buildLapData(activity) {
+    if (!activity.laps || activity.laps.length === 0)
+        return undefined;
+    return {
+        laps: activity.laps.map((lap) => ({
+            start_time: new Date(lap.startTimeInSeconds * 1000).toISOString(),
+            end_time: new Date((lap.startTimeInSeconds + lap.timerDurationInSeconds) * 1000).toISOString(),
+            distance_meters: lap.totalDistanceInMeters,
+            avg_hr_bpm: lap.heartRate,
+            avg_speed_meters_per_second: lap.maxSpeed,
+        })),
+    };
+}
+//# sourceMappingURL=activity.js.map

package/dist/garmin/activity.js.map

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

package/dist/garmin/auth.d.ts

@@ -0,0 +1,65 @@
+import type { GarminOAuthRequestTokenResponse, GarminOAuthAccessTokenResponse } from "./types.js";
+/**
+ * Generate a random nonce for OAuth 1.0a requests.
+ */
+export declare function generateNonce(): string;
+/**
+ * Get the current Unix timestamp in seconds.
+ */
+export declare function getTimestamp(): string;
+/**
+ * Percent-encode a string per RFC 3986 (used by OAuth 1.0a).
+ * Unlike encodeURIComponent, this also encodes `!`, `*`, `'`, `(`, `)`.
+ */
+export declare function percentEncode(str: string): string;
+/**
+ * Build the OAuth 1.0a signature base string and compute the HMAC-SHA1 signature.
+ *
+ * @param method - HTTP method (e.g., "POST", "GET")
+ * @param url - The base URL (without query string)
+ * @param params - All OAuth + request parameters sorted alphabetically
+ * @param consumerSecret - The application's consumer secret
+ * @param tokenSecret - The token secret (empty string for request token step)
+ */
+export declare function buildOAuthSignature(method: string, url: string, params: Record<string, string>, consumerSecret: string, tokenSecret?: string): Promise<string>;
+/**
+ * Build the `Authorization: OAuth ...` header value from OAuth parameters.
+ */
+export declare function buildOAuthHeader(params: Record<string, string>): string;
+export interface GetRequestTokenOptions {
+    consumerKey: string;
+    consumerSecret: string;
+    callbackUrl?: string;
+}
+/**
+ * Obtain an unauthorized request token from Garmin.
+ *
+ * This is Step 1 of the OAuth 1.0a three-legged flow:
+ * 1. Your server calls this function to get a temporary request token
+ * 2. Redirect the user to the returned `authUrl`
+ * 3. After the user authorizes, exchange the verifier for an access token
+ *
+ * @returns The request token, token secret, and the authorization URL
+ */
+export declare function getRequestToken(opts: GetRequestTokenOptions): Promise<GarminOAuthRequestTokenResponse & {
+    authUrl: string;
+}>;
+export interface GetAccessTokenOptions {
+    consumerKey: string;
+    consumerSecret: string;
+    /** The request token from Step 1. */
+    token: string;
+    /** The request token secret from Step 1. */
+    tokenSecret: string;
+    /** The verifier from the OAuth callback (Step 2). */
+    verifier: string;
+}
+/**
+ * Exchange a request token + verifier for a permanent access token.
+ *
+ * This is Step 3 of the OAuth 1.0a three-legged flow.
+ * The returned access token and secret are permanent — Garmin tokens
+ * do not expire and there is no refresh flow.
+ */
+export declare function getAccessToken(opts: GetAccessTokenOptions): Promise<GarminOAuthAccessTokenResponse>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/garmin/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/garmin/auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,cAAc,EAAE,MAAM,EACtB,WAAW,GAAE,MAAW,GACvB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKvE;AAID,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,+BAA+B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2DhE;AAID,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,8BAA8B,CAAC,CAkDzC"}