@objectstack/objectql 9.0.0 → 9.0.1

package/dist/index.mjs

@@ -611,6 +611,172 @@ var init_seed_loader = __esm({
   }
 });
 
+// src/build-probes.ts
+var build_probes_exports = {};
+__export(build_probes_exports, {
+  runBuildProbes: () => runBuildProbes
+});
+function asRec(v) {
+  return v && typeof v === "object" && !Array.isArray(v) ? v : void 0;
+}
+function asArr(v) {
+  return Array.isArray(v) ? v : [];
+}
+function resultRows(result) {
+  if (Array.isArray(result)) return result;
+  const r = asRec(result);
+  if (!r) return [];
+  if (Array.isArray(r.rows)) return r.rows;
+  if (Array.isArray(r.data)) return r.data;
+  return [];
+}
+async function hasRows(engine, objectName, organizationId) {
+  const rows = await engine.find(objectName, {
+    fields: ["id"],
+    limit: 1,
+    ...organizationId ? { where: { organization_id: organizationId } } : {},
+    context: { isSystem: true }
+  });
+  return Array.isArray(rows) && rows.length > 0;
+}
+async function runBuildProbes(opts) {
+  const issues = [];
+  const checked = { seeds: 0, views: 0, widgets: 0 };
+  const { engine, getItem, published, analytics, organizationId } = opts;
+  const itemCache = /* @__PURE__ */ new Map();
+  const readItem = async (type, name) => {
+    const key = `${type} ${name}`;
+    if (itemCache.has(key)) return itemCache.get(key);
+    let item;
+    try {
+      item = await getItem(type, name);
+    } catch {
+      item = void 0;
+    }
+    itemCache.set(key, item);
+    return item;
+  };
+  for (const p of published.filter((x) => x.type === "seed")) {
+    const body = asRec(await readItem("seed", p.name));
+    const objectName = typeof body?.object === "string" ? body.object : void 0;
+    if (!objectName) continue;
+    checked.seeds += 1;
+    try {
+      if (!await hasRows(engine, objectName, organizationId)) {
+        issues.push({
+          layer: "runtime",
+          severity: "error",
+          artifact: { type: "seed", name: p.name },
+          ref: { type: "object", name: objectName },
+          code: "seed_not_applied",
+          message: `Seed "${p.name}" was published but object "${objectName}" has no rows \u2014 the sample data never materialized.`,
+          fix: `Check the publish response's seedApplied for the load error, fix the seed rows (field names/types), and republish the seed.`
+        });
+      }
+    } catch (e) {
+      issues.push({
+        layer: "runtime",
+        severity: "error",
+        artifact: { type: "seed", name: p.name },
+        ref: { type: "object", name: objectName },
+        code: "seed_not_applied",
+        message: `Seed "${p.name}" probe could not read object "${objectName}": ${String(e?.message ?? e)}`
+      });
+    }
+  }
+  for (const p of published.filter((x) => x.type === "view")) {
+    const body = asRec(await readItem("view", p.name));
+    const config = asRec(body?.config);
+    const dataObj = asRec(config?.data)?.object;
+    const objectName = typeof body?.object === "string" ? body.object : typeof dataObj === "string" ? dataObj : void 0;
+    if (!objectName) continue;
+    checked.views += 1;
+    try {
+      await engine.find(objectName, {
+        fields: ["id"],
+        limit: 1,
+        ...organizationId ? { where: { organization_id: organizationId } } : {},
+        context: { isSystem: true }
+      });
+    } catch (e) {
+      issues.push({
+        layer: "runtime",
+        severity: "error",
+        artifact: { type: "view", name: p.name },
+        ref: { type: "object", name: objectName },
+        code: "view_read_failed",
+        message: `View "${p.name}" cannot read object "${objectName}": ${String(e?.message ?? e)} \u2014 it will render as an error for every user.`,
+        fix: `Verify object "${objectName}" published successfully (its table must exist) and that the view's binding is correct.`
+      });
+    }
+  }
+  const dashboards = published.filter((x) => x.type === "dashboard");
+  let widgetsToProbe = 0;
+  for (const p of dashboards) {
+    const body = asRec(await readItem("dashboard", p.name));
+    const widgets = asArr(body?.widgets).map(asRec).filter((w) => !!w);
+    const datasetBound = widgets.filter((w) => typeof w.dataset === "string" && w.dataset);
+    widgetsToProbe += datasetBound.length;
+    if (!analytics || typeof analytics.queryDataset !== "function") continue;
+    for (const w of datasetBound) {
+      const widgetId = String(w.id ?? w.title ?? "?");
+      const dsName = w.dataset;
+      const dataset = asRec(await readItem("dataset", dsName));
+      if (!dataset) continue;
+      checked.widgets += 1;
+      const measures = asArr(w.values).filter((v) => typeof v === "string" && v.length > 0);
+      const firstMeasure = asRec(asArr(dataset.measures)[0])?.name;
+      const selection = {
+        measures: measures.length ? measures : typeof firstMeasure === "string" ? [firstMeasure] : [],
+        dimensions: [],
+        limit: 1
+      };
+      if (selection.measures.length === 0) continue;
+      const objectName = typeof dataset.object === "string" ? dataset.object : void 0;
+      try {
+        const result = await analytics.queryDataset(dataset, selection, void 0);
+        const rows = resultRows(result);
+        if (rows.length === 0 && objectName && await hasRows(engine, objectName, organizationId)) {
+          issues.push({
+            layer: "runtime",
+            severity: "error",
+            artifact: { type: "dashboard", name: p.name },
+            ref: { type: "dataset", name: dsName, member: widgetId },
+            code: "empty_query",
+            message: `Dashboard "${p.name}" widget "${widgetId}" returns NO data from dataset "${dsName}" although object "${objectName}" has rows \u2014 the widget will render empty for every user.`,
+            fix: `Run the dataset query directly to see the compiled strategy/SQL; check the dataset's measure/dimension field bindings against object "${objectName}".`
+          });
+        }
+      } catch (e) {
+        issues.push({
+          layer: "runtime",
+          severity: "error",
+          artifact: { type: "dashboard", name: p.name },
+          ref: { type: "dataset", name: dsName, member: widgetId },
+          code: "widget_query_failed",
+          message: `Dashboard "${p.name}" widget "${widgetId}" query against dataset "${dsName}" failed: ${String(e?.message ?? e)}`,
+          fix: `Fix the dataset definition (or the widget's values/dimensions) so the query compiles, then republish.`
+        });
+      }
+    }
+  }
+  if (widgetsToProbe > 0 && (!analytics || typeof analytics.queryDataset !== "function")) {
+    issues.push({
+      layer: "runtime",
+      severity: "warning",
+      artifact: { type: "dashboard", name: dashboards.map((d) => d.name).join(", ") },
+      code: "probes_unavailable",
+      message: `${widgetsToProbe} dashboard widget(s) could not be probed: no analytics service is mounted on this kernel.`
+    });
+  }
+  return { issues, checked };
+}
+var init_build_probes = __esm({
+  "src/build-probes.ts"() {
+    "use strict";
+  }
+});
+
 // src/registry.ts
 import { ObjectSchema } from "@objectstack/spec/data";
 import { readEnvWithDeprecation } from "@objectstack/types";
