@adventurelabs/scout-core 1.4.64 → 1.4.66

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/credentials.d.ts

@@ -0,0 +1,9 @@
+import { Database } from "../types/supabase";
+import { CredentialInsert, CredentialUpdate, ICredential } from "../types/db";
+import { IWebResponseCompatible } from "../types/requests";
+import { SupabaseClient } from "@supabase/supabase-js";
+export declare function get_credentials_by_user_id(client: SupabaseClient<Database>, user_id: string): Promise<IWebResponseCompatible<ICredential[]>>;
+export declare function get_credential_by_id(client: SupabaseClient<Database>, credential_id: number, user_id: string): Promise<IWebResponseCompatible<ICredential | null>>;
+export declare function create_credential(client: SupabaseClient<Database>, row: CredentialInsert): Promise<IWebResponseCompatible<ICredential | null>>;
+export declare function update_credential(client: SupabaseClient<Database>, credential_id: number, user_id: string, patch: CredentialUpdate): Promise<IWebResponseCompatible<ICredential | null>>;
+export declare function delete_credential(client: SupabaseClient<Database>, credential_id: number, user_id: string): Promise<IWebResponseCompatible<ICredential | null>>;

package/dist/helpers/credentials.js

@@ -0,0 +1,92 @@
+import { IWebResponse } from "../types/requests";
+export async function get_credentials_by_user_id(client, user_id) {
+    const { data, error } = await client
+        .from("credentials")
+        .select("*")
+        .eq("user_id", user_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_credential_by_id(client, credential_id, user_id) {
+    const { data, error } = await client
+        .from("credentials")
+        .select("*")
+        .eq("id", credential_id)
+        .eq("user_id", user_id)
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Credential not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function create_credential(client, row) {
+    if (!row.user_id) {
+        return IWebResponse.error("user_id is required")
+            .to_compatible();
+    }
+    if (!row.issuer?.trim()) {
+        return IWebResponse.error("issuer is required")
+            .to_compatible();
+    }
+    if (!row.type?.trim()) {
+        return IWebResponse.error("type is required")
+            .to_compatible();
+    }
+    const { data, error } = await client
+        .from("credentials")
+        .insert([row])
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Failed to create credential").to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function update_credential(client, credential_id, user_id, patch) {
+    const { id: _id, user_id: _uid, 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("credentials")
+        .update(updateData)
+        .eq("id", credential_id)
+        .eq("user_id", user_id)
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Credential not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}
+export async function delete_credential(client, credential_id, user_id) {
+    const { data, error } = await client
+        .from("credentials")
+        .delete()
+        .eq("id", credential_id)
+        .eq("user_id", user_id)
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Credential not found")
+            .to_compatible();
+    }
+    return IWebResponse.success(data).to_compatible();
+}

package/dist/helpers/index.d.ts

@@ -2,6 +2,8 @@ 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";
 export * from "./email";

package/dist/helpers/index.js

@@ -2,6 +2,8 @@ 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";
 export * from "./email";

package/dist/helpers/users.js

@@ -34,7 +34,10 @@ export async function server_get_users_with_herd_access(herd_id, supabaseClient)
       users (
         id,
         username,
-        earthranger_id
+        earthranger_id,
+        first,
+        last,
+        title
       )
     `)
         .eq("herd_id", herd_id);

package/dist/index.d.ts

@@ -15,7 +15,9 @@ 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";
 export * from "./helpers/devices";
 export * from "./helpers/email";
@@ -68,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, 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, 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,7 +18,9 @@ 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";
 export * from "./helpers/devices";
 export * from "./helpers/email";

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -1367,17 +1367,26 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
         users: {
             Row: {
                 earthranger_id: string | null;
+                first: string | null;
                 id: string;
+                last: string | null;
+                title: string | null;
                 username: string | null;
             };
             Insert: {
                 earthranger_id?: string | null;
+                first?: string | null;
                 id: string;
+                last?: string | null;
+                title?: string | null;
                 username?: string | null;
             };
             Update: {
                 earthranger_id?: string | null;
+                first?: string | null;
                 id?: string;
+                last?: string | null;
+                title?: string | null;
                 username?: string | null;
             };
             Relationships: [];

package/dist/types/db.d.ts

@@ -30,6 +30,8 @@ export type IOperator = Database["public"]["Tables"]["operators"]["Row"];
 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"];
@@ -69,6 +71,10 @@ export interface ISessionSummary {
 }
 export type ISessionUsageOverTime = Database["public"]["Functions"]["get_session_usage_over_time"]["Returns"];
 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"];
@@ -125,7 +131,7 @@ export interface IEventWithSession extends IEvent {
     session: ISession | null;
 }
 export type IUserAndRole = {
-    user: Pick<Database["public"]["Tables"]["users"]["Row"], "id" | "username" | "earthranger_id"> | null;
+    user: Pick<Database["public"]["Tables"]["users"]["Row"], "id" | "username" | "earthranger_id" | "first" | "last" | "title"> | null;
     role: Role;
 };
 export interface IApiKeyScout {

package/dist/types/supabase.d.ts

@@ -1437,17 +1437,26 @@ export type Database = {
             users: {
                 Row: {
                     earthranger_id: string | null;
+                    first: string | null;
                     id: string;
+                    last: string | null;
+                    title: string | null;
                     username: string | null;
                 };
                 Insert: {
                     earthranger_id?: string | null;
+                    first?: string | null;
                     id: string;
+                    last?: string | null;
+                    title?: string | null;
                     username?: string | null;
                 };
                 Update: {
                     earthranger_id?: string | null;
+                    first?: string | null;
                     id?: string;
+                    last?: string | null;
+                    title?: string | null;
                     username?: string | null;
                 };
                 Relationships: [];

package/package.json

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