@adventurelabs/scout-core 1.4.65 → 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/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/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, 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/types/db.d.ts

@@ -31,6 +31,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 +73,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"];

package/package.json

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