hazo_auth 3.0.3 → 4.0.0

package/dist/lib/services/scope_labels_service.js

@@ -0,0 +1,277 @@
+import { createCrudService } from "hazo_connect/server";
+import { randomUUID } from "crypto";
+import { create_app_logger } from "../app_logger";
+import { sanitize_error_for_user } from "../utils/error_sanitizer";
+import { SCOPE_LEVELS } from "./scope_service";
+// section: constants
+export const DEFAULT_SCOPE_LABELS = {
+    hazo_scopes_l1: "Level 1",
+    hazo_scopes_l2: "Level 2",
+    hazo_scopes_l3: "Level 3",
+    hazo_scopes_l4: "Level 4",
+    hazo_scopes_l5: "Level 5",
+    hazo_scopes_l6: "Level 6",
+    hazo_scopes_l7: "Level 7",
+};
+// section: helpers
+/**
+ * Gets all scope labels for an organization
+ */
+export async function get_scope_labels(adapter, org) {
+    try {
+        const label_service = createCrudService(adapter, "hazo_scope_labels");
+        const labels = await label_service.findBy({ org });
+        return {
+            success: true,
+            labels: Array.isArray(labels) ? labels : [],
+        };
+    }
+    catch (error) {
+        const logger = create_app_logger();
+        const error_message = sanitize_error_for_user(error, {
+            logToConsole: true,
+            logToLogger: true,
+            logger,
+            context: {
+                filename: "scope_labels_service.ts",
+                line_number: 0,
+                operation: "get_scope_labels",
+                org,
+            },
+        });
+        return {
+            success: false,
+            error: error_message,
+        };
+    }
+}
+/**
+ * Gets all scope labels for an organization, with defaults filled in for missing levels
+ */
+export async function get_scope_labels_with_defaults(adapter, org, custom_defaults) {
+    try {
+        const result = await get_scope_labels(adapter, org);
+        if (!result.success) {
+            return result;
+        }
+        const existing_labels = result.labels || [];
+        const labels_map = new Map();
+        // Add existing labels to map
+        for (const label of existing_labels) {
+            labels_map.set(label.scope_type, label);
+        }
+        // Create synthetic entries for missing levels (with default labels)
+        const defaults = custom_defaults || DEFAULT_SCOPE_LABELS;
+        const all_labels = [];
+        for (const level of SCOPE_LEVELS) {
+            if (labels_map.has(level)) {
+                all_labels.push(labels_map.get(level));
+            }
+            else {
+                // Create a synthetic label entry (not persisted)
+                all_labels.push({
+                    id: "", // Empty ID indicates this is a default, not from DB
+                    org,
+                    scope_type: level,
+                    label: defaults[level],
+                    created_at: "",
+                    changed_at: "",
+                });
+            }
+        }
+        return {
+            success: true,
+            labels: all_labels,
+        };
+    }
+    catch (error) {
+        const logger = create_app_logger();
+        const error_message = sanitize_error_for_user(error, {
+            logToConsole: true,
+            logToLogger: true,
+            logger,
+            context: {
+                filename: "scope_labels_service.ts",
+                line_number: 0,
+                operation: "get_scope_labels_with_defaults",
+                org,
+            },
+        });
+        return {
+            success: false,
+            error: error_message,
+        };
+    }
+}
+/**
+ * Gets the label for a specific scope level
+ * Returns the custom label if set, otherwise returns the default
+ */
+export async function get_label_for_level(adapter, org, scope_type, custom_default) {
+    try {
+        const label_service = createCrudService(adapter, "hazo_scope_labels");
+        const labels = await label_service.findBy({ org, scope_type });
+        if (Array.isArray(labels) && labels.length > 0) {
+            return labels[0].label;
+        }
+        return custom_default || DEFAULT_SCOPE_LABELS[scope_type];
+    }
+    catch (_a) {
+        // Return default on any error
+        return custom_default || DEFAULT_SCOPE_LABELS[scope_type];
+    }
+}
+/**
+ * Creates or updates a scope label for an organization
+ * Uses upsert pattern - creates if not exists, updates if exists
+ */
+export async function upsert_scope_label(adapter, org, scope_type, label) {
+    try {
+        const label_service = createCrudService(adapter, "hazo_scope_labels");
+        const now = new Date().toISOString();
+        // Check if label already exists for this org + scope_type
+        const existing = await label_service.findBy({ org, scope_type });
+        if (Array.isArray(existing) && existing.length > 0) {
+            // Update existing
+            const existing_label = existing[0];
+            const updated = await label_service.updateById(existing_label.id, {
+                label,
+                changed_at: now,
+            });
+            if (!Array.isArray(updated) || updated.length === 0) {
+                return {
+                    success: false,
+                    error: "Failed to update scope label",
+                };
+            }
+            return {
+                success: true,
+                label: updated[0],
+            };
+        }
+        else {
+            // Create new
+            const inserted = await label_service.insert({
+                id: randomUUID(),
+                org,
+                scope_type,
+                label,
+                created_at: now,
+                changed_at: now,
+            });
+            if (!Array.isArray(inserted) || inserted.length === 0) {
+                return {
+                    success: false,
+                    error: "Failed to create scope label",
+                };
+            }
+            return {
+                success: true,
+                label: inserted[0],
+            };
+        }
+    }
+    catch (error) {
+        const logger = create_app_logger();
+        const error_message = sanitize_error_for_user(error, {
+            logToConsole: true,
+            logToLogger: true,
+            logger,
+            context: {
+                filename: "scope_labels_service.ts",
+                line_number: 0,
+                operation: "upsert_scope_label",
+                org,
+                scope_type,
+                label,
+            },
+        });
+        return {
+            success: false,
+            error: error_message,
+        };
+    }
+}
+/**
+ * Batch upsert scope labels for an organization
+ * Useful for saving all labels at once from the UI
+ */
+export async function batch_upsert_scope_labels(adapter, org, labels) {
+    try {
+        const results = [];
+        for (const { scope_type, label } of labels) {
+            const result = await upsert_scope_label(adapter, org, scope_type, label);
+            if (!result.success) {
+                return {
+                    success: false,
+                    error: `Failed to save label for ${scope_type}: ${result.error}`,
+                };
+            }
+            if (result.label) {
+                results.push(result.label);
+            }
+        }
+        return {
+            success: true,
+            labels: results,
+        };
+    }
+    catch (error) {
+        const logger = create_app_logger();
+        const error_message = sanitize_error_for_user(error, {
+            logToConsole: true,
+            logToLogger: true,
+            logger,
+            context: {
+                filename: "scope_labels_service.ts",
+                line_number: 0,
+                operation: "batch_upsert_scope_labels",
+                org,
+            },
+        });
+        return {
+            success: false,
+            error: error_message,
+        };
+    }
+}
+/**
+ * Deletes a scope label, reverting to default
+ */
+export async function delete_scope_label(adapter, org, scope_type) {
+    try {
+        const label_service = createCrudService(adapter, "hazo_scope_labels");
+        // Find the label
+        const existing = await label_service.findBy({ org, scope_type });
+        if (!Array.isArray(existing) || existing.length === 0) {
+            return {
+                success: true, // Already doesn't exist
+            };
+        }
+        const existing_label = existing[0];
+        await label_service.deleteById(existing_label.id);
+        return {
+            success: true,
+            label: existing_label,
+        };
+    }
+    catch (error) {
+        const logger = create_app_logger();
+        const error_message = sanitize_error_for_user(error, {
+            logToConsole: true,
+            logToLogger: true,
+            logger,
+            context: {
+                filename: "scope_labels_service.ts",
+                line_number: 0,
+                operation: "delete_scope_label",
+                org,
+                scope_type,
+            },
+        });
+        return {
+            success: false,
+            error: error_message,
+        };
+    }
+}

