@nativesquare/soma 0.14.0 → 0.14.1

package/src/component/validators/shared.ts

@@ -1,15 +1,58 @@
-import { type Infer, v } from "convex/values";
+import { v } from "convex/values";
+
+// ─── SomaErrorType ──────────────────────────────────────────────────────────
+// Canonical error‐type identifiers shared across Garmin & Strava modules.
+
+export type SomaErrorType =
+  // Data domain types
+  | "activity"
+  | "activityDetails"
+  | "athlete"
+  | "bloodPressure"
+  | "body"
+  | "daily"
+  | "epochs"
+  | "healthSnapshot"
+  | "hrv"
+  | "manuallyUpdatedActivities"
+  | "menstruation"
+  | "moveIQ"
+  | "pulseOx"
+  | "respiration"
+  | "skinTemperature"
+  | "sleep"
+  | "stressDetails"
+  | "userMetrics"
+  // Operation types
+  | "deleteSchedule"
+  | "deleteWorkout"
+  | "ingest"
+  | "pushSchedule"
+  | "pushWorkout";
 
 // ─── SomaError ──────────────────────────────────────────────────────────────
-// Convex validator matching the SomaError TypeScript interface.
+
+/** Convex validator for SomaError (uses v.string() for runtime flexibility). */
 export const somaErrorValidator = v.object({
   type: v.string(),
   id: v.string(),
   message: v.string(),
 });
 
-/** Structured error from a Soma operation, derived from the Convex validator. */
-export type SomaError = Infer<typeof somaErrorValidator>;
+/** Structured error from a Soma operation. */
+export interface SomaError {
+  type: SomaErrorType;
+  id: string;
+  message: string;
+}
+
+// ─── WebhookResult ──────────────────────────────────────────────────────────
+// Shared return shape for all webhook handler actions.
+
+export type WebhookResult<TData = Record<string, unknown>> = {
+  errors: SomaError[];
+  items: Array<{ connectionId: string; userId: string; data: TData }>;
+};
 
 import {
   heartRateDataSample,

package/src/validators.ts

@@ -40,6 +40,7 @@
 
 import { v } from "convex/values";
 export { somaErrorValidator } from "./component/validators/shared.js";
+export type { SomaErrorType } from "./component/validators/shared.js";
 import { connectionValidator as _connectionValidator } from "./component/validators/connection.js";
 import {
   activityValidator as _activityValidator,