hazo_notify 1.1.3 → 3.0.0

package/dist/{template_manager → lib/template_manager}/db/category_repository.js

@@ -1,18 +1,21 @@
 /**
- * Category repository for template manager
+ * Category repository for template manager (v2.0.0)
  *
- * CRUD operations for template categories using hazo_connect
+ * CRUD operations for template categories using hazo_connect.
+ * Uses scope_id (null = global) for hierarchical category resolution.
  */
-import { TABLE_TEMPLATE_CATEGORY, TABLE_TEMPLATES, ERROR_MESSAGES, } from '../config/constants.js';
+import { TABLE_TEMPLATE_CATEGORY, ERROR_MESSAGES, } from '../config/constants.js';
 import { validate_category_name, validate_uuid } from '../utils/validation.js';
 /**
- * List all template categories for an organization
+ * List all template categories visible for a given scope (scoped rows + global rows).
+ * When scope_id is provided, scoped rows override global rows with the same
+ * template_category_name in the returned set.
  *
  * @param hazo_connect - Database connection instance
- * @param org_id - Organization ID
+ * @param scope_id - Scope to list categories for (null/undefined = global only)
  * @returns Response with array of categories
  */
-export async function list_categories(hazo_connect, org_id) {
+export async function list_categories(hazo_connect, scope_id) {
     try {
         if (!hazo_connect) {
             return {
@@ -21,20 +24,40 @@ export async function list_categories(hazo_connect, org_id) {
                 message: ERROR_MESSAGES.DB_CONNECTION_REQUIRED,
             };
         }
-        if (!validate_uuid(org_id)) {
-            return {
-                success: false,
-                error: 'Invalid organization ID',
-                message: 'Invalid organization ID format',
-            };
+        let categories;
+        if (scope_id) {
+            const scoped_q = hazo_connect
+                .query()
+                .from(TABLE_TEMPLATE_CATEGORY)
+                .select('*')
+                .where('scope_id', 'eq', scope_id);
+            const global_q = hazo_connect
+                .query()
+                .from(TABLE_TEMPLATE_CATEGORY)
+                .select('*')
+                .where('scope_id', 'is', null);
+            const [scoped_rows, global_rows] = await Promise.all([
+                hazo_connect.list(scoped_q),
+                hazo_connect.list(global_q),
+            ]);
+            // Merge: scoped rows override global rows with the same category name
+            const by_name = new Map();
+            for (const row of global_rows)
+                by_name.set(row.template_category_name, row);
+            for (const row of scoped_rows)
+                by_name.set(row.template_category_name, row); // scoped wins
+            categories = Array.from(by_name.values()).sort((a, b) => a.template_category_name.localeCompare(b.template_category_name));
+        }
+        else {
+            // Global-only
+            const q = hazo_connect
+                .query()
+                .from(TABLE_TEMPLATE_CATEGORY)
+                .select('*')
+                .where('scope_id', 'is', null)
+                .order('template_category_name', 'asc');
+            categories = await hazo_connect.list(q);
         }
-        const query = hazo_connect
-            .query()
-            .from(TABLE_TEMPLATE_CATEGORY)
-            .select('*')
-            .where('org_id', 'eq', org_id)
-            .order('template_category_name', 'asc');
-        const categories = await hazo_connect.list(query);
         return {
             success: true,
             data: categories,
@@ -42,16 +65,16 @@ export async function list_categories(hazo_connect, org_id) {
         };
     }
     catch (error) {
-        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        const msg = error instanceof Error ? error.message : 'Unknown error';
         return {
             success: false,
-            error: error_message,
-            message: `Failed to list categories: ${error_message}`,
+            error: msg,
+            message: `Failed to list categories: ${msg}`,
         };
     }
 }
 /**
- * Get a single template category by ID
+ * Get a single template category by ID.
  *
  * @param hazo_connect - Database connection instance
  * @param id - Category ID
@@ -88,16 +111,16 @@ export async function get_category(hazo_connect, id) {
         };
     }
     catch (error) {
-        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        const msg = error instanceof Error ? error.message : 'Unknown error';
         return {
             success: false,
-            error: error_message,
-            message: `Failed to get category: ${error_message}`,
+            error: msg,
+            message: `Failed to get category: ${msg}`,
         };
     }
 }
 /**
- * Create a new template category
+ * Create a new template category.
  *
  * @param hazo_connect - Database connection instance
  * @param data - Category input data
@@ -119,23 +142,15 @@ export async function create_category(hazo_connect, data) {
                 message: ERROR_MESSAGES.INVALID_CATEGORY_NAME,
             };
         }
-        if (!validate_uuid(data.org_id)) {
+        if (data.scope_id != null && !validate_uuid(data.scope_id)) {
             return {
                 success: false,
-                error: 'Invalid organization ID',
-                message: 'Invalid organization ID format',
-            };
-        }
-        if (!validate_uuid(data.root_org_id)) {
-            return {
-                success: false,
-                error: 'Invalid root organization ID',
-                message: 'Invalid root organization ID format',
+                error: 'Invalid scope ID',
+                message: 'Invalid scope ID format',
             };
         }
         const category = await hazo_connect.insert(TABLE_TEMPLATE_CATEGORY, {
-            org_id: data.org_id,
-            root_org_id: data.root_org_id,
+            scope_id: data.scope_id,
             template_category_name: data.template_category_name.trim(),
         });
         return {
@@ -145,16 +160,16 @@ export async function create_category(hazo_connect, data) {
         };
     }
     catch (error) {
-        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        const msg = error instanceof Error ? error.message : 'Unknown error';
         return {
             success: false,
-            error: error_message,
-            message: `Failed to create category: ${error_message}`,
+            error: msg,
+            message: `Failed to create category: ${msg}`,
         };
     }
 }
 /**
- * Update an existing template category
+ * Update an existing template category.
  *
  * @param hazo_connect - Database connection instance
  * @param id - Category ID
@@ -185,7 +200,6 @@ export async function update_category(hazo_connect, id, data) {
                 message: ERROR_MESSAGES.INVALID_CATEGORY_NAME,
             };
         }
-        // Check if category exists
         const existing = await hazo_connect.findById(TABLE_TEMPLATE_CATEGORY, id);
         if (!existing) {
             return {
@@ -198,7 +212,8 @@ export async function update_category(hazo_connect, id, data) {
             changed_at: new Date().toISOString(),
         };
         if (data.template_category_name !== undefined) {
-            update_data.template_category_name = data.template_category_name.trim();
+            update_data.template_category_name =
+                data.template_category_name.trim();
         }
         const category = await hazo_connect.updateById(TABLE_TEMPLATE_CATEGORY, id, update_data);
         return {
@@ -208,16 +223,18 @@ export async function update_category(hazo_connect, id, data) {
         };
     }
     catch (error) {
-        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        const msg = error instanceof Error ? error.message : 'Unknown error';
         return {
             success: false,
-            error: error_message,
-            message: `Failed to update category: ${error_message}`,
+            error: msg,
+            message: `Failed to update category: ${msg}`,
         };
     }
 }
 /**
- * Delete a template category and all its templates
+ * Delete a template category.
+ * If the category has templates and the FK is RESTRICT, the DB will reject
+ * the delete — the error propagates to the caller to handle.
  *
  * @param hazo_connect - Database connection instance
  * @param id - Category ID
@@ -239,7 +256,6 @@ export async function delete_category(hazo_connect, id) {
                 message: 'Invalid category ID format',
             };
         }
-        // Check if category exists
         const existing = await hazo_connect.findById(TABLE_TEMPLATE_CATEGORY, id);
         if (!existing) {
             return {
@@ -248,43 +264,34 @@ export async function delete_category(hazo_connect, id) {
                 message: ERROR_MESSAGES.CATEGORY_NOT_FOUND,
             };
         }
-        // First delete all templates in this category
-        // Note: This could be handled by DB cascade, but we do it explicitly
-        const templates_query = hazo_connect
-            .query()
-            .from(TABLE_TEMPLATES)
-            .select('id')
-            .where('template_category_id', 'eq', id);
-        const templates = await hazo_connect.list(templates_query);
-        for (const template of templates) {
-            await hazo_connect.deleteById(TABLE_TEMPLATES, template.id);
-        }
-        // Delete the category
         await hazo_connect.deleteById(TABLE_TEMPLATE_CATEGORY, id);
         return {
             success: true,
             data: true,
-            message: `Category deleted along with ${templates.length} templates`,
+            message: 'Category deleted successfully',
         };
     }
     catch (error) {
-        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        const msg = error instanceof Error ? error.message : 'Unknown error';
         return {
             success: false,
-            error: error_message,
-            message: `Failed to delete category: ${error_message}`,
+            error: msg,
+            message: `Failed to delete category: ${msg}`,
         };
     }
 }
 /**
- * Find a category by name within an organization
+ * Find a category by name using hierarchical scope resolution.
+ *
+ * scope_chain: [scope_id, ...ancestors] — chain[0] is deepest (most preferred).
+ * Empty array → global-only lookup.
  *
  * @param hazo_connect - Database connection instance
- * @param org_id - Organization ID
- * @param name - Category name
- * @returns Response with category if found
+ * @param scope_chain - Ordered scope chain, deepest first
+ * @param name - Category name to look up
+ * @returns Response with best-matching category or null if not found
  */
-export async function find_category_by_name(hazo_connect, org_id, name) {
+export async function find_category_by_name_in_chain(hazo_connect, scope_chain, name) {
     try {
         if (!hazo_connect) {
             return {
@@ -293,25 +300,62 @@ export async function find_category_by_name(hazo_connect, org_id, name) {
                 message: ERROR_MESSAGES.DB_CONNECTION_REQUIRED,
             };
         }
-        const query = hazo_connect
-            .query()
-            .from(TABLE_TEMPLATE_CATEGORY)
-            .select('*')
-            .where('org_id', 'eq', org_id)
-            .where('template_category_name', 'eq', name.trim());
-        const categories = await hazo_connect.list(query);
+        let candidates = [];
+        if (scope_chain.length > 0) {
+            const scoped_q = hazo_connect
+                .query()
+                .from(TABLE_TEMPLATE_CATEGORY)
+                .select('*')
+                .where('template_category_name', 'eq', name.trim())
+                .whereIn('scope_id', scope_chain);
+            const global_q = hazo_connect
+                .query()
+                .from(TABLE_TEMPLATE_CATEGORY)
+                .select('*')
+                .where('template_category_name', 'eq', name.trim())
+                .where('scope_id', 'is', null);
+            const [scoped, global] = await Promise.all([
+                hazo_connect.list(scoped_q),
+                hazo_connect.list(global_q),
+            ]);
+            candidates = [...scoped, ...global];
+        }
+        else {
+            const q = hazo_connect
+                .query()
+                .from(TABLE_TEMPLATE_CATEGORY)
+                .select('*')
+                .where('template_category_name', 'eq', name.trim())
+                .where('scope_id', 'is', null);
+            candidates = await hazo_connect.list(q);
+        }
+        if (candidates.length === 0) {
+            return {
+                success: true,
+                data: null,
+                message: 'Category not found',
+            };
+        }
+        // Sort: deepest scope first, global last
+        candidates.sort((a, b) => {
+            const ai = a.scope_id !== null ? scope_chain.indexOf(a.scope_id) : -1;
+            const bi = b.scope_id !== null ? scope_chain.indexOf(b.scope_id) : -1;
+            const a_rank = a.scope_id === null ? Infinity : ai === -1 ? Infinity : ai;
+            const b_rank = b.scope_id === null ? Infinity : bi === -1 ? Infinity : bi;
+            return a_rank - b_rank;
+        });
         return {
             success: true,
-            data: categories.length > 0 ? categories[0] : null,
-            message: categories.length > 0 ? 'Category found' : 'Category not found',
+            data: candidates[0],
+            message: 'Category found',
         };
     }
     catch (error) {
-        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        const msg = error instanceof Error ? error.message : 'Unknown error';
         return {
             success: false,
-            error: error_message,
-            message: `Failed to find category: ${error_message}`,
+            error: msg,
+            message: `Failed to find category: ${msg}`,
         };
     }
 }

package/dist/lib/template_manager/db/category_repository.js.map

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

package/dist/lib/template_manager/db/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Database barrel export for template manager (v2.0.0)
+ */
+export { list_categories, get_category, create_category, update_category, delete_category, find_category_by_name_in_chain, } from './category_repository.js';
+export { list_templates, list_templates_by_category, get_template, get_template_by_name, create_template, update_template, delete_template, } from './template_repository.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/template_manager/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/template_manager/db/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/dist/lib/template_manager/db/index.js

@@ -0,0 +1,6 @@
+/**
+ * Database barrel export for template manager (v2.0.0)
+ */
+export { list_categories, get_category, create_category, update_category, delete_category, find_category_by_name_in_chain, } from './category_repository.js';
+export { list_templates, list_templates_by_category, get_template, get_template_by_name, create_template, update_template, delete_template, } from './template_repository.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/template_manager/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/template_manager/db/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/dist/{template_manager → lib/template_manager}/db/template_repository.d.ts

@@ -1,27 +1,30 @@
 /**
- * Template repository for template manager
+ * Template repository for template manager (v2.0.0)
  *
- * CRUD operations for email templates using hazo_connect
+ * CRUD operations for email templates using hazo_connect.
+ * Uses scope_id (null = global) for hierarchical template resolution.
  */
 import type { HazoConnectInstance, EmailTemplate, EmailTemplateInput, EmailTemplateUpdate, TemplateOperationResponse } from '../types.js';
 /**
- * List all email templates for an organization
+ * List all templates visible for a given scope (scoped rows + global rows).
+ * When scope_id is provided, scoped rows override global rows with the same
+ * template_name in the returned set.
  *
  * @param hazo_connect - Database connection instance
- * @param org_id - Organization ID
+ * @param scope_id - Scope to list templates for (null/undefined = global only)
  * @returns Response with array of templates
  */
-export declare function list_templates(hazo_connect: HazoConnectInstance, org_id: string): Promise<TemplateOperationResponse<EmailTemplate[]>>;
+export declare function list_templates(hazo_connect: HazoConnectInstance, scope_id?: string | null): Promise<TemplateOperationResponse<EmailTemplate[]>>;
 /**
- * List templates by category
+ * List templates by category ID.
  *
  * @param hazo_connect - Database connection instance
  * @param category_id - Category ID
  * @returns Response with array of templates
  */
-export declare function list_templates_by_category(hazo_connect: HazoConnectInstance, category_id: string): Promise<TemplateOperationResponse<EmailTemplate[]>>;
+export declare function list_templates_by_category(hazo_connect: HazoConnectInstance, category_id: string, scope_id?: string | null): Promise<TemplateOperationResponse<EmailTemplate[]>>;
 /**
- * Get a single email template by ID
+ * Get a single email template by ID.
  *
  * @param hazo_connect - Database connection instance
  * @param id - Template ID
@@ -29,16 +32,20 @@ export declare function list_templates_by_category(hazo_connect: HazoConnectInst
  */
 export declare function get_template(hazo_connect: HazoConnectInstance, id: string): Promise<TemplateOperationResponse<EmailTemplate>>;
 /**
- * Get a template by name within an organization
+ * Get a template by name using hierarchical scope resolution.
+ *
+ * scope_chain: [scope_id, ...ancestors] — chain[0] is deepest (most preferred).
+ * Empty array → global-only lookup.
+ * Prefers the deepest-scope match; falls back to global (scope_id IS NULL).
  *
  * @param hazo_connect - Database connection instance
- * @param org_id - Organization ID
- * @param template_name - Template name
- * @returns Response with template if found
+ * @param scope_chain - Ordered scope chain, deepest first
+ * @param template_name - Template name to look up
+ * @returns Response with the best-matching template
  */
-export declare function get_template_by_name(hazo_connect: HazoConnectInstance, org_id: string, template_name: string): Promise<TemplateOperationResponse<EmailTemplate>>;
+export declare function get_template_by_name(hazo_connect: HazoConnectInstance, scope_chain: string[], template_name: string): Promise<TemplateOperationResponse<EmailTemplate>>;
 /**
- * Create a new email template
+ * Create a new email template.
  *
  * @param hazo_connect - Database connection instance
  * @param data - Template input data
@@ -46,31 +53,21 @@ export declare function get_template_by_name(hazo_connect: HazoConnectInstance,
  */
 export declare function create_template(hazo_connect: HazoConnectInstance, data: EmailTemplateInput): Promise<TemplateOperationResponse<EmailTemplate>>;
 /**
- * Update an existing email template
+ * Update an existing email template.
  *
  * @param hazo_connect - Database connection instance
  * @param id - Template ID
- * @param data - Update data
+ * @param data - Fields to update
  * @returns Response with updated template
  */
 export declare function update_template(hazo_connect: HazoConnectInstance, id: string, data: EmailTemplateUpdate): Promise<TemplateOperationResponse<EmailTemplate>>;
 /**
- * Delete an email template
+ * Delete a template by ID.
+ * Permission enforcement (manifest protection) is done at the API layer.
  *
  * @param hazo_connect - Database connection instance
  * @param id - Template ID
  * @returns Response with deletion result
  */
 export declare function delete_template(hazo_connect: HazoConnectInstance, id: string): Promise<TemplateOperationResponse<boolean>>;
-/**
- * Seed default templates for an organization
- *
- * Creates a "System" category and populates it with default templates
- *
- * @param hazo_connect - Database connection instance
- * @param org_id - Organization ID
- * @param root_org_id - Root organization ID
- * @returns Response with seeded templates
- */
-export declare function seed_default_templates(hazo_connect: HazoConnectInstance, org_id: string, root_org_id: string): Promise<TemplateOperationResponse<EmailTemplate[]>>;
 //# sourceMappingURL=template_repository.d.ts.map

package/dist/lib/template_manager/db/template_repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_repository.d.ts","sourceRoot":"","sources":["../../../../src/lib/template_manager/db/template_repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAarB;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,mBAAmB,EACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,EAAE,CAAC,CAAC,CA8DrD;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,EAAE,CAAC,CAAC,CAoErD;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CA4CnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAgFnD;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAuFnD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CA8GnD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CA8C7C"}