hazo_notify 1.1.4 → 3.1.0

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

@@ -0,0 +1,284 @@
+/**
+ * Mountable route-handler factory for the template-manager admin UI.
+ *
+ * v3.1.0 lifts the test-app's route handlers + auth wrapper into a single
+ * factory that consumers wire up with three lines:
+ *
+ * ```ts
+ * // app/api/template_manager/[...path]/route.ts
+ * import { create_template_manager_handlers } from 'hazo_notify/template_manager_handlers';
+ * import { create_hazo_auth_adapter } from 'hazo_notify/template_manager_handlers/hazo_auth';
+ * import { get_db } from '@/lib/db';
+ *
+ * export const dynamic = 'force-dynamic';
+ *
+ * const handlers = create_template_manager_handlers({
+ *   hazo_connect_factory: () => get_db(),
+ *   auth: await create_hazo_auth_adapter(),
+ * });
+ *
+ * export const { GET, POST, PUT, PATCH, DELETE, OPTIONS } = handlers;
+ * ```
+ *
+ * Routes handled (relative to mount point):
+ *   GET    /categories                       list categories
+ *   POST   /categories                       create category
+ *   GET    /categories/:id                   get category
+ *   PUT    /categories/:id                   update category (PATCH alias)
+ *   DELETE /categories/:id                   delete category
+ *   GET    /templates                        list templates (?category_id filters)
+ *   POST   /templates                        create template
+ *   GET    /templates/:id                    get template
+ *   PUT    /templates/:id                    update template (PATCH alias)
+ *   DELETE /templates/:id                    delete template
+ *   GET    /types                            list registered template types
+ */
+import 'server-only';
+import { NextResponse } from 'next/server';
+import { list_categories, get_category, create_category, update_category, delete_category, } from '../db/category_repository.js';
+import { list_templates, list_templates_by_category, get_template, create_template, update_template, delete_template, } from '../db/template_repository.js';
+import { get_registered_template_types } from '../registry.js';
+import { load_template_config } from '../config/config_loader.js';
+import { create_with_template_auth, } from './auth.js';
+export { create_with_template_auth } from './auth.js';
+/** Resources exposed by the dispatcher (first path segment after mount). */
+const KNOWN_RESOURCES = new Set(['categories', 'templates', 'types']);
+function default_cors_headers() {
+    let allowed_origins = [];
+    try {
+        const config = load_template_config();
+        allowed_origins = config.cors_allowed_origins ?? [];
+    }
+    catch {
+        allowed_origins = [];
+    }
+    const origin = allowed_origins.length > 0 ? allowed_origins.join(', ') : '*';
+    return {
+        'Access-Control-Allow-Origin': origin,
+        'Access-Control-Allow-Methods': 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+    };
+}
+function resolve_cors(cors_headers) {
+    if (!cors_headers)
+        return default_cors_headers();
+    if (typeof cors_headers === 'function')
+        return cors_headers();
+    return cors_headers;
+}
+/** Extract the relative subpath from the URL by locating a known resource. */
+function extract_subpath(pathname) {
+    const segments = pathname.split('/').filter(Boolean);
+    const idx = segments.findIndex((s) => KNOWN_RESOURCES.has(s));
+    if (idx < 0)
+        return segments;
+    return segments.slice(idx);
+}
+export function create_template_manager_handlers(options) {
+    const get_db = async () => await options.hazo_connect_factory();
+    const cors = () => resolve_cors(options.cors_headers);
+    // Build the per-request auth wrapper. CORS headers are resolved up-front
+    // for the wrapper's error responses; success responses re-resolve below
+    // so a per-request `cors_headers` function still wins for happy paths.
+    const with_template_auth = create_with_template_auth(options.auth, cors());
+    const json = (body, status, headers = cors()) => NextResponse.json(body, { status, headers });
+    const not_found = () => json({ success: false, error: 'Not found', code: 'NOT_FOUND' }, 404);
+    const method_not_allowed = () => json({
+        success: false,
+        error: 'Method not allowed',
+        code: 'METHOD_NOT_ALLOWED',
+    }, 405);
+    // ---- Internal handlers (each wrapped with auth) ---------------------
+    // GET /categories
+    const categories_list = with_template_auth(async (_req, { scope_id }) => {
+        const db = await get_db();
+        const result = await list_categories(db, scope_id);
+        return json(result, result.success ? 200 : 500);
+    });
+    // POST /categories
+    const categories_create = with_template_auth(async (req, { scope_id }) => {
+        const body = await req.json();
+        const { template_category_name } = body;
+        if (!template_category_name) {
+            return json({
+                success: false,
+                error: 'template_category_name is required',
+            }, 400);
+        }
+        const db = await get_db();
+        const result = await create_category(db, {
+            scope_id,
+            template_category_name,
+        });
+        return json(result, result.success ? 201 : 400);
+    });
+    // GET /categories/:id
+    const categories_get = with_template_auth(async (_req, _auth, params) => {
+        const db = await get_db();
+        const result = await get_category(db, params.id);
+        return json(result, result.success ? 200 : 404);
+    });
+    // PUT/PATCH /categories/:id
+    const categories_update = with_template_auth(async (req, _auth, params) => {
+        const body = await req.json();
+        const db = await get_db();
+        const result = await update_category(db, params.id, body);
+        const status = result.success
+            ? 200
+            : result.error?.includes('not found')
+                ? 404
+                : 500;
+        return json(result, status);
+    });
+    // DELETE /categories/:id
+    const categories_delete = with_template_auth(async (_req, _auth, params) => {
+        const db = await get_db();
+        const result = await delete_category(db, params.id);
+        return json(result, result.success ? 200 : 404);
+    });
+    // GET /templates
+    const templates_list = with_template_auth(async (req, { scope_id }) => {
+        const { searchParams } = new URL(req.url);
+        const category_id = searchParams.get('category_id');
+        const db = await get_db();
+        const result = category_id
+            ? await list_templates_by_category(db, category_id, scope_id)
+            : await list_templates(db, scope_id);
+        return json(result, result.success ? 200 : 500);
+    });
+    // POST /templates
+    const templates_create = with_template_auth(async (req, { scope_id }) => {
+        const body = await req.json();
+        const required = [
+            'template_category_id',
+            'template_name',
+            'template_html',
+            'template_text',
+        ];
+        const missing = required.filter((f) => body[f] == null);
+        if (missing.length > 0) {
+            return json({ success: false, error: `Missing: ${missing.join(', ')}` }, 400);
+        }
+        const db = await get_db();
+        const result = await create_template(db, {
+            scope_id,
+            template_category_id: body.template_category_id,
+            template_name: body.template_name,
+            template_html: body.template_html,
+            template_text: body.template_text,
+            template_variables: body.template_variables ?? [],
+        });
+        return json(result, result.success ? 201 : 400);
+    });
+    // GET /templates/:id
+    const templates_get = with_template_auth(async (_req, _auth, params) => {
+        const db = await get_db();
+        const result = await get_template(db, params.id);
+        return json(result, result.success ? 200 : 404);
+    });
+    // PUT/PATCH /templates/:id
+    const templates_update = with_template_auth(async (req, _auth, params) => {
+        const body = await req.json();
+        const db = await get_db();
+        const result = await update_template(db, params.id, body);
+        const status = result.success
+            ? 200
+            : result.error?.includes('not found')
+                ? 404
+                : 500;
+        return json(result, status);
+    });
+    // DELETE /templates/:id
+    const templates_delete = with_template_auth(async (_req, _auth, params) => {
+        const db = await get_db();
+        const result = await delete_template(db, params.id);
+        return json(result, result.success ? 200 : 404);
+    });
+    // GET /types
+    const types_list = with_template_auth(async () => {
+        const types = get_registered_template_types();
+        return json({
+            success: true,
+            data: types,
+            message: `Found ${types.length} template types`,
+        }, 200);
+    });
+    async function dispatch(request, method, raw_ctx) {
+        const segments = extract_subpath(request.nextUrl.pathname);
+        const [resource, id] = segments;
+        if (!resource || !KNOWN_RESOURCES.has(resource))
+            return not_found();
+        // Synthesise a Next-style RouteContext so wrapped handlers receive `id`
+        // even when consumer mounts under a catch-all `[...path]/route.ts`. If
+        // the caller already passed a `params` context (e.g. from a
+        // resource-specific `[id]/route.ts` file), prefer that.
+        const ctx_params = raw_ctx?.params ??
+            (id ? { id } : {});
+        // The wrappers each have their own `RouteContext<P>` generic; cast at the
+        // call site so the dispatcher can route through them uniformly. Wrappers
+        // re-resolve params safely at runtime.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ctx = { params: ctx_params };
+        if (resource === 'categories') {
+            if (id) {
+                switch (method) {
+                    case 'GET':
+                        return categories_get(request, ctx);
+                    case 'PUT':
+                    case 'PATCH':
+                        return categories_update(request, ctx);
+                    case 'DELETE':
+                        return categories_delete(request, ctx);
+                    default:
+                        return method_not_allowed();
+                }
+            }
+            switch (method) {
+                case 'GET':
+                    return categories_list(request, ctx);
+                case 'POST':
+                    return categories_create(request, ctx);
+                default:
+                    return method_not_allowed();
+            }
+        }
+        if (resource === 'templates') {
+            if (id) {
+                switch (method) {
+                    case 'GET':
+                        return templates_get(request, ctx);
+                    case 'PUT':
+                    case 'PATCH':
+                        return templates_update(request, ctx);
+                    case 'DELETE':
+                        return templates_delete(request, ctx);
+                    default:
+                        return method_not_allowed();
+                }
+            }
+            switch (method) {
+                case 'GET':
+                    return templates_list(request, ctx);
+                case 'POST':
+                    return templates_create(request, ctx);
+                default:
+                    return method_not_allowed();
+            }
+        }
+        if (resource === 'types') {
+            if (id || method !== 'GET')
+                return method_not_allowed();
+            return types_list(request, ctx);
+        }
+        return not_found();
+    }
+    return {
+        GET: (req, ctx) => dispatch(req, 'GET', ctx),
+        POST: (req, ctx) => dispatch(req, 'POST', ctx),
+        PUT: (req, ctx) => dispatch(req, 'PUT', ctx),
+        PATCH: (req, ctx) => dispatch(req, 'PATCH', ctx),
+        DELETE: (req, ctx) => dispatch(req, 'DELETE', ctx),
+        OPTIONS: async () => new NextResponse(null, { status: 204, headers: cors() }),
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Template Manager Module (v2.0.0)
+ *
+ * Email template management with Handlebars rendering and database storage.
+ * Uses scope_id for hierarchical template resolution (org hierarchy, tenant hierarchy, etc.).
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   send_template_email,
+ *   register_template_type,
+ *   set_scope_resolver,
+ * } from 'hazo_notify/template_manager';
+ * import { createHazoConnect } from 'hazo_connect/server';
+ *
+ * const hazo = createHazoConnect({ type: 'sqlite', sqlite: { database_path: './db.sqlite' } });
+ *
+ * // Register template types at boot (replaces seed_default_templates)
+ * register_template_type({
+ *   template_name: 'welcome_email',
+ *   template_label: 'Welcome Email',
+ *   variables: [
+ *     { variable_name: 'user_name', variable_description: "Recipient's full name" },
+ *     { variable_name: 'login_url', variable_description: 'URL to login page' },
+ *   ],
+ * });
+ *
+ * // Wire a scope resolver (optional — flat lookup if omitted)
+ * set_scope_resolver(async (scope_id) => {
+ *   // Return ancestor scope IDs, nearest-to-root order
+ *   return db.getAncestors(scope_id);
+ * });
+ *
+ * // Send a templated email
+ * const result = await send_template_email({
+ *   template_name: 'welcome_email',
+ *   variables: { user_name: 'John', login_url: 'https://example.com/login' },
+ *   to: 'john@example.com',
+ *   scope_id: 'tenant-uuid-here',
+ *   subject: 'Welcome!',
+ * }, hazo);
+ * ```
+ */
+export { send_template_email, render_template, preview_template, validate_template_variables, } from './template_manager.js';
+export { load_template_config, get_template_variables, get_all_variable_names, clear_config_cache, } from './config/config_loader.js';
+export { register_template_type, get_registered_template_types, get_registered_template_type, } from './registry.js';
+export { get_scope_chain, invalidate_scope_chain, set_scope_resolver, } from './cache/scope_chain_cache.js';
+export { list_categories, get_category, create_category, update_category, delete_category, find_category_by_name_in_chain, list_templates, list_templates_by_category, get_template, get_template_by_name, create_template, update_template, delete_template, } from './db/index.js';
+export { render_handlebars, render_handlebars_string, clear_template_cache, invalidate_template_cache, resolve_variables, extract_template_references, resolve_template_references, resolve_all_template_references, } from './engine/index.js';
+export { get_system_variables, resolve_system_variables, get_system_variable_definitions, validate_template_name, validate_category_name, validate_variable_name, extract_variables_from_content, validate_provided_variables, } from './utils/index.js';
+export { TABLE_TEMPLATE_CATEGORY, TABLE_TEMPLATES, DEFAULT_CATEGORY_NAMES, MAX_TEMPLATE_NAME_LENGTH, MAX_CATEGORY_NAME_LENGTH, VARIABLE_PATTERN, TEMPLATE_REFERENCE_PATTERN, ERROR_MESSAGES, } from './config/constants.js';
+export { sync_system_templates } from './seed/sync.js';
+export { init_template_manager, verify_notify_setup, } from './init.js';
+export type { InitTemplateManagerOptions } from './init.js';
+export type { TemplateVariableDefinition, TemplateTypeDefinition, SystemVariable, TemplateManagerConfig, SystemTemplateManifest, TemplateCategory, TemplateCategoryInput, TemplateCategoryUpdate, EmailTemplate, EmailTemplateInput, EmailTemplateUpdate, HazoConnectInstance, HazoConnectQueryBuilder, TemplateRenderResult, TemplateOperationResponse, TemplateEmailAttachment, SendTemplateEmailOptions, SendTemplateEmailResponse, CategoryTreeItem, VariableItem, TemplateReferenceItem, Logger, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/template_manager/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAEL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,8BAA8B,EAE9B,cAAc,EACd,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,EAC/B,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAG5D,YAAY,EAEV,0BAA0B,EAC1B,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EAErB,sBAAsB,EAEtB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EAEnB,mBAAmB,EACnB,uBAAuB,EAEvB,oBAAoB,EACpB,yBAAyB,EAEzB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EAEzB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EAErB,MAAM,GACP,MAAM,YAAY,CAAC"}

package/dist/lib/template_manager/index.js

@@ -0,0 +1,68 @@
+/**
+ * Template Manager Module (v2.0.0)
+ *
+ * Email template management with Handlebars rendering and database storage.
+ * Uses scope_id for hierarchical template resolution (org hierarchy, tenant hierarchy, etc.).
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   send_template_email,
+ *   register_template_type,
+ *   set_scope_resolver,
+ * } from 'hazo_notify/template_manager';
+ * import { createHazoConnect } from 'hazo_connect/server';
+ *
+ * const hazo = createHazoConnect({ type: 'sqlite', sqlite: { database_path: './db.sqlite' } });
+ *
+ * // Register template types at boot (replaces seed_default_templates)
+ * register_template_type({
+ *   template_name: 'welcome_email',
+ *   template_label: 'Welcome Email',
+ *   variables: [
+ *     { variable_name: 'user_name', variable_description: "Recipient's full name" },
+ *     { variable_name: 'login_url', variable_description: 'URL to login page' },
+ *   ],
+ * });
+ *
+ * // Wire a scope resolver (optional — flat lookup if omitted)
+ * set_scope_resolver(async (scope_id) => {
+ *   // Return ancestor scope IDs, nearest-to-root order
+ *   return db.getAncestors(scope_id);
+ * });
+ *
+ * // Send a templated email
+ * const result = await send_template_email({
+ *   template_name: 'welcome_email',
+ *   variables: { user_name: 'John', login_url: 'https://example.com/login' },
+ *   to: 'john@example.com',
+ *   scope_id: 'tenant-uuid-here',
+ *   subject: 'Welcome!',
+ * }, hazo);
+ * ```
+ */
+// Core functions
+export { send_template_email, render_template, preview_template, validate_template_variables, } from './template_manager.js';
+// Config
+export { load_template_config, get_template_variables, get_all_variable_names, clear_config_cache, } from './config/config_loader.js';
+// Registry
+export { register_template_type, get_registered_template_types, get_registered_template_type, } from './registry.js';
+// Scope chain cache
+export { get_scope_chain, invalidate_scope_chain, set_scope_resolver, } from './cache/scope_chain_cache.js';
+// Database operations
+export { 
+// Categories
+list_categories, get_category, create_category, update_category, delete_category, find_category_by_name_in_chain, 
+// Templates
+list_templates, list_templates_by_category, get_template, get_template_by_name, create_template, update_template, delete_template, } from './db/index.js';
+// Engine
+export { render_handlebars, render_handlebars_string, clear_template_cache, invalidate_template_cache, resolve_variables, extract_template_references, resolve_template_references, resolve_all_template_references, } from './engine/index.js';
+// Utils
+export { get_system_variables, resolve_system_variables, get_system_variable_definitions, validate_template_name, validate_category_name, validate_variable_name, extract_variables_from_content, validate_provided_variables, } from './utils/index.js';
+// Constants
+export { TABLE_TEMPLATE_CATEGORY, TABLE_TEMPLATES, DEFAULT_CATEGORY_NAMES, MAX_TEMPLATE_NAME_LENGTH, MAX_CATEGORY_NAME_LENGTH, VARIABLE_PATTERN, TEMPLATE_REFERENCE_PATTERN, ERROR_MESSAGES, } from './config/constants.js';
+// Seed
+export { sync_system_templates } from './seed/sync.js';
+// Init
+export { init_template_manager, verify_notify_setup, } from './init.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/template_manager/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAE/B,SAAS;AACT,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,WAAW;AACX,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AAEvB,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC,sBAAsB;AACtB,OAAO;AACL,aAAa;AACb,eAAe,EACf,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,8BAA8B;AAC9B,YAAY;AACZ,cAAc,EACd,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAE3B,QAAQ;AACR,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,EAC/B,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,YAAY;AACZ,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACP,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO;AACP,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,WAAW,CAAC"}

package/dist/lib/template_manager/init.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Boot helper for the template manager (v2.0.0)
+ *
+ * Consumers call init_template_manager() once at application startup to:
+ *  - Obtain a hazo_connect instance via the provided factory
+ *  - Wire an optional scope resolver into the scope chain cache
+ *  - Seed/sync system templates from provided manifests
+ *
+ * verify_notify_setup() can be called after init to confirm the required
+ * database tables are present and queryable.
+ */
+import type { HazoConnectInstance, SystemTemplateManifest } from './types.js';
+export interface InitTemplateManagerOptions {
+    /** Factory that returns (or resolves to) a hazo_connect instance. */
+    hazo_connect_factory: () => Promise<HazoConnectInstance> | HazoConnectInstance;
+    /**
+     * Optional scope resolver. Receives a scope_id and must return the ancestor
+     * chain (nearest-to-root order), NOT including scope_id itself.
+     * Omit for flat (single-scope) lookup mode.
+     */
+    scope_resolver?: (scope_id: string) => Promise<string[]>;
+    /** System template manifests to seed/sync on startup. */
+    manifests?: SystemTemplateManifest[];
+}
+/**
+ * Wire up the template manager at application startup.
+ *
+ * @param options - Factory, optional scope resolver, and optional manifests.
+ * @returns The resolved hazo_connect instance plus sync result counts.
+ */
+export declare function init_template_manager(options: InitTemplateManagerOptions): Promise<{
+    hazo_connect: HazoConnectInstance;
+    synced: number;
+    updated: number;
+    skipped: number;
+    errors: string[];
+}>;
+/**
+ * Verify that the required hazo_notify tables exist and are queryable.
+ *
+ * Performs a lightweight list (limit 1) against both tables. Returns
+ * ok:true only when both succeed.
+ *
+ * @param hazo_connect - An already-initialised hazo_connect instance.
+ */
+export declare function verify_notify_setup(hazo_connect: HazoConnectInstance): Promise<{
+    ok: boolean;
+    tables: {
+        categories: boolean;
+        templates: boolean;
+    };
+    error?: string;
+}>;
+//# sourceMappingURL=init.d.ts.map

package/dist/lib/template_manager/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/lib/template_manager/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAS9E,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;IAC/E;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,yDAAyD;IACzD,SAAS,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAMD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC;IACT,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAuBD;AAMD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC;IACT,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAkCD"}

package/dist/lib/template_manager/init.js

@@ -0,0 +1,85 @@
+/**
+ * Boot helper for the template manager (v2.0.0)
+ *
+ * Consumers call init_template_manager() once at application startup to:
+ *  - Obtain a hazo_connect instance via the provided factory
+ *  - Wire an optional scope resolver into the scope chain cache
+ *  - Seed/sync system templates from provided manifests
+ *
+ * verify_notify_setup() can be called after init to confirm the required
+ * database tables are present and queryable.
+ */
+import { set_scope_resolver } from './cache/scope_chain_cache.js';
+import { sync_system_templates } from './seed/sync.js';
+import { TABLE_TEMPLATE_CATEGORY, TABLE_TEMPLATES } from './config/constants.js';
+// ============================================================
+// init_template_manager
+// ============================================================
+/**
+ * Wire up the template manager at application startup.
+ *
+ * @param options - Factory, optional scope resolver, and optional manifests.
+ * @returns The resolved hazo_connect instance plus sync result counts.
+ */
+export async function init_template_manager(options) {
+    // 1. Resolve hazo_connect (factory may be sync or async)
+    const hazo_connect = await options.hazo_connect_factory();
+    // 2. Wire scope resolver if provided
+    if (options.scope_resolver) {
+        set_scope_resolver(options.scope_resolver);
+    }
+    // 3. Sync manifests if provided and non-empty
+    if (options.manifests && options.manifests.length > 0) {
+        const result = await sync_system_templates(hazo_connect, options.manifests);
+        return {
+            hazo_connect,
+            synced: result.synced,
+            updated: result.updated,
+            skipped: result.skipped,
+            errors: result.errors,
+        };
+    }
+    // No manifests — return zero counts
+    return { hazo_connect, synced: 0, updated: 0, skipped: 0, errors: [] };
+}
+// ============================================================
+// verify_notify_setup
+// ============================================================
+/**
+ * Verify that the required hazo_notify tables exist and are queryable.
+ *
+ * Performs a lightweight list (limit 1) against both tables. Returns
+ * ok:true only when both succeed.
+ *
+ * @param hazo_connect - An already-initialised hazo_connect instance.
+ */
+export async function verify_notify_setup(hazo_connect) {
+    let categories = false;
+    let templates = false;
+    const error_messages = [];
+    // Check categories table
+    try {
+        await hazo_connect.list(hazo_connect.query().from(TABLE_TEMPLATE_CATEGORY).select('*').limit(1));
+        categories = true;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        error_messages.push(`categories: ${msg}`);
+    }
+    // Check templates table
+    try {
+        await hazo_connect.list(hazo_connect.query().from(TABLE_TEMPLATES).select('*').limit(1));
+        templates = true;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        error_messages.push(`templates: ${msg}`);
+    }
+    const ok = categories && templates;
+    return {
+        ok,
+        tables: { categories, templates },
+        ...(error_messages.length > 0 ? { error: error_messages.join('; ') } : {}),
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/lib/template_manager/init.js.map

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

package/dist/lib/template_manager/registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Template type registry for template manager (v2.0.0)
+ *
+ * server-only: do not import in client bundles.
+ *
+ * Consuming packages register their TemplateTypeDefinition entries here at
+ * boot time. First-wins semantics prevent accidental double-registration.
+ */
+import type { TemplateTypeDefinition } from './types.js';
+/**
+ * Register a template type. First-wins: if already registered, logs a warning
+ * and skips. Call this once per template type at application boot time.
+ */
+export declare function register_template_type(def: TemplateTypeDefinition): void;
+/**
+ * Returns all registered template type definitions.
+ */
+export declare function get_registered_template_types(): TemplateTypeDefinition[];
+/**
+ * Get a single registered type by template_name, or undefined if not found.
+ */
+export declare function get_registered_template_type(template_name: string): TemplateTypeDefinition | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/template_manager/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/template_manager/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,CAQxE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,sBAAsB,EAAE,CAExE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,GACpB,sBAAsB,GAAG,SAAS,CAEpC"}

package/dist/lib/template_manager/registry.js

@@ -0,0 +1,33 @@
+/**
+ * Template type registry for template manager (v2.0.0)
+ *
+ * server-only: do not import in client bundles.
+ *
+ * Consuming packages register their TemplateTypeDefinition entries here at
+ * boot time. First-wins semantics prevent accidental double-registration.
+ */
+const registry = new Map();
+/**
+ * Register a template type. First-wins: if already registered, logs a warning
+ * and skips. Call this once per template type at application boot time.
+ */
+export function register_template_type(def) {
+    if (registry.has(def.template_name)) {
+        console.warn(`[hazo_notify] template type '${def.template_name}' already registered; first registration wins`);
+        return;
+    }
+    registry.set(def.template_name, def);
+}
+/**
+ * Returns all registered template type definitions.
+ */
+export function get_registered_template_types() {
+    return Array.from(registry.values());
+}
+/**
+ * Get a single registered type by template_name, or undefined if not found.
+ */
+export function get_registered_template_type(template_name) {
+    return registry.get(template_name);
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/template_manager/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/lib/template_manager/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAA2B;IAChE,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CACV,gCAAgC,GAAG,CAAC,aAAa,+CAA+C,CACjG,CAAC;QACF,OAAO;IACT,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,aAAqB;IAErB,OAAO,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACrC,CAAC"}