@adventurelabs/scout-core 1.4.65 → 1.4.67

package/dist/helpers/certificates.d.ts

@@ -0,0 +1,14 @@
+import { Database } from "../types/supabase";
+import { CertificateInsert, CertificateUpdate, ICertificate } from "../types/db";
+import { IWebResponseCompatible } from "../types/requests";
+import { SupabaseClient } from "@supabase/supabase-js";
+export declare function get_certificates_by_device(client: SupabaseClient<Database>, device_id: number): Promise<IWebResponseCompatible<ICertificate[]>>;
+export declare function get_certificate_by_device(client: SupabaseClient<Database>, certificate_id: number, device_id: number): Promise<IWebResponseCompatible<ICertificate | null>>;
+export declare function create_certificate_by_device(client: SupabaseClient<Database>, device_id: number, row: CertificateInsert): Promise<IWebResponseCompatible<ICertificate | null>>;
+export declare function update_certificate_by_device(client: SupabaseClient<Database>, certificate_id: number, device_id: number, patch: CertificateUpdate): Promise<IWebResponseCompatible<ICertificate | null>>;
+export declare function delete_certificate_by_device(client: SupabaseClient<Database>, certificate_id: number, device_id: number): Promise<IWebResponseCompatible<ICertificate | null>>;
+export declare function get_certificates_by_part(client: SupabaseClient<Database>, part_id: number): Promise<IWebResponseCompatible<ICertificate[]>>;
+export declare function get_certificate_by_part(client: SupabaseClient<Database>, certificate_id: number, part_id: number): Promise<IWebResponseCompatible<ICertificate | null>>;
+export declare function create_certificate_by_part(client: SupabaseClient<Database>, part_id: number, row: CertificateInsert): Promise<IWebResponseCompatible<ICertificate | null>>;
+export declare function update_certificate_by_part(client: SupabaseClient<Database>, certificate_id: number, part_id: number, patch: CertificateUpdate): Promise<IWebResponseCompatible<ICertificate | null>>;
+export declare function delete_certificate_by_part(client: SupabaseClient<Database>, certificate_id: number, part_id: number): Promise<IWebResponseCompatible<ICertificate | null>>;

package/dist/helpers/certificates.js