package/dist/lib/services/scope_service.d.ts

@@ -0,0 +1,114 @@
+import type { HazoConnectAdapter } from "hazo_connect";
+export type ScopeLevel = "hazo_scopes_l1" | "hazo_scopes_l2" | "hazo_scopes_l3" | "hazo_scopes_l4" | "hazo_scopes_l5" | "hazo_scopes_l6" | "hazo_scopes_l7";
+export type ScopeRecord = {
+    id: string;
+    seq: string;
+    org: string;
+    name: string;
+    parent_scope_id?: string | null;
+    created_at: string;
+    changed_at: string;
+};
+export type ScopeServiceResult = {
+    success: boolean;
+    scope?: ScopeRecord;
+    scopes?: ScopeRecord[];
+    error?: string;
+};
+export type CreateScopeData = {
+    org: string;
+    name: string;
+    parent_scope_id?: string;
+};
+export type UpdateScopeData = {
+    name?: string;
+    parent_scope_id?: string | null;
+};
+export declare const SCOPE_LEVELS: ScopeLevel[];
+export declare const SCOPE_LEVEL_NUMBERS: Record<ScopeLevel, number>;
+/**
+ * Validates that the provided string is a valid scope level
+ */
+export declare function is_valid_scope_level(level: string): level is ScopeLevel;
+/**
+ * Gets the parent level for a given scope level
+ * Returns undefined for L1 (root level)
+ */
+export declare function get_parent_level(level: ScopeLevel): ScopeLevel | undefined;
+/**
+ * Gets the child level for a given scope level
+ * Returns undefined for L7 (leaf level)
+ */
+export declare function get_child_level(level: ScopeLevel): ScopeLevel | undefined;
+/**
+ * Gets all scopes for a given level, optionally filtered by organization
+ */
+export declare function get_scopes_by_level(adapter: HazoConnectAdapter, level: ScopeLevel, org?: string): Promise<ScopeServiceResult>;
+/**
+ * Gets a single scope by ID
+ */
+export declare function get_scope_by_id(adapter: HazoConnectAdapter, level: ScopeLevel, scope_id: string): Promise<ScopeServiceResult>;
+/**
+ * Gets a single scope by seq (friendly ID)
+ */
+export declare function get_scope_by_seq(adapter: HazoConnectAdapter, level: ScopeLevel, seq: string): Promise<ScopeServiceResult>;
+/**
+ * Creates a new scope
+ * Note: The seq field is auto-generated by the database via hazo_scope_id_generator function
+ */
+export declare function create_scope(adapter: HazoConnectAdapter, level: ScopeLevel, data: CreateScopeData): Promise<ScopeServiceResult>;
+/**
+ * Updates an existing scope
+ */
+export declare function update_scope(adapter: HazoConnectAdapter, level: ScopeLevel, scope_id: string, data: UpdateScopeData): Promise<ScopeServiceResult>;
+/**
+ * Deletes a scope (cascades to children via database FK constraints)
+ */
+export declare function delete_scope(adapter: HazoConnectAdapter, level: ScopeLevel, scope_id: string): Promise<ScopeServiceResult>;
+/**
+ * Gets immediate children of a scope
+ */
+export declare function get_scope_children(adapter: HazoConnectAdapter, level: ScopeLevel, scope_id: string): Promise<ScopeServiceResult>;
+/**
+ * Gets all ancestors of a scope up to L1 (root)
+ * Returns array ordered from immediate parent to root (L1)
+ */
+export declare function get_scope_ancestors(adapter: HazoConnectAdapter, level: ScopeLevel, scope_id: string): Promise<ScopeServiceResult>;
+/**
+ * Gets all descendants of a scope down to L7 (leaves)
+ * Returns flat array of all descendant scopes
+ */
+export declare function get_scope_descendants(adapter: HazoConnectAdapter, level: ScopeLevel, scope_id: string): Promise<ScopeServiceResult>;
+/**
+ * Gets scope hierarchy tree for a given organization
+ * Returns nested structure starting from L1
+ */
+export type ScopeTreeNode = ScopeRecord & {
+    children?: ScopeTreeNode[];
+    level: ScopeLevel;
+};
+/**
+ * Organization tree node that groups scopes by organization
+ */
+export type OrgScopeTreeNode = {
+    id: string;
+    name: string;
+    org: string;
+    isOrgNode: true;
+    children: ScopeTreeNode[];
+};
+export declare function get_scope_tree(adapter: HazoConnectAdapter, org: string): Promise<{
+    success: boolean;
+    tree?: ScopeTreeNode[];
+    error?: string;
+}>;
+/**
+ * Gets all scope trees across all organizations
+ * Returns trees for all L1 scopes (top level)
+ */
+export declare function get_all_scope_trees(adapter: HazoConnectAdapter): Promise<{
+    success: boolean;
+    trees?: ScopeTreeNode[];
+    error?: string;
+}>;
+//# sourceMappingURL=scope_service.d.ts.map

package/dist/lib/services/scope_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope_service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/scope_service.ts"],"names":[],"mappings":"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"}