whale-code 6.5.5 → 6.5.7

package/dist/server/handlers/operations.js

@@ -1,114 +1,148 @@
 // server/handlers/operations.ts — Locations, Suppliers, Alerts, Audit Trail handlers
+
 import { sanitizeFilterValue } from "../lib/utils.js";
 import { getClickHouseClient } from "../lib/clickhouse-client.js";
+
 /** Escape single quotes for ClickHouse SQL */
 function escQ(s) {
-    return s.replace(/'/g, "\\'");
+  return s.replace(/'/g, "\\'");
 }
 export async function handleLocations(sb, args, storeId) {
-    const sid = storeId;
-    let q = sb.from("locations").select("id, name, address_line1, city, state, is_active, type").eq("store_id", sid);
-    if (args.is_active !== undefined)
-        q = q.eq("is_active", args.is_active);
-    if (args.name) {
-        const sn = sanitizeFilterValue(args.name);
-        q = q.ilike("name", `%${sn}%`);
-    }
-    const { data, error } = await q;
-    return error ? { success: false, error: error.message } : { success: true, data };
+  const sid = storeId;
+  let q = sb.from("locations").select("id, name, address_line1, city, state, is_active, type").eq("store_id", sid);
+  if (args.is_active !== undefined) q = q.eq("is_active", args.is_active);
+  if (args.name) {
+    const sn = sanitizeFilterValue(args.name);
+    q = q.ilike("name", `%${sn}%`);
+  }
+  const {
+    data,
+    error
+  } = await q;
+  return error ? {
+    success: false,
+    error: error.message
+  } : {
+    success: true,
+    data
+  };
 }
 export async function handleSuppliers(sb, args, storeId) {
-    const sid = storeId;
-    let q = sb.from("suppliers").select("id, external_name, external_company, contact_name, contact_email, contact_phone, city, state, is_active").eq("store_id", sid);
-    if (args.name) {
-        const sn = sanitizeFilterValue(args.name);
-        q = q.or(`external_name.ilike.%${sn}%,external_company.ilike.%${sn}%,contact_name.ilike.%${sn}%`);
-    }
-    const { data, error } = await q;
-    return error ? { success: false, error: error.message } : { success: true, data };
+  const sid = storeId;
+  let q = sb.from("suppliers").select("id, external_name, external_company, contact_name, contact_email, contact_phone, city, state, is_active").eq("store_id", sid);
+  if (args.name) {
+    const sn = sanitizeFilterValue(args.name);
+    q = q.or(`external_name.ilike.%${sn}%,external_company.ilike.%${sn}%,contact_name.ilike.%${sn}%`);
+  }
+  const {
+    data,
+    error
+  } = await q;
+  return error ? {
+    success: false,
+    error: error.message
+  } : {
+    success: true,
+    data
+  };
 }
 export async function handleAlerts(sb, _args, storeId) {
-    const sid = storeId;
-    // Low stock alerts (quantity < 10)
-    const { data: lowStock } = await sb.from("inventory")
-        .select("quantity, product:products(name, sku), location:locations(name)")
-        .eq("store_id", sid).lt("quantity", 10).gt("quantity", 0);
-    const lowStockAlerts = (lowStock || []).map((item) => ({
-        type: "low_stock", severity: "warning",
-        product: item.product?.name || "?", sku: item.product?.sku || "?",
-        location: item.location?.name || "?", quantity: item.quantity,
-    }));
-    // Out of stock
-    const { data: outOfStock } = await sb.from("inventory")
-        .select("product:products(name, sku), location:locations(name)")
-        .eq("store_id", sid).eq("quantity", 0);
-    const outOfStockAlerts = (outOfStock || []).map((item) => ({
-        type: "out_of_stock", severity: "critical",
-        product: item.product?.name || "?", sku: item.product?.sku || "?",
-        location: item.location?.name || "?",
-    }));
-    // Pending orders
-    const { data: pendingOrders } = await sb.from("orders")
-        .select("id, order_number, total_amount, created_at")
-        .eq("store_id", sid).eq("status", "pending");
-    return {
-        success: true,
-        data: {
-            summary: {
-                low_stock: lowStockAlerts.length,
-                out_of_stock: outOfStockAlerts.length,
-                pending_orders: pendingOrders?.length || 0,
-            },
-            low_stock: lowStockAlerts,
-            out_of_stock: outOfStockAlerts,
-            pending_orders: (pendingOrders || []).map((o) => ({
-                order_number: o.order_number, total: o.total_amount, created_at: o.created_at,
-            })),
-        },
-    };
+  const sid = storeId;
+
+  // Low stock alerts (quantity < 10)
+  const {
+    data: lowStock
+  } = await sb.from("inventory").select("quantity, product:products(name, sku), location:locations(name)").eq("store_id", sid).lt("quantity", 10).gt("quantity", 0);
+  const lowStockAlerts = (lowStock || []).map(item => ({
+    type: "low_stock",
+    severity: "warning",
+    product: item.product?.name || "?",
+    sku: item.product?.sku || "?",
+    location: item.location?.name || "?",
+    quantity: item.quantity
+  }));
+
+  // Out of stock
+  const {
+    data: outOfStock
+  } = await sb.from("inventory").select("product:products(name, sku), location:locations(name)").eq("store_id", sid).eq("quantity", 0);
+  const outOfStockAlerts = (outOfStock || []).map(item => ({
+    type: "out_of_stock",
+    severity: "critical",
+    product: item.product?.name || "?",
+    sku: item.product?.sku || "?",
+    location: item.location?.name || "?"
+  }));
+
+  // Pending orders
+  const {
+    data: pendingOrders
+  } = await sb.from("orders").select("id, order_number, total_amount, created_at").eq("store_id", sid).eq("status", "pending");
+  return {
+    success: true,
+    data: {
+      summary: {
+        low_stock: lowStockAlerts.length,
+        out_of_stock: outOfStockAlerts.length,
+        pending_orders: pendingOrders?.length || 0
+      },
+      low_stock: lowStockAlerts,
+      out_of_stock: outOfStockAlerts,
+      pending_orders: (pendingOrders || []).map(o => ({
+        order_number: o.order_number,
+        total: o.total_amount,
+        created_at: o.created_at
+      }))
+    }
+  };
 }
 export async function handleStore(sb, args, storeId) {
-    const sid = storeId;
-    // Get store info with all locations
-    const { data: store, error: storeErr } = await sb.from("stores")
-        .select("id, store_name, email, logo_url, brand_colors, store_tagline")
-        .eq("id", sid)
-        .single();
-    if (storeErr || !store)
-        return { success: false, error: storeErr?.message || "Store not found" };
-    // Fetch locations for this store
-    const { data: locations } = await sb.from("locations")
-        .select("id, name, address_line1, city, state, zip_code, is_active, type")
-        .eq("store_id", sid)
-        .eq("is_active", true);
-    return { success: true, data: { ...store, locations: locations || [] } };
+  const sid = storeId;
+
+  // Get store info with all locations
+  const {
+    data: store,
+    error: storeErr
+  } = await sb.from("stores").select("id, store_name, email, logo_url, brand_colors, store_tagline").eq("id", sid).single();
+  if (storeErr || !store) return {
+    success: false,
+    error: storeErr?.message || "Store not found"
+  };
+
+  // Fetch locations for this store
+  const {
+    data: locations
+  } = await sb.from("locations").select("id, name, address_line1, city, state, zip_code, is_active, type").eq("store_id", sid).eq("is_active", true);
+  return {
+    success: true,
+    data: {
+      ...store,
+      locations: locations || []
+    }
+  };
 }
 export async function handleAuditTrail(sb, args, storeId) {
-    const sid = storeId;
-    const days = args.days || 1;
-    const cutoff = new Date(Date.now() - days * 86400_000).toISOString();
-    const ch = getClickHouseClient();
-    const rowLimit = Math.min(args.limit || 100, 500);
-    // Business audit actions in Postgres business_audit table
-    // All action types that live in business_audit (queried by handleAuditTrail)
-    const BUSINESS_ACTIONS = [
-        "inventory.po_receive", "inventory.transfer_receive", "inventory.transfer_cancel_restore",
-        "inventory.po_create", "inventory.transfer_create", "inventory.adjustment_create",
-        "terminal_credentials_access", "payment.initiated", "payment.failed",
-        "trigger.schedule.fired", "trigger.condition.fired",
-        "trigger.condition.blocked", "trigger.condition.error",
-        "system.connection_warning",
-    ];
-    // "search" action: dual-read ClickHouse + Postgres
-    if (args.action === "search") {
-        const query = args.query;
-        if (!query)
-            return { success: false, error: "query parameter is required for search action" };
-        const sq = sanitizeFilterValue(query);
-        // Parallel: ClickHouse telemetry + Postgres business audit
-        const [chSpans, pgResult] = await Promise.all([
-            ch.isEnabled
-                ? ch.query(`
+  const sid = storeId;
+  const days = args.days || 1;
+  const cutoff = new Date(Date.now() - days * 86400_000).toISOString();
+  const ch = getClickHouseClient();
+  const rowLimit = Math.min(args.limit || 100, 500);
+
+  // Business audit actions in Postgres business_audit table
+  // All action types that live in business_audit (queried by handleAuditTrail)
+  const BUSINESS_ACTIONS = ["inventory.po_receive", "inventory.transfer_receive", "inventory.transfer_cancel_restore", "inventory.po_create", "inventory.transfer_create", "inventory.adjustment_create", "terminal_credentials_access", "payment.initiated", "payment.failed", "trigger.schedule.fired", "trigger.condition.fired", "trigger.condition.blocked", "trigger.condition.error", "system.connection_warning"];
+
+  // "search" action: dual-read ClickHouse + Postgres
+  if (args.action === "search") {
+    const query = args.query;
+    if (!query) return {
+      success: false,
+      error: "query parameter is required for search action"
+    };
+    const sq = sanitizeFilterValue(query);
+
+    // Parallel: ClickHouse telemetry + Postgres business audit
+    const [chSpans, pgResult] = await Promise.all([ch.isEnabled ? ch.query(`
             SELECT
               span_id AS id, operation_name AS action, severity, source,
               '' AS resource_type, tool_name AS resource_id,
@@ -119,37 +153,32 @@ export async function handleAuditTrail(sb, args, storeId) {
               AND (operation_name ILIKE '%${escQ(sq)}%' OR error_message ILIKE '%${escQ(sq)}%' OR tool_name ILIKE '%${escQ(sq)}%')
             ORDER BY started_at DESC
             LIMIT ${rowLimit}
-          `)
-                : Promise.resolve([]),
-            sb.from("business_audit")
-                .select("id, action, severity, source, resource_type, resource_id, details, created_at")
-                .eq("store_id", sid)
-                .gte("created_at", cutoff)
-                .in("action", BUSINESS_ACTIONS)
-                .or(`action.ilike.%${sq}%,resource_id.ilike.%${sq}%`)
-                .order("created_at", { ascending: false })
-                .limit(rowLimit),
-        ]);
-        const entries = [...chSpans, ...(pgResult.data || [])]
-            .sort((a, b) => String(b.created_at).localeCompare(String(a.created_at)))
-            .slice(0, rowLimit);
-        return { success: true, data: { query, entries, count: entries.length, days } };
-    }
-    // Default action: dual-read filtered list
-    const actionFilter = args.action_filter ? sanitizeFilterValue(args.action_filter) : null;
-    const severityFilter = args.severity;
-    const sourceFilter = args.source;
-    // Build ClickHouse filters
-    const chFilters = [`store_id = '${escQ(sid)}'`, `started_at >= '${cutoff}'`];
-    if (actionFilter)
-        chFilters.push(`operation_name ILIKE '%${escQ(actionFilter)}%'`);
-    if (severityFilter)
-        chFilters.push(`severity = '${escQ(severityFilter)}'`);
-    if (sourceFilter)
-        chFilters.push(`source = '${escQ(sourceFilter)}'`);
-    const [chSpans, pgResult] = await Promise.all([
-        ch.isEnabled
-            ? ch.query(`
+          `) : Promise.resolve([]), sb.from("business_audit").select("id, action, severity, source, resource_type, resource_id, details, created_at").eq("store_id", sid).gte("created_at", cutoff).in("action", BUSINESS_ACTIONS).or(`action.ilike.%${sq}%,resource_id.ilike.%${sq}%`).order("created_at", {
+      ascending: false
+    }).limit(rowLimit)]);
+    const entries = [...chSpans, ...(pgResult.data || [])].sort((a, b) => String(b.created_at).localeCompare(String(a.created_at))).slice(0, rowLimit);
+    return {
+      success: true,
+      data: {
+        query,
+        entries,
+        count: entries.length,
+        days
+      }
+    };
+  }
+
+  // Default action: dual-read filtered list
+  const actionFilter = args.action_filter ? sanitizeFilterValue(args.action_filter) : null;
+  const severityFilter = args.severity;
+  const sourceFilter = args.source;
+
+  // Build ClickHouse filters
+  const chFilters = [`store_id = '${escQ(sid)}'`, `started_at >= '${cutoff}'`];
+  if (actionFilter) chFilters.push(`operation_name ILIKE '%${escQ(actionFilter)}%'`);
+  if (severityFilter) chFilters.push(`severity = '${escQ(severityFilter)}'`);
+  if (sourceFilter) chFilters.push(`source = '${escQ(sourceFilter)}'`);
+  const [chSpans, pgResult] = await Promise.all([ch.isEnabled ? ch.query(`
           SELECT
             span_id AS id, operation_name AS action, severity, source,
             '' AS resource_type, tool_name AS resource_id,
@@ -158,35 +187,32 @@ export async function handleAuditTrail(sb, args, storeId) {
           WHERE ${chFilters.join(" AND ")}
           ORDER BY started_at DESC
           LIMIT ${rowLimit}
-        `)
-            : Promise.resolve([]),
-        (() => {
-            let q = sb.from("business_audit")
-                .select("id, action, severity, source, resource_type, resource_id, details, created_at")
-                .eq("store_id", sid)
-                .gte("created_at", cutoff)
-                .in("action", BUSINESS_ACTIONS)
-                .order("created_at", { ascending: false })
-                .limit(rowLimit);
-            if (actionFilter)
-                q = q.ilike("action", `%${actionFilter}%`);
-            if (args.resource_type)
-                q = q.eq("resource_type", args.resource_type);
-            if (severityFilter)
-                q = q.eq("severity", severityFilter);
-            if (sourceFilter)
-                q = q.eq("source", sourceFilter);
-            return q;
-        })(),
-    ]);
-    const entries = [...chSpans, ...(pgResult.data || [])]
-        .sort((a, b) => String(b.created_at).localeCompare(String(a.created_at)))
-        .slice(0, rowLimit);
-    // Summarize by action for quick overview
-    const byAction = {};
-    for (const entry of entries) {
-        const act = entry.action;
-        byAction[act] = (byAction[act] || 0) + 1;
+        `) : Promise.resolve([]), (() => {
+    let q = sb.from("business_audit").select("id, action, severity, source, resource_type, resource_id, details, created_at").eq("store_id", sid).gte("created_at", cutoff).in("action", BUSINESS_ACTIONS).order("created_at", {
+      ascending: false
+    }).limit(rowLimit);
+    if (actionFilter) q = q.ilike("action", `%${actionFilter}%`);
+    if (args.resource_type) q = q.eq("resource_type", args.resource_type);
+    if (severityFilter) q = q.eq("severity", severityFilter);
+    if (sourceFilter) q = q.eq("source", sourceFilter);
+    return q;
+  })()]);
+  const entries = [...chSpans, ...(pgResult.data || [])].sort((a, b) => String(b.created_at).localeCompare(String(a.created_at))).slice(0, rowLimit);
+
+  // Summarize by action for quick overview
+  const byAction = {};
+  for (const entry of entries) {
+    const act = entry.action;
+    byAction[act] = (byAction[act] || 0) + 1;
+  }
+  return {
+    success: true,
+    data: {
+      entries,
+      summary: byAction,
+      days,
+      count: entries.length
     }
-    return { success: true, data: { entries, summary: byAction, days, count: entries.length } };
+  };
 }
+//# sourceMappingURL=operations.js.map

package/dist/server/handlers/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","names":["sanitizeFilterValue","getClickHouseClient","escQ","s","replace","handleLocations","sb","args","storeId","sid","q","from","select","eq","is_active","undefined","name","sn","ilike","data","error","success","message","handleSuppliers","or","handleAlerts","_args","lowStock","lt","gt","lowStockAlerts","map","item","type","severity","product","sku","location","quantity","outOfStock","outOfStockAlerts","pendingOrders","summary","low_stock","length","out_of_stock","pending_orders","o","order_number","total","total_amount","created_at","handleStore","store","storeErr","single","locations","handleAuditTrail","days","cutoff","Date","now","toISOString","ch","rowLimit","Math","min","limit","BUSINESS_ACTIONS","action","query","sq","chSpans","pgResult","Promise","all","isEnabled","resolve","gte","in","order","ascending","entries","sort","a","b","String","localeCompare","slice","count","actionFilter","action_filter","severityFilter","sourceFilter","source","chFilters","push","join","resource_type","byAction","entry","act"],"sources":["../../../src/server/handlers/operations.ts"],"sourcesContent":["// server/handlers/operations.ts — Locations, Suppliers, Alerts, Audit Trail handlers\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport { sanitizeFilterValue } from \"../lib/utils.js\";\nimport { getClickHouseClient } from \"../lib/clickhouse-client.js\";\n\n/** Escape single quotes for ClickHouse SQL */\nfunction escQ(s: string): string {\n  return s.replace(/'/g, \"\\\\'\");\n}\n\nexport async function handleLocations(sb: SupabaseClient, args: Record<string, unknown>, storeId?: string) {\n  const sid = storeId as string;\n  let q = sb.from(\"locations\").select(\"id, name, address_line1, city, state, is_active, type\").eq(\"store_id\", sid);\n  if (args.is_active !== undefined) q = q.eq(\"is_active\", args.is_active as boolean);\n  if (args.name) { const sn = sanitizeFilterValue(args.name as string); q = q.ilike(\"name\", `%${sn}%`); }\n  const { data, error } = await q;\n  return error ? { success: false, error: error.message } : { success: true, data };\n}\n\nexport async function handleSuppliers(sb: SupabaseClient, args: Record<string, unknown>, storeId?: string) {\n  const sid = storeId as string;\n  let q = sb.from(\"suppliers\").select(\"id, external_name, external_company, contact_name, contact_email, contact_phone, city, state, is_active\").eq(\"store_id\", sid);\n  if (args.name) { const sn = sanitizeFilterValue(args.name as string); q = q.or(`external_name.ilike.%${sn}%,external_company.ilike.%${sn}%,contact_name.ilike.%${sn}%`); }\n  const { data, error } = await q;\n  return error ? { success: false, error: error.message } : { success: true, data };\n}\n\nexport async function handleAlerts(sb: SupabaseClient, _args: Record<string, unknown>, storeId?: string) {\n  const sid = storeId as string;\n\n  // Low stock alerts (quantity < 10)\n  const { data: lowStock } = await sb.from(\"inventory\")\n    .select(\"quantity, product:products(name, sku), location:locations(name)\")\n    .eq(\"store_id\", sid).lt(\"quantity\", 10).gt(\"quantity\", 0);\n  const lowStockAlerts = (lowStock || []).map((item: any) => ({\n    type: \"low_stock\" as const, severity: \"warning\" as const,\n    product: item.product?.name || \"?\", sku: item.product?.sku || \"?\",\n    location: item.location?.name || \"?\", quantity: item.quantity,\n  }));\n\n  // Out of stock\n  const { data: outOfStock } = await sb.from(\"inventory\")\n    .select(\"product:products(name, sku), location:locations(name)\")\n    .eq(\"store_id\", sid).eq(\"quantity\", 0);\n  const outOfStockAlerts = (outOfStock || []).map((item: any) => ({\n    type: \"out_of_stock\" as const, severity: \"critical\" as const,\n    product: item.product?.name || \"?\", sku: item.product?.sku || \"?\",\n    location: item.location?.name || \"?\",\n  }));\n\n  // Pending orders\n  const { data: pendingOrders } = await sb.from(\"orders\")\n    .select(\"id, order_number, total_amount, created_at\")\n    .eq(\"store_id\", sid).eq(\"status\", \"pending\");\n\n  return {\n    success: true,\n    data: {\n      summary: {\n        low_stock: lowStockAlerts.length,\n        out_of_stock: outOfStockAlerts.length,\n        pending_orders: pendingOrders?.length || 0,\n      },\n      low_stock: lowStockAlerts,\n      out_of_stock: outOfStockAlerts,\n      pending_orders: (pendingOrders || []).map((o: any) => ({\n        order_number: o.order_number, total: o.total_amount, created_at: o.created_at,\n      })),\n    },\n  };\n}\n\nexport async function handleStore(sb: SupabaseClient, args: Record<string, unknown>, storeId?: string) {\n  const sid = storeId as string;\n\n  // Get store info with all locations\n  const { data: store, error: storeErr } = await sb.from(\"stores\")\n    .select(\"id, store_name, email, logo_url, brand_colors, store_tagline\")\n    .eq(\"id\", sid)\n    .single();\n\n  if (storeErr || !store) return { success: false, error: storeErr?.message || \"Store not found\" };\n\n  // Fetch locations for this store\n  const { data: locations } = await sb.from(\"locations\")\n    .select(\"id, name, address_line1, city, state, zip_code, is_active, type\")\n    .eq(\"store_id\", sid)\n    .eq(\"is_active\", true);\n\n  return { success: true, data: { ...store, locations: locations || [] } };\n}\n\nexport async function handleAuditTrail(sb: SupabaseClient, args: Record<string, unknown>, storeId?: string) {\n  const sid = storeId as string;\n  const days = (args.days as number) || 1;\n  const cutoff = new Date(Date.now() - days * 86400_000).toISOString();\n  const ch = getClickHouseClient();\n  const rowLimit = Math.min((args.limit as number) || 100, 500);\n\n  // Business audit actions in Postgres business_audit table\n  // All action types that live in business_audit (queried by handleAuditTrail)\n  const BUSINESS_ACTIONS = [\n    \"inventory.po_receive\", \"inventory.transfer_receive\", \"inventory.transfer_cancel_restore\",\n    \"inventory.po_create\", \"inventory.transfer_create\", \"inventory.adjustment_create\",\n    \"terminal_credentials_access\", \"payment.initiated\", \"payment.failed\",\n    \"trigger.schedule.fired\", \"trigger.condition.fired\",\n    \"trigger.condition.blocked\", \"trigger.condition.error\",\n    \"system.connection_warning\",\n  ];\n\n  // \"search\" action: dual-read ClickHouse + Postgres\n  if (args.action === \"search\") {\n    const query = args.query as string;\n    if (!query) return { success: false, error: \"query parameter is required for search action\" };\n    const sq = sanitizeFilterValue(query);\n\n    // Parallel: ClickHouse telemetry + Postgres business audit\n    const [chSpans, pgResult] = await Promise.all([\n      ch.isEnabled\n        ? ch.query<Record<string, unknown>>(`\n            SELECT\n              span_id AS id, operation_name AS action, severity, source,\n              '' AS resource_type, tool_name AS resource_id,\n              user_id AS user_email, attributes AS details, started_at AS created_at\n            FROM ai_spans\n            WHERE store_id = '${escQ(sid)}'\n              AND started_at >= '${cutoff}'\n              AND (operation_name ILIKE '%${escQ(sq)}%' OR error_message ILIKE '%${escQ(sq)}%' OR tool_name ILIKE '%${escQ(sq)}%')\n            ORDER BY started_at DESC\n            LIMIT ${rowLimit}\n          `)\n        : Promise.resolve([]),\n      sb.from(\"business_audit\")\n        .select(\"id, action, severity, source, resource_type, resource_id, details, created_at\")\n        .eq(\"store_id\", sid)\n        .gte(\"created_at\", cutoff)\n        .in(\"action\", BUSINESS_ACTIONS)\n        .or(`action.ilike.%${sq}%,resource_id.ilike.%${sq}%`)\n        .order(\"created_at\", { ascending: false })\n        .limit(rowLimit),\n    ]);\n\n    const entries = [...chSpans, ...(pgResult.data || [])]\n      .sort((a, b) => String(b.created_at).localeCompare(String(a.created_at)))\n      .slice(0, rowLimit);\n    return { success: true, data: { query, entries, count: entries.length, days } };\n  }\n\n  // Default action: dual-read filtered list\n  const actionFilter = args.action_filter ? sanitizeFilterValue(args.action_filter as string) : null;\n  const severityFilter = args.severity as string | undefined;\n  const sourceFilter = args.source as string | undefined;\n\n  // Build ClickHouse filters\n  const chFilters: string[] = [`store_id = '${escQ(sid)}'`, `started_at >= '${cutoff}'`];\n  if (actionFilter) chFilters.push(`operation_name ILIKE '%${escQ(actionFilter)}%'`);\n  if (severityFilter) chFilters.push(`severity = '${escQ(severityFilter)}'`);\n  if (sourceFilter) chFilters.push(`source = '${escQ(sourceFilter)}'`);\n\n  const [chSpans, pgResult] = await Promise.all([\n    ch.isEnabled\n      ? ch.query<Record<string, unknown>>(`\n          SELECT\n            span_id AS id, operation_name AS action, severity, source,\n            '' AS resource_type, tool_name AS resource_id,\n            attributes AS details, user_id AS user_email, started_at AS created_at\n          FROM ai_spans\n          WHERE ${chFilters.join(\" AND \")}\n          ORDER BY started_at DESC\n          LIMIT ${rowLimit}\n        `)\n      : Promise.resolve([]),\n    (() => {\n      let q = sb.from(\"business_audit\")\n        .select(\"id, action, severity, source, resource_type, resource_id, details, created_at\")\n        .eq(\"store_id\", sid)\n        .gte(\"created_at\", cutoff)\n        .in(\"action\", BUSINESS_ACTIONS)\n        .order(\"created_at\", { ascending: false })\n        .limit(rowLimit);\n      if (actionFilter) q = q.ilike(\"action\", `%${actionFilter}%`);\n      if (args.resource_type) q = q.eq(\"resource_type\", args.resource_type as string);\n      if (severityFilter) q = q.eq(\"severity\", severityFilter);\n      if (sourceFilter) q = q.eq(\"source\", sourceFilter);\n      return q;\n    })(),\n  ]);\n\n  const entries = [...chSpans, ...(pgResult.data || [])]\n    .sort((a, b) => String(b.created_at).localeCompare(String(a.created_at)))\n    .slice(0, rowLimit);\n\n  // Summarize by action for quick overview\n  const byAction: Record<string, number> = {};\n  for (const entry of entries) {\n    const act = entry.action as string;\n    byAction[act] = (byAction[act] || 0) + 1;\n  }\n\n  return { success: true, data: { entries, summary: byAction, days, count: entries.length } };\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/server/handlers/operations.test.js

@@ -0,0 +1,136 @@
+// operations.test.ts — Tests for handleLocations, handleSuppliers, handleAlerts, handleStore, handleAuditTrail
+
+import { describe, it, expect, afterEach } from "vitest";
+import { HAS_TEST_DB, getTestClient, seedTracked, cleanup, TEST_STORE, RUN_PREFIX } from "./__test-utils__/test-db.js";
+import { randomUUID } from "node:crypto";
+import { handleLocations, handleAlerts, handleAuditTrail } from "./operations.js";
+const sb = getTestClient();
+describe.skipIf(!HAS_TEST_DB)("handleLocations", () => {
+  afterEach(async () => {
+    await cleanup();
+  });
+  it("lists all locations for a store", async () => {
+    await seedTracked("locations", [{
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      name: `${RUN_PREFIX} Main Store`,
+      slug: `${RUN_PREFIX}-main-store`,
+      is_active: true,
+      type: "retail"
+    }, {
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      name: `${RUN_PREFIX} Warehouse`,
+      slug: `${RUN_PREFIX}-warehouse`,
+      is_active: false,
+      type: "warehouse"
+    }]);
+    const result = await handleLocations(sb, {}, TEST_STORE);
+    expect(result.success).toBe(true);
+    expect(result.data.length).toBeGreaterThanOrEqual(2);
+  });
+  it("filters by is_active", async () => {
+    await seedTracked("locations", [{
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      name: `${RUN_PREFIX} Active`,
+      slug: `${RUN_PREFIX}-active`,
+      type: "retail",
+      is_active: true
+    }, {
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      name: `${RUN_PREFIX} Inactive`,
+      slug: `${RUN_PREFIX}-inactive`,
+      type: "warehouse",
+      is_active: false
+    }]);
+    const result = await handleLocations(sb, {
+      is_active: true
+    }, TEST_STORE);
+    expect(result.success).toBe(true);
+  });
+  it("filters by name (ilike)", async () => {
+    await seedTracked("locations", [{
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      name: `${RUN_PREFIX} Main Store`,
+      slug: `${RUN_PREFIX}-main-store`,
+      type: "retail"
+    }, {
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      name: `${RUN_PREFIX} Warehouse North`,
+      slug: `${RUN_PREFIX}-wh-north`,
+      type: "warehouse"
+    }]);
+    const result = await handleLocations(sb, {
+      name: `${RUN_PREFIX} Main`
+    }, TEST_STORE);
+    expect(result.success).toBe(true);
+  });
+});
+describe.skipIf(!HAS_TEST_DB)("handleAlerts", () => {
+  afterEach(async () => {
+    await cleanup();
+  });
+  it("returns alerts summary for the store", async () => {
+    const result = await handleAlerts(sb, {}, TEST_STORE);
+    expect(result.success).toBe(true);
+    const data = result.data;
+    const summary = data.summary;
+    expect(summary.low_stock).toBeGreaterThanOrEqual(0);
+    expect(summary.out_of_stock).toBeGreaterThanOrEqual(0);
+    expect(summary.pending_orders).toBeGreaterThanOrEqual(0);
+  });
+});
+describe.skipIf(!HAS_TEST_DB)("handleAuditTrail", () => {
+  afterEach(async () => {
+    await cleanup();
+  });
+  it("lists recent audit log entries", async () => {
+    await seedTracked("business_audit", [{
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      action: "order_created",
+      severity: "info"
+    }, {
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      action: "product_updated",
+      severity: "info"
+    }]);
+    const result = await handleAuditTrail(sb, {
+      days: 7
+    }, TEST_STORE);
+    expect(result.success).toBe(true);
+    const data = result.data;
+    expect(data.count).toBeGreaterThanOrEqual(2);
+  });
+  it("filters by severity", async () => {
+    await seedTracked("business_audit", [{
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      action: "error_occurred",
+      severity: "error"
+    }, {
+      id: randomUUID(),
+      store_id: TEST_STORE,
+      action: "login",
+      severity: "info"
+    }]);
+    const result = await handleAuditTrail(sb, {
+      severity: "error",
+      days: 7
+    }, TEST_STORE);
+    expect(result.success).toBe(true);
+  });
+  it("returns error for search without query", async () => {
+    const result = await handleAuditTrail(sb, {
+      action: "search",
+      days: 7
+    }, TEST_STORE);
+    expect(result.success).toBe(false);
+    expect(result.error).toBe("query parameter is required for search action");
+  });
+});

package/dist/server/handlers/platform-telemetry.d.ts

@@ -0,0 +1,10 @@
+import type { SupabaseClient } from "@supabase/supabase-js";
+export declare function handleTelemetry(sb: SupabaseClient, args: Record<string, unknown>, storeId?: string): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: any;
+    error?: undefined;
+}>;