@@ -0,0 +1,233 @@
+import { EnumWebResponse, IWebResponse, } from "../types/requests";
+const SELECT_CERT_FOR_DEVICE = `
+  id,
+  created_at,
+  expiration,
+  issuer,
+  part_id,
+  tracking_number,
+  type,
+  updated_at,
+  parts!inner ( device_id )
+`;
+function to_certificate(row) {
+    const { parts: _p, ...cert } = row;
+    return cert;
+}
+function assertCertificateInsertBase(row) {
+    if (!row.issuer?.trim()) {
+        return IWebResponse.error("issuer is required")
+            .to_compatible();
+    }
+    if (!row.type?.trim()) {
+        return IWebResponse.error("type is required")
+            .to_compatible();
+    }
+    return null;
+}
+// --- by device (join `parts` so scope is the device the part belongs to) ---
+export async function get_certificates_by_device(client, device_id) {
+    const { data, error } = await client
+        .from("certificates")
+        .select(SELECT_CERT_FOR_DEVICE)
+        .eq("parts.device_id", device_id)
+        .order("created_at", { ascending: false });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    const rows = (data ?? []);
+    return IWebResponse.success(rows.map(to_certificate)).to_compatible();
+}
+export async function get_certificate_by_device(client, certificate_id, device_id) {
+    const { data, error } = await client
+        .from("certificates")
+        .select(SELECT_CERT_FOR_DEVICE)
+        .eq("id", certificate_id)
+        .eq("parts.device_id", device_id)
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(to_certificate(data)).to_compatible();
+}
+export async function create_certificate_by_device(client, device_id, row) {
+    if (row.part_id == null) {
+        return IWebResponse.error("part_id is required")
+            .to_compatible();
+    }
+    const baseErr = assertCertificateInsertBase(row);
+    if (baseErr) {
+        return baseErr;
+    }
+    const { data: part, error: partError } = await client
+        .from("parts")
+        .select("id")
+        .eq("id", row.part_id)
+        .eq("device_id", device_id)
+        .maybeSingle();
+    if (partError) {
+        return IWebResponse.error(partError.message)
+            .to_compatible();
+    }
+    if (!part) {
+        return IWebResponse.error("part not found for this device").to_compatible();
+    }
+    const { data, error } = await client
+        .from("certificates")
+        .insert([row])
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Failed to create certificate").to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function update_certificate_by_device(client, certificate_id, device_id, patch) {
+    // Herd RLS is broader than device: must verify this cert is on the device.
+    const check = await get_certificate_by_device(client, certificate_id, device_id);
+    if (check.status !== EnumWebResponse.SUCCESS || check.data == null) {
+        return IWebResponse.error(check.msg ?? "Certificate not found").to_compatible();
+    }
+    const partId = check.data.part_id;
+    if (partId == null) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    const { id: _id, part_id: _pid, created_at: _ca, ...updateData } = patch;
+    if (Object.keys(updateData).length === 0) {
+        return IWebResponse.error("No valid fields to update").to_compatible();
+    }
+    const { data, error } = await client
+        .from("certificates")
+        .update(updateData)
+        .eq("id", certificate_id)
+        .eq("part_id", partId)
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function delete_certificate_by_device(client, certificate_id, device_id) {
+    const check = await get_certificate_by_device(client, certificate_id, device_id);
+    if (check.status !== EnumWebResponse.SUCCESS || check.data == null) {
+        return IWebResponse.error(check.msg ?? "Certificate not found").to_compatible();
+    }
+    const partId = check.data.part_id;
+    if (partId == null) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    const { data, error } = await client
+        .from("certificates")
+        .delete()
+        .eq("id", certificate_id)
+        .eq("part_id", partId)
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+// --- by part (direct `part_id` on `certificates`) ---
+export async function get_certificates_by_part(client, part_id) {
+    const { data, error } = await client
+        .from("certificates")
+        .select("*")
+        .eq("part_id", part_id)
+        .order("created_at", { ascending: false });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(data ?? []).to_compatible();
+}
+export async function get_certificate_by_part(client, certificate_id, part_id) {
+    const { data, error } = await client
+        .from("certificates")
+        .select("*")
+        .eq("id", certificate_id)
+        .eq("part_id", part_id)
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function create_certificate_by_part(client, part_id, row) {
+    const baseErr = assertCertificateInsertBase(row);
+    if (baseErr) {
+        return baseErr;
+    }
+    const insert = { ...row, part_id };
+    const { data, error } = await client
+        .from("certificates")
+        .insert([insert])
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Failed to create certificate").to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function update_certificate_by_part(client, certificate_id, part_id, patch) {
+    const { id: _id, part_id: _pid, created_at: _ca, ...updateData } = patch;
+    if (Object.keys(updateData).length === 0) {
+        return IWebResponse.error("No valid fields to update").to_compatible();
+    }
+    const { data, error } = await client
+        .from("certificates")
+        .update(updateData)
+        .eq("id", certificate_id)
+        .eq("part_id", part_id)
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function delete_certificate_by_part(client, certificate_id, part_id) {
+    const { data, error } = await client
+        .from("certificates")
+        .delete()
+        .eq("id", certificate_id)
+        .eq("part_id", part_id)
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Certificate not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}

package/dist/helpers/index.d.ts

@@ -2,6 +2,7 @@ export * from "./analysis_usage";
 export * from "./auth";
 export * from "./bounding_boxes";
 export * from "./chat";
+export * from "./certificates";
 export * from "./credentials";
 export * from "./db";
 export * from "./devices";

package/dist/helpers/index.js

@@ -2,6 +2,7 @@ export * from "./analysis_usage";
 export * from "./auth";
 export * from "./bounding_boxes";
 export * from "./chat";
+export * from "./certificates";
 export * from "./credentials";
 export * from "./db";
 export * from "./devices";

package/dist/helpers/users.js

@@ -31,14 +31,7 @@ export async function server_get_users_with_herd_access(herd_id, supabaseClient)
         .from("users_roles_per_herd")
         .select(`
       role,
-      users (
-        id,
-        username,
-        earthranger_id,
-        first,
-        last,
-        title
-      )
+      users (*)
     `)
         .eq("herd_id", herd_id);
     if (error) {
@@ -49,7 +42,6 @@ export async function server_get_users_with_herd_access(herd_id, supabaseClient)
         };
     }
     else {
-        // Transform the data to match IUserAndRole interface
         const transformedData = data.map((item) => ({
             user: item.users,
             role: item.role,
@@ -76,12 +68,9 @@ export async function server_upsert_user_with_role(herd_id, username, role) {
         herd_id: herd_id,
         role: role,
     };
-    // upddate or insert user role
-    const { data, error } = await supabase
-        .from("users_roles_per_herd")
-        .upsert(newRoleForDb);
+    const { error } = await supabase.from("users_roles_per_herd").upsert(newRoleForDb);
     if (error) {
         return IWebResponse.error("Unable to update or add user with provided username. Ensure you have sufficient permissions.").to_compatible();
     }
-    return IWebResponse.success(data).to_compatible();
+    return IWebResponse.success({ user, role }).to_compatible();
 }

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export * from "./helpers/artifacts";
 export * from "./helpers/auth";
 export * from "./helpers/bounding_boxes";
 export * from "./helpers/chat";
+export * from "./helpers/certificates";
 export * from "./helpers/connectivity";
 export * from "./helpers/credentials";
 export * from "./helpers/db";
@@ -69,5 +70,5 @@ export * from "./supabase/middleware";
 export * from "./supabase/server";
 export * from "./api_keys/actions";
 export type { HerdModule, IHerdModule } from "./types/herd_module";
-export type { IDevice, IEvent, IUser, IHerd, IHerdPrettyLocation, IEventWithTags, IZoneWithActions, ICredential, CredentialInsert, CredentialUpdate, IUserAndRole, IApiKeyScout, ILayer, IHeartbeat, IProvider, IConnectivity, ISession, ISessionWithCoordinates, IConnectivityWithCoordinates, IObservation, ObservationInsert, ObservationUpdate, IAnalysisJob, IAnalysisTask, AnalysisWorkStatus, } from "./types/db";
+export type { IDevice, IEvent, IUser, IHerd, IHerdPrettyLocation, IEventWithTags, IZoneWithActions, ICredential, CredentialInsert, CredentialUpdate, ICertificate, CertificateInsert, CertificateUpdate, IUserAndRole, IUserProfileRow, IApiKeyScout, ILayer, IHeartbeat, IProvider, IConnectivity, ISession, ISessionWithCoordinates, IConnectivityWithCoordinates, IObservation, ObservationInsert, ObservationUpdate, IAnalysisJob, IAnalysisTask, AnalysisWorkStatus, } from "./types/db";
 export { EnumSessionsVisibility } from "./types/events";

package/dist/index.js

@@ -18,6 +18,7 @@ export * from "./helpers/artifacts";
 export * from "./helpers/auth";
 export * from "./helpers/bounding_boxes";
 export * from "./helpers/chat";
+export * from "./helpers/certificates";
 export * from "./helpers/connectivity";
 export * from "./helpers/credentials";
 export * from "./helpers/db";

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -1366,26 +1366,32 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
         };
         users: {
             Row: {
+                auto_approve_sessions: boolean;
                 earthranger_id: string | null;
                 first: string | null;
                 id: string;
                 last: string | null;
+                signature_base64: string | null;
                 title: string | null;
                 username: string | null;
             };
             Insert: {
+                auto_approve_sessions?: boolean;
                 earthranger_id?: string | null;
                 first?: string | null;
                 id: string;
                 last?: string | null;
+                signature_base64?: string | null;
                 title?: string | null;
                 username?: string | null;
             };
             Update: {
+                auto_approve_sessions?: boolean;
                 earthranger_id?: string | null;
                 first?: string | null;
                 id?: string;
                 last?: string | null;
+                signature_base64?: string | null;
                 title?: string | null;
                 username?: string | null;
             };

package/dist/types/db.d.ts

@@ -6,7 +6,10 @@ export type DeviceType = Database["public"]["Enums"]["device_type"];
 export type MediaType = Database["public"]["Enums"]["media_type"];
 export type TagObservationType = Database["public"]["Enums"]["tag_observation_type"];
 export type AnalysisWorkStatus = Database["public"]["Enums"]["analysis_work_status"];
+/** Supabase Auth user (`auth.getUser()`); not `public.users`. */
 export type IUser = User;
+/** Full `public.users` profile row (generated from DB). */
+export type IUserProfileRow = Database["public"]["Tables"]["users"]["Row"];
 export type IDevice = Database["public"]["CompositeTypes"]["device_pretty_location"] & {
     api_keys_scout?: IApiKeyScout[];
     parts?: IPart[];
@@ -31,6 +34,7 @@ export type IObservation = Database["public"]["Tables"]["observations"]["Row"];
 export type IProvider = Database["public"]["Tables"]["providers"]["Row"];
 export type IPart = Database["public"]["Tables"]["parts"]["Row"];
 export type ICredential = Database["public"]["Tables"]["credentials"]["Row"];
+export type ICertificate = Database["public"]["Tables"]["certificates"]["Row"];
 export type IVersionsSoftware = Database["public"]["Tables"]["versions_software"]["Row"];
 export type IArtifact = Database["public"]["Tables"]["artifacts"]["Row"];
 export type IHealthMetric = Database["public"]["Tables"]["health_metrics"]["Row"];
@@ -72,6 +76,8 @@ export type ISessionUsageOverTime = Database["public"]["Functions"]["get_session
 export type PartInsert = Database["public"]["Tables"]["parts"]["Insert"];
 export type CredentialInsert = Database["public"]["Tables"]["credentials"]["Insert"];
 export type CredentialUpdate = Database["public"]["Tables"]["credentials"]["Update"];
+export type CertificateInsert = Database["public"]["Tables"]["certificates"]["Insert"];
+export type CertificateUpdate = Database["public"]["Tables"]["certificates"]["Update"];
 export type VersionsSoftwareInsert = Database["public"]["Tables"]["versions_software"]["Insert"];
 export type ArtifactInsert = Database["public"]["Tables"]["artifacts"]["Insert"];
 export type ArtifactUpdate = Database["public"]["Tables"]["artifacts"]["Update"];
@@ -128,7 +134,7 @@ export interface IEventWithSession extends IEvent {
     session: ISession | null;
 }
 export type IUserAndRole = {
-    user: Pick<Database["public"]["Tables"]["users"]["Row"], "id" | "username" | "earthranger_id" | "first" | "last" | "title"> | null;
+    user: IUserProfileRow | null;
     role: Role;
 };
 export interface IApiKeyScout {

package/dist/types/supabase.d.ts

@@ -1436,26 +1436,32 @@ export type Database = {
             };
             users: {
                 Row: {
+                    auto_approve_sessions: boolean;
                     earthranger_id: string | null;
                     first: string | null;
                     id: string;
                     last: string | null;
+                    signature_base64: string | null;
                     title: string | null;
                     username: string | null;
                 };
                 Insert: {
+                    auto_approve_sessions?: boolean;
                     earthranger_id?: string | null;
                     first?: string | null;
                     id: string;
                     last?: string | null;
+                    signature_base64?: string | null;
                     title?: string | null;
                     username?: string | null;
                 };
                 Update: {
+                    auto_approve_sessions?: boolean;
                     earthranger_id?: string | null;
                     first?: string | null;
                     id?: string;
                     last?: string | null;
+                    signature_base64?: string | null;
                     title?: string | null;
                     username?: string | null;
                 };

package/package.json

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