@adventurelabs/scout-core 1.4.3 → 1.4.4

package/dist/constants/env.d.ts

@@ -0,0 +1,24 @@
+/**
+ * This helper checks multiple possible environment variable names to support
+ * different frameworks and build tools:
+ * - NEXT_PUBLIC_* (Next.js convention, also works in other frameworks)
+ * - VITE_* (Vite convention)
+ * - REACT_APP_* (Create React App convention)
+ * - Direct access (for runtime configuration)
+ */
+/**
+ * Get an environment variable, checking multiple possible names
+ *
+ * @param name - The base name of the environment variable (without prefix)
+ * @param defaultValue - Optional default value if not found
+ * @returns The environment variable value or default
+ */
+export declare function getEnvVar(name: string, defaultValue?: string): string;
+/**
+ * Get Supabase URL from environment variables
+ */
+export declare function getSupabaseUrl(): string;
+/**
+ * Get Supabase anonymous key from environment variables
+ */
+export declare function getSupabaseAnonKey(): string;

package/dist/constants/env.js

@@ -0,0 +1,47 @@
+/**
+ * This helper checks multiple possible environment variable names to support
+ * different frameworks and build tools:
+ * - NEXT_PUBLIC_* (Next.js convention, also works in other frameworks)
+ * - VITE_* (Vite convention)
+ * - REACT_APP_* (Create React App convention)
+ * - Direct access (for runtime configuration)
+ */
+/**
+ * Get an environment variable, checking multiple possible names
+ *
+ * @param name - The base name of the environment variable (without prefix)
+ * @param defaultValue - Optional default value if not found
+ * @returns The environment variable value or default
+ */
+export function getEnvVar(name, defaultValue = "") {
+    // Check multiple possible prefixes
+    const possibleNames = [
+        `NEXT_PUBLIC_${name}`, // Next.js (also works in other frameworks)
+        `VITE_${name}`, // Vite
+        `REACT_APP_${name}`, // Create React App
+        name, // Direct access (for runtime configuration)
+    ];
+    // Try each possible name
+    for (const envName of possibleNames) {
+        if (typeof process !== "undefined" && process.env?.[envName]) {
+            return process.env[envName];
+        }
+        // Also check window object for runtime configuration (PWA use case)
+        if (typeof window !== "undefined" && window.__SCOUT_CONFIG__?.[name]) {
+            return window.__SCOUT_CONFIG__[name];
+        }
+    }
+    return defaultValue;
+}
+/**
+ * Get Supabase URL from environment variables
+ */
+export function getSupabaseUrl() {
+    return getEnvVar("SUPABASE_URL", "");
+}
+/**
+ * Get Supabase anonymous key from environment variables
+ */
+export function getSupabaseAnonKey() {
+    return getEnvVar("SUPABASE_ANON_KEY", "");
+}

package/dist/constants/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./annotator";
 export * from "./app";
+export * from "./env";

package/dist/constants/index.js

@@ -1,2 +1,3 @@
 export * from "./annotator";
 export * from "./app";
+export * from "./env";

package/dist/helpers/connectivity.d.ts

@@ -1,4 +1,7 @@
 import { IWebResponseCompatible } from "../types/requests";
-import { IConnectivityWithCoordinates } from "../types/db";
+import { IConnectivityWithCoordinates, IConnectivity, ConnectivityInsert, ConnectivityUpdate } from "../types/db";
+import { SupabaseClient } from "@supabase/supabase-js";
 export declare function server_get_connectivity_by_session_id(sessionId: number): Promise<IWebResponseCompatible<IConnectivityWithCoordinates[]>>;
 export declare function server_get_connectivity_by_device_id(deviceId: number, timestamp: string): Promise<IWebResponseCompatible<IConnectivityWithCoordinates[]>>;
+export declare function server_insert_connectivity(connectivity: ConnectivityInsert, client?: SupabaseClient): Promise<IWebResponseCompatible<IConnectivity | null>>;
+export declare function server_update_connectivity(connectivityId: number, updates: ConnectivityUpdate, client?: SupabaseClient): Promise<IWebResponseCompatible<IConnectivity | null>>;

package/dist/helpers/connectivity.js

@@ -44,3 +44,51 @@ export async function server_get_connectivity_by_device_id(deviceId, timestamp)
     });
     return IWebResponse.success(sortedConnectivity).to_compatible();
 }