@@ -4967,13 +5133,38 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
         });
       }
     }
+    const seedApplied = seedBodies.length > 0 ? await this.applySeedBodies(seedBodies, orgId) : void 0;
+    let probes;
+    if (published.length > 0) {
+      try {
+        const { runBuildProbes: runBuildProbes2 } = await Promise.resolve().then(() => (init_build_probes(), build_probes_exports));
+        const analytics = this.getServicesRegistry?.().get("analytics");
+        probes = await runBuildProbes2({
+          engine: this.engine,
+          getItem: async (type, name) => {
+            const wrapper = await this.getMetaItem({
+              type,
+              name,
+              ...orgId ? { organizationId: orgId } : {}
+            });
+            return wrapper?.item ?? wrapper ?? void 0;
+          },
+          published,
+          ...analytics && typeof analytics.queryDataset === "function" ? { analytics } : {},
+          organizationId: orgId
+        });
+      } catch {
+        probes = void 0;
+      }
+    }
     return {
       success: failed.length === 0 && published.length > 0,
       publishedCount: published.length,
       failedCount: failed.length,
       published,
       failed,
-      ...seedBodies.length > 0 ? { seedApplied: await this.applySeedBodies(seedBodies, orgId) } : {}
+      ...seedApplied ? { seedApplied } : {},
+      ...probes ? { probes } : {}
     };
   }
   /**
@@ -9840,6 +10031,7 @@ function convertIntrospectedSchemaToObjects(introspectedSchema, options) {
 
 // src/index.ts
 init_seed_loader();
+init_build_probes();
 export {
   DEFAULT_EXTENDER_PRIORITY,
   DEFAULT_OWNER_PRIORITY,
@@ -9873,6 +10065,7 @@ export {
   noopHookMetricsRecorder,
   parseFQN,
   parseSecretRef,
+  runBuildProbes,
   toTitleCase,
   validateRecord,
   wrapDeclarativeHook