@adventurelabs/scout-core 1.4.79 → 1.4.81

package/dist/helpers/herd_roles.d.ts

@@ -1,8 +1,9 @@
 import { SupabaseClient } from "@supabase/supabase-js";
 import { Database } from "../types/supabase";
-import { IAbility, IHerdRole, IHerdRoleAbilityRow, IHerdRoleWithAbilities } from "../types/db";
+import { IAbility, IHerdRole, IHerdRoleAbilityRow, IHerdRoleWithAbilities, IPlatformDefaultRoleAbilitiesGroup } from "../types/db";
 import { IWebResponseCompatible } from "../types/requests";
 export declare function server_list_abilities(supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IAbility[]>>;
+export declare function server_get_abilities_by_ids(ids: number[], supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IAbility[]>>;
 export declare function server_get_herd_roles(herd_id: number, supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IHerdRole[]>>;
 export declare function server_get_herd_roles_with_abilities(herd_id: number, supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IHerdRoleWithAbilities[]>>;
 export declare function server_get_herd_role_by_system_name(herd_id: number, system_name: string, supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IHerdRole | null>>;
@@ -12,3 +13,6 @@ export declare function server_update_herd_role(herd_role_id: number, patch: {
 }, supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IHerdRole | null>>;
 export declare function server_delete_herd_role(herd_role_id: number, supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<null>>;
 export declare function server_set_herd_role_abilities(herd_role_id: number, ability_ids: number[], supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IHerdRoleAbilityRow[]>>;
+export declare function server_get_platform_default_role_abilities(supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<IPlatformDefaultRoleAbilitiesGroup[]>>;
+export declare function server_set_platform_default_role_abilities(system_name: string, ability_keys: string[], supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<null>>;
+export declare function server_reset_herd_default_role_abilities(herd_id: number, supabaseClient?: SupabaseClient<Database>): Promise<IWebResponseCompatible<null>>;

package/dist/helpers/herd_roles.js

@@ -12,6 +12,21 @@ export async function server_list_abilities(supabaseClient) {
     }
     return IWebResponse.success(data ?? []).to_compatible();
 }
+export async function server_get_abilities_by_ids(ids, supabaseClient) {
+    if (ids.length === 0) {
+        return IWebResponse.success([]).to_compatible();
+    }
+    const supabase = supabaseClient ?? (await newServerClient());
+    const { data, error } = await supabase
+        .from("abilities")
+        .select("*")
+        .in("id", ids)
+        .order("key", { ascending: true });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(data ?? []).to_compatible();
+}
 export async function server_get_herd_roles(herd_id, supabaseClient) {
     const supabase = supabaseClient ?? (await newServerClient());
     const { data, error } = await supabase
@@ -132,3 +147,35 @@ export async function server_set_herd_role_abilities(herd_role_id, ability_ids,
     }
     return IWebResponse.success(data ?? []).to_compatible();
 }
+export async function server_get_platform_default_role_abilities(supabaseClient) {
+    const supabase = supabaseClient ?? (await newServerClient());
+    const { data, error } = await supabase.rpc("get_platform_default_role_abilities");
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    const groups = Array.isArray(data)
+        ? data
+        : [];
+    return IWebResponse.success(groups).to_compatible();
+}
+export async function server_set_platform_default_role_abilities(system_name, ability_keys, supabaseClient) {
+    const supabase = supabaseClient ?? (await newServerClient());
+    const { error } = await supabase.rpc("set_platform_default_role_abilities", {
+        p_system_name: system_name,
+        p_ability_keys: ability_keys,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(null).to_compatible();
+}
+export async function server_reset_herd_default_role_abilities(herd_id, supabaseClient) {
+    const supabase = supabaseClient ?? (await newServerClient());
+    const { error } = await supabase.rpc("reset_herd_default_role_abilities", {
+        p_herd_id: herd_id,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(null).to_compatible();
+}

package/dist/helpers/index.d.ts

@@ -31,6 +31,7 @@ export * from "./versions_software";
 export * from "./versions_software_server";
 export * from "./artifacts";
 export * from "./pins";
+export * from "./points_for_user";
 export * from "./pubsub_token";
 export * from "./pubsub_token_server";
 export * from "./client_abilities_token";

package/dist/helpers/index.js

@@ -31,6 +31,7 @@ export * from "./versions_software";
 export * from "./versions_software_server";
 export * from "./artifacts";
 export * from "./pins";
+export * from "./points_for_user";
 export * from "./pubsub_token";
 export * from "./pubsub_token_server";
 export * from "./client_abilities_token";

package/dist/helpers/points_for_user.d.ts

@@ -0,0 +1,11 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
+import { IPointsForUser } from "../types/db";
+import { IWebResponseCompatible } from "../types/requests";
+export type PointsBalanceUpdateResult = {
+    balance: number;
+    entry: IPointsForUser | null;
+};
+export declare function get_points_for_user_by_user_id(client: SupabaseClient<Database>, user_id: string): Promise<IWebResponseCompatible<IPointsForUser[]>>;
+export declare function get_points_balance_for_user_id(client: SupabaseClient<Database>, user_id: string): Promise<IWebResponseCompatible<number>>;
+export declare function update_points_balance_for_user(client: SupabaseClient<Database>, user_id: string, balance: number, update_reason: string): Promise<IWebResponseCompatible<PointsBalanceUpdateResult | null>>;

package/dist/helpers/points_for_user.js

@@ -0,0 +1,54 @@
+import { EnumWebResponse, IWebResponse } from "../types/requests";
+async function sum_points_for_user(client, user_id) {
+    const { data, error } = await client
+        .from("points_for_user")
+        .select("points")
+        .eq("user_id", user_id);
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    const balance = (data ?? []).reduce((sum, row) => sum + row.points, 0);
+    return IWebResponse.success(balance).to_compatible();
+}
+export async function get_points_for_user_by_user_id(client, user_id) {
+    const { data, error } = await client
+        .from("points_for_user")
+        .select("*")
+        .eq("user_id", user_id)
+        .order("inserted_at", { ascending: false });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(data ?? []).to_compatible();
+}
+export async function get_points_balance_for_user_id(client, user_id) {
+    return sum_points_for_user(client, user_id);
+}
+export async function update_points_balance_for_user(client, user_id, balance, update_reason) {
+    if (!user_id) {
+        return IWebResponse.error("user_id is required").to_compatible();
+    }
+    if (!update_reason.trim()) {
+        return IWebResponse.error("update_reason is required").to_compatible();
+    }
+    const current = await sum_points_for_user(client, user_id);
+    if (current.status !== EnumWebResponse.SUCCESS || current.data == null) {
+        return IWebResponse.error(current.msg ?? "Failed to load points balance").to_compatible();
+    }
+    const delta = balance - current.data;
+    if (delta === 0) {
+        return IWebResponse.success({ balance: current.data, entry: null }).to_compatible();
+    }
+    const { data, error } = await client
+        .from("points_for_user")
+        .insert([{ user_id, points: delta, update_reason: update_reason.trim() }])
+        .select("*")
+        .single();
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("Failed to update points balance").to_compatible();
+    }
+    return IWebResponse.success({ balance, entry: data }).to_compatible();
+}

package/dist/index.d.ts

@@ -30,6 +30,7 @@ export * from "./helpers/gps";
 export * from "./helpers/herds";
 export * from "./helpers/location";
 export * from "./helpers/pins";
+export * from "./helpers/points_for_user";
 export * from "./helpers/plans";
 export * from "./helpers/layers";
 export * from "./helpers/sessions";
@@ -82,5 +83,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, ICertificate, CertificateInsert, CertificateUpdate, IUserAndRole, IUserProfileRow, IHerdInvitation, IHerdInvitationWithHerdSlug, IHerdAllowedDomain, IUserRolePerHerd, IAbility, IHerdRole, IHerdRoleWithAbilities, HerdRoleSystemName, HerdInvitationStatus, 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, IPointsForUser, PointsForUserInsert, PointsForUserUpdate, ICertificate, CertificateInsert, CertificateUpdate, IUserAndRole, IUserProfileRow, IHerdInvitation, IHerdInvitationWithHerdSlug, IHerdAllowedDomain, IUserRolePerHerd, IAbility, IHerdRole, IHerdRoleWithAbilities, HerdRoleSystemName, HerdInvitationStatus, 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

@@ -33,6 +33,7 @@ export * from "./helpers/gps";
 export * from "./helpers/herds";
 export * from "./helpers/location";
 export * from "./helpers/pins";
+export * from "./helpers/points_for_user";
 export * from "./helpers/plans";
 export * from "./helpers/layers";
 export * from "./helpers/sessions";

package/dist/types/db.d.ts

@@ -33,6 +33,15 @@ export type IHerdRoleWithAbilities = IHerdRole & {
     abilities: IAbility[];
     ability_ids: number[];
 };
+export type IPlatformDefaultRoleAbilityRow = Database["public"]["Tables"]["platform_default_role_abilities"]["Row"];
+/** One system role's default ability set from `get_platform_default_role_abilities`. */
+export interface IPlatformDefaultRoleAbilitiesGroup {
+    system_name: string;
+    abilities: {
+        id: number;
+        key: string;
+    }[];
+}
 /** Stable machine id on `herd_roles` (e.g. admin, editor, viewer). Not `herds.slug`. */
 export type HerdRoleSystemName = string;
 export type IHerdInvitation = Database["public"]["Tables"]["herd_invitations"]["Row"];
@@ -48,6 +57,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 IPointsForUser = Database["public"]["Tables"]["points_for_user"]["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"];
@@ -90,6 +100,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 PointsForUserInsert = Database["public"]["Tables"]["points_for_user"]["Insert"];
+export type PointsForUserUpdate = Database["public"]["Tables"]["points_for_user"]["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"];

package/dist/types/supabase.d.ts

@@ -1352,6 +1352,35 @@ export type Database = {
                     }
                 ];
             };
+            platform_default_role_abilities: {
+                Row: {
+                    ability_id: number;
+                    id: number;
+                    inserted_at: string;
+                    system_name: string;
+                };
+                Insert: {
+                    ability_id: number;
+                    id?: number;
+                    inserted_at?: string;
+                    system_name: string;
+                };
+                Update: {
+                    ability_id?: number;
+                    id?: number;
+                    inserted_at?: string;
+                    system_name?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "platform_default_role_abilities_ability_id_fkey";
+                        columns: ["ability_id"];
+                        isOneToOne: false;
+                        referencedRelation: "abilities";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             platform_superadmins: {
                 Row: {
                     inserted_at: string;
@@ -1375,6 +1404,38 @@ export type Database = {
                     }
                 ];
             };
+            points_for_user: {
+                Row: {
+                    id: number;
+                    inserted_at: string;
+                    points: number;
+                    update_reason: string;
+                    user_id: string;
+                };
+                Insert: {
+                    id?: number;
+                    inserted_at?: string;
+                    points: number;
+                    update_reason: string;
+                    user_id: string;
+                };
+                Update: {
+                    id?: number;
+                    inserted_at?: string;
+                    points?: number;
+                    update_reason?: string;
+                    user_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "points_for_user_user_id_fkey";
+                        columns: ["user_id"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             providers: {
                 Row: {
                     created_at: string;
@@ -2959,6 +3020,10 @@ export type Database = {
                     isSetofReturn: true;
                 };
             };
+            get_platform_default_role_abilities: {
+                Args: never;
+                Returns: Json;
+            };
             get_pubsub_jwt_public_keys: {
                 Args: never;
                 Returns: Json;
@@ -3406,6 +3471,12 @@ export type Database = {
                     isSetofReturn: false;
                 };
             };
+            reset_herd_default_role_abilities: {
+                Args: {
+                    p_herd_id: number;
+                };
+                Returns: undefined;
+            };
             revoke_client_abilities_jwt_public_key: {
                 Args: {
                     p_kid: string;
@@ -3469,6 +3540,13 @@ export type Database = {
                 };
                 Returns: undefined;
             };
+            set_platform_default_role_abilities: {
+                Args: {
+                    p_ability_keys: string[];
+                    p_system_name: string;
+                };
+                Returns: undefined;
+            };
             sync_orphan_session_links: {
                 Args: {
                     preview?: boolean;

package/package.json

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