+// Insert a new connectivity record
+export async function server_insert_connectivity(connectivity, client) {
+    const supabase = client || (await newServerClient());
+    const { data, error } = await supabase
+        .from("connectivity")
+        .insert([connectivity])
+        .select("*")
+        .single();
+    if (error) {
+        console.warn("Error inserting connectivity:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: null,
+        };
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+// Update an existing connectivity record
+export async function server_update_connectivity(connectivityId, updates, client) {
+    const supabase = client || (await newServerClient());
+    // Remove fields that shouldn't be updated
+    const updateData = { ...updates };
+    delete updateData.id;
+    delete updateData.inserted_at;
+    const { data, error } = await supabase
+        .from("connectivity")
+        .update(updateData)
+        .eq("id", connectivityId)
+        .select("*")
+        .single();
+    if (error) {
+        console.warn("Error updating connectivity:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: null,
+        };
+    }
+    if (!data) {
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: "Connectivity record not found or update failed",
+            data: null,
+        };
+    }
+    return IWebResponse.success(data).to_compatible();
+}

package/dist/helpers/db.js

@@ -1,7 +1,8 @@
 import { createClient } from "@supabase/supabase-js";
+import { getSupabaseUrl, getSupabaseAnonKey } from "../constants/env";
 export function createClientWithApiKey(user_api_key) {
-    const supabase_url = process.env.NEXT_PUBLIC_SUPABASE_URL;
-    const supabase_anon_key = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+    const supabase_url = getSupabaseUrl();
+    const supabase_anon_key = getSupabaseAnonKey();
     if (!supabase_url || !supabase_anon_key) {
         return null;
     }

package/dist/helpers/events.d.ts

@@ -1,3 +1,7 @@
 import { IWebResponseCompatible } from "../types/requests";
 import { EnumSessionsVisibility } from "../types/events";
+import { IEvent, EventInsert, EventUpdate } from "../types/db";
+import { SupabaseClient } from "@supabase/supabase-js";
 export declare function server_get_total_events_by_herd(herd_id: number, sessions_visibility: EnumSessionsVisibility): Promise<IWebResponseCompatible<number>>;
+export declare function server_insert_event(event: EventInsert, client?: SupabaseClient): Promise<IWebResponseCompatible<IEvent | null>>;
+export declare function server_update_event(eventId: number, updates: EventUpdate, client?: SupabaseClient): Promise<IWebResponseCompatible<IEvent | null>>;

package/dist/helpers/events.js

@@ -22,3 +22,51 @@ export async function server_get_total_events_by_herd(herd_id, sessions_visibili
         return IWebResponse.success(data || 0).to_compatible();
     }
 }
+// Insert a new event
+export async function server_insert_event(event, client) {
+    const supabase = client || (await newServerClient());
+    const { data, error } = await supabase
+        .from("events")
+        .insert([event])
+        .select("*")
+        .single();
+    if (error) {
+        console.warn("Error inserting event:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: null,
+        };
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+// Update an existing event
+export async function server_update_event(eventId, updates, client) {
+    const supabase = client || (await newServerClient());
+    // Remove fields that shouldn't be updated
+    const updateData = { ...updates };
+    delete updateData.id;
+    delete updateData.inserted_at;
+    const { data, error } = await supabase
+        .from("events")
+        .update(updateData)
+        .eq("id", eventId)
+        .select("*")
+        .single();
+    if (error) {
+        console.warn("Error updating event:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: null,
+        };
+    }
+    if (!data) {
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: "Event not found or update failed",
+            data: null,
+        };
+    }
+    return IWebResponse.success(data).to_compatible();
+}

package/dist/helpers/sessions.d.ts

@@ -1,7 +1,9 @@
-import { ISessionWithCoordinates, ISessionUsageOverTime, IEventAndTagsPrettyLocation } from "../types/db";
+import { ISessionWithCoordinates, ISessionUsageOverTime, IEventAndTagsPrettyLocation, ISession, SessionInsert, SessionUpdate } from "../types/db";
 import { IWebResponseCompatible } from "../types/requests";
 import { SupabaseClient } from "@supabase/supabase-js";
 export declare function server_get_session_by_id(sessionId: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionWithCoordinates | null>>;
 export declare function server_get_session_usage_over_time_by_herd(herd_id: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionUsageOverTime>>;
 export declare function server_get_session_usage_over_time_by_device(device_id: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionUsageOverTime>>;
 export declare function server_get_events_and_tags_by_session_id(sessionId: number, limit?: number, offset?: number): Promise<IWebResponseCompatible<IEventAndTagsPrettyLocation[]>>;
+export declare function server_insert_session(session: SessionInsert, client?: SupabaseClient): Promise<IWebResponseCompatible<ISession | null>>;
+export declare function server_update_session(sessionId: number, updates: SessionUpdate, client?: SupabaseClient): Promise<IWebResponseCompatible<ISession | null>>;

package/dist/helpers/sessions.js

@@ -71,3 +71,51 @@ export async function server_get_events_and_tags_by_session_id(sessionId, limit
     }
     return IWebResponse.success(data || []).to_compatible();
 }
+// Insert a new session
+export async function server_insert_session(session, client) {
+    const supabase = client || (await newServerClient());
+    const { data, error } = await supabase
+        .from("sessions")
+        .insert([session])
+        .select("*")
+        .single();
+    if (error) {
+        console.warn("Error inserting session:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: null,
+        };
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+// Update an existing session
+export async function server_update_session(sessionId, updates, client) {
+    const supabase = client || (await newServerClient());
+    // Remove fields that shouldn't be updated
+    const updateData = { ...updates };
+    delete updateData.id;
+    delete updateData.inserted_at;
+    const { data, error } = await supabase
+        .from("sessions")
+        .update(updateData)
+        .eq("id", sessionId)
+        .select("*")
+        .single();
+    if (error) {
+        console.warn("Error updating session:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: null,
+        };
+    }
+    if (!data) {
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: "Session not found or update failed",
+            data: null,
+        };
+    }
+    return IWebResponse.success(data).to_compatible();
+}

package/dist/hooks/useScoutRefresh.js

@@ -7,6 +7,7 @@ import { server_load_herd_modules } from "../helpers/herds";
 import { scoutCache } from "../helpers/cache";
 import { EnumDataSource } from "../types/data_source";
 import { createBrowserClient } from "@supabase/ssr";
+import { getSupabaseUrl, getSupabaseAnonKey } from "../constants/env";
 /**
  * Hook for refreshing scout data with detailed timing measurements and cache-first loading
  *
@@ -37,8 +38,9 @@ export function useScoutRefresh(options = {}) {
     const store = useStore();
     const refreshInProgressRef = useRef(false);
     // Create Supabase client directly to avoid circular dependency
+    // Uses flexible environment variable helper for better PWA compatibility
     const supabase = useMemo(() => {
-        return createBrowserClient(process.env.NEXT_PUBLIC_SUPABASE_URL || "", process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY || "");
+        return createBrowserClient(getSupabaseUrl(), getSupabaseAnonKey());
     }, []);
     // Refs to store timing measurements
     const timingRefs = useRef({

package/dist/providers/ScoutRefreshProvider.js

@@ -3,6 +3,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useScoutRefresh } from "../hooks/useScoutRefresh";
 import { createContext, useContext, useMemo, useRef } from "react";
 import { createBrowserClient } from "@supabase/ssr";
+import { getSupabaseUrl, getSupabaseAnonKey } from "../constants/env";
 // Create context for the Supabase client
 const SupabaseContext = createContext(null);
 const ConnectionStatusContext = createContext(null);
@@ -24,8 +25,9 @@ export function useConnectionStatus() {
 }
 export function ScoutRefreshProvider({ children }) {
     // Use refs to store the URL and key to prevent unnecessary recreations
-    const urlRef = useRef(process.env.NEXT_PUBLIC_SUPABASE_URL || "");
-    const anonKeyRef = useRef(process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY || "");
+    // Uses flexible environment variable helper for better PWA compatibility
+    const urlRef = useRef(getSupabaseUrl());
+    const anonKeyRef = useRef(getSupabaseAnonKey());
     // Create a single Supabase client instance that only runs once
     const supabaseClient = useMemo(() => {
         console.log("[ScoutRefreshProvider] Creating Supabase client");

package/dist/types/db.d.ts

@@ -54,6 +54,12 @@ export type PartInsert = Database["public"]["Tables"]["parts"]["Insert"];
 export type VersionsSoftwareInsert = Database["public"]["Tables"]["versions_software"]["Insert"];
 export type ArtifactInsert = Database["public"]["Tables"]["artifacts"]["Insert"];
 export type PinInsert = Database["public"]["Tables"]["pins"]["Insert"];
+export type SessionInsert = Database["public"]["Tables"]["sessions"]["Insert"];
+export type SessionUpdate = Database["public"]["Tables"]["sessions"]["Update"];
+export type ConnectivityInsert = Database["public"]["Tables"]["connectivity"]["Insert"];
+export type ConnectivityUpdate = Database["public"]["Tables"]["connectivity"]["Update"];
+export type EventInsert = Database["public"]["Tables"]["events"]["Insert"];
+export type EventUpdate = Database["public"]["Tables"]["events"]["Update"];
 export type IEventWithTags = Database["public"]["CompositeTypes"]["event_with_tags"] & {
     earthranger_url: string | null;
     file_path: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adventurelabs/scout-core",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "description": "Core utilities and helpers for Adventure Labs Scout applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",