@objectstack/service-analytics 10.0.0 → 10.3.0

package/dist/index.d.cts

@@ -221,6 +221,14 @@ interface AnalyticsServiceConfig {
      * `StrategyContext.coerceTemporalFilterValue` for the full rationale.
      */
     coerceTemporalFilterValue?: (objectName: string, fieldName: string, value: unknown) => unknown;
+    /**
+     * ADR-0062 D6 — report whether an object is federated (external datasource).
+     * Threaded into the StrategyContext so `NativeSQLStrategy` declines external
+     * objects (which it would otherwise query against the wrong physical table),
+     * routing them to the driver-correct ObjectQL aggregate path instead. See
+     * `StrategyContext.isExternalObject`.
+     */
+    isExternalObject?: (objectName: string) => boolean;
     /**
      * ADR-0021 — optional object-graph resolver used when compiling datasets:
      * `(baseObject, relationshipName) => relatedObjectName | undefined`. When

package/dist/index.d.ts

@@ -221,6 +221,14 @@ interface AnalyticsServiceConfig {
      * `StrategyContext.coerceTemporalFilterValue` for the full rationale.
      */
     coerceTemporalFilterValue?: (objectName: string, fieldName: string, value: unknown) => unknown;
+    /**
+     * ADR-0062 D6 — report whether an object is federated (external datasource).
+     * Threaded into the StrategyContext so `NativeSQLStrategy` declines external
+     * objects (which it would otherwise query against the wrong physical table),
+     * routing them to the driver-correct ObjectQL aggregate path instead. See
+     * `StrategyContext.isExternalObject`.
+     */
+    isExternalObject?: (objectName: string) => boolean;
     /**
      * ADR-0021 — optional object-graph resolver used when compiling datasets:
      * `(baseObject, relationshipName) => relatedObjectName | undefined`. When

package/dist/index.js

@@ -320,6 +320,17 @@ var NativeSQLStrategy = class {
   canHandle(query, ctx) {
     if (!query.cube) return false;
     if (query.timeDimensions?.some((td) => !!td.granularity)) return false;
+    if (typeof ctx.isExternalObject === "function") {
+      const cube = ctx.getCube(query.cube);
+      if (cube) {
+        if (ctx.isExternalObject(this.extractObjectName(cube))) return false;
+        const joinTargets = cube.joins ? Object.values(cube.joins) : [];
+        for (const j of joinTargets) {
+          const joinedObject = j?.name;
+          if (joinedObject && ctx.isExternalObject(joinedObject)) return false;
+        }
+      }
+    }
     const caps = ctx.queryCapabilities(query.cube);
     return caps.nativeSql && typeof ctx.executeRawSql === "function";
   }
@@ -1477,7 +1488,8 @@ var AnalyticsService = class {
       // Prefer a compiled dataset's declared relationships (D-C join allowlist);
       // fall back to any explicitly-configured provider for legacy cubes.
       getAllowedRelationships: (cubeName) => this.datasetRegistry.get(cubeName)?.allowedRelationships ?? config.getAllowedRelationships?.(cubeName),
-      coerceTemporalFilterValue: config.coerceTemporalFilterValue
+      coerceTemporalFilterValue: config.coerceTemporalFilterValue,
+      isExternalObject: config.isExternalObject
     };
     const builtIn = [
       new NativeSQLStrategy(),
@@ -1745,9 +1757,10 @@ var AnalyticsService = class {
     if (!cube) {
       cube = this.inferCubeFromQuery(query);
       this.cubeRegistry.register(cube);
-      this.logger.warn(
-        `[Analytics] No cube registered for "${name}"; auto-inferred a minimal cube (sql="${name}", measures=${Object.keys(cube.measures).join(",") || "(none)"}, dimensions=${Object.keys(cube.dimensions).join(",") || "(none)"}). Define an explicit Cube in your stack for full control.`
-      );
+      const isScalarMetric = (query.dimensions?.length ?? 0) === 0 && (query.timeDimensions?.length ?? 0) === 0;
+      const message = `[Analytics] No cube registered for "${name}"; auto-inferred a minimal cube (sql="${name}", measures=${Object.keys(cube.measures).join(",") || "(none)"}, dimensions=${Object.keys(cube.dimensions).join(",") || "(none)"}). Define an explicit Cube in your stack for full control.`;
+      if (isScalarMetric) this.logger.debug(message);
+      else this.logger.warn(message);
       return;
     }
     const stripPrefix = (m) => m.includes(".") ? m.split(".").slice(1).join(".") : m;
@@ -2082,6 +2095,13 @@ var AnalyticsServicePlugin = class {
         const f = dataEngine()?.getObject?.(object)?.fields?.[field];
         return f ? { type: f.type, defaultCurrency: f.currencyConfig?.defaultCurrency } : void 0;
       },
+      // ADR-0062 D6 — a federated object carries an `external` block (ADR-0015).
+      // Reported so NativeSQLStrategy declines it (its hand-compiled FROM would
+      // hit the wrong physical table) and the driver-correct ObjectQL path runs.
+      isExternalObject: (objectName) => {
+        const obj = dataEngine()?.getObject?.(objectName);
+        return !!(obj && obj.external != null);
+      },
       draftRowsResolver
     };
     if (autoBridgedReadScope) {