@hypequery/datasets 0.21.0 → 0.22.0

package/dist/executor.js

@@ -1,386 +1,23 @@
-import { queryTimezoneErrors, queryTimeFilterSql } from './utils/query-timezone.js';
-import { selectedTimeMeasures, rejectTimeMeasuresOnBackend } from './utils/time-query-measures.js';
-import { buildTimeMeasureDatasetSql } from './utils/time-measure-dataset-sql.js';
-import { baseMeasureNames } from './utils/dataset-measures.js';
-import { protocolMetricCapabilityErrors } from './utils/protocol-metric-capabilities.js';
 import { toQueryBuilderFactory } from './query-builder-protocol.js';
-import { quoteSQLIdentifier, validateSQLIdentifier } from './sql-utils.js';
-import { unsupportedTimeGrainError } from './utils/dataset-time-grains.js';
-import { validateFilterValue } from './validation.js';
-import { applyAggregationSpec, appendOrderLimitOffset, buildDimensionSelectionPlan, resolveDimensionExpression, resolveFilterField, resolveTenantFilterColumn, } from './query-planner.js';
-import { assertMetricHandle, getMetricGrain, getMetricRef, isTenantScopedFilter, } from './utils/metric-handle.js';
-import { validateDerivedCteGrouping } from './utils/derived-cte-validation.js';
-import { buildDatasetQueryBuilder, runDatasetQuery, validateDatasetQuery, } from './dataset-query.js';
-import { buildDerivedDatasetSql, hasSelectedDerivedMeasure, } from './utils/dataset-derived-query.js';
-import { buildDatasetPlan, buildMetricPlan, } from './semantic-planner.js';
-import { getRuntimeTenantId, getRuntimeTenantPredicate, validateTenantRuntime, } from './utils/tenant-runtime.js';
-import { applyPagination, overfetchLimit } from './utils/pagination.js';
+import { MetricQueryEngine } from './metric-query-engine.js';
+import { runDatasetQuery, validateDatasetQuery } from './dataset-query.js';
+import { buildDatasetPlan, buildMetricPlan } from './semantic-planner.js';
+import { assertMetricHandle, getMetricRef } from './utils/metric-handle.js';
+import { validateMetricQueryInput } from './utils/metric-query-validation.js';
+import { prepareDatasetQuery } from './utils/compile-dataset-query.js';
+import { snapshotExecutionContext } from './utils/snapshot-execution-context.js';
+import { isDatasetInstance } from './utils/dataset-target.js';
+import { queryTimezoneErrors } from './utils/query-timezone.js';
+import { rejectTimeMeasuresOnBackend } from './utils/time-query-measures.js';
+import { baseMeasureNames } from './utils/dataset-measures.js';
+import { hasSelectedDerivedMeasure } from './utils/dataset-derived-query.js';
 import { serializeSemanticMeasureValues } from './utils/semantic-result-serialization.js';
+import { resolveResultLimit, withResultLimit } from './utils/result-limits.js';
+import { resolveDatasetCacheRuntime } from './utils/dataset-cache-policy.js';
 import { SemanticQueryCache, } from './cache/semantic-query-cache.js';
 import { datasetCacheKey, metricCacheKey, resolveProtocolCacheKeySettings, } from './cache/protocol-cache-keys.js';
-import { resolveResultLimit, withResultLimit } from './utils/result-limits.js';
-import { resolveDatasetCacheRuntime, } from './utils/dataset-cache-policy.js';
-import { isQualifiedField, resolveQualifiedField } from './utils/relationship-fields.js';
-import { validateQualifiedFilter, validateRelationshipTenantRuntime, } from './utils/relationship-validation.js';
-import { applyRelationshipJoins, buildRelationshipBuilderContext, qualifyBaseColumn, } from './utils/relationship-builder-plan.js';
-import { segmentFilters, segmentSelectionErrors } from './utils/segments.js';
-function validateQuery(metric, query, context) {
-    const errors = [...protocolMetricCapabilityErrors(metric, query), ...queryTimezoneErrors(query.timezone)];
-    const ref = getMetricRef(metric);
-    const ds = ref.dataset;
-    const dimensionNames = Object.keys(ds.dimensions);
-    const filterNames = Object.keys(ds.filters);
-    const grain = getMetricGrain(metric, query);
-    const orderableFields = new Set([
-        ...(query.dimensions ?? []),
-        ref.name,
-        ...(grain ? ['period'] : []),
-    ]);
-    const tenantRuntimeError = validateTenantRuntime(ds, context);
-    if (tenantRuntimeError) {
-        errors.push(tenantRuntimeError);
-    }
-    const relationshipTenantError = validateRelationshipTenantRuntime(ds, query, context);
-    if (relationshipTenantError) {
-        errors.push(relationshipTenantError);
-    }
-    if (metric.__type === 'grained_metric_ref' && query.by && query.by !== metric.grain) {
-        errors.push(`Metric "${ref.name}" is already grained by "${metric.grain}" and cannot be queried with by="${query.by}".`);
-    }
-    // Validate dimensions
-    for (const dim of query.dimensions ?? []) {
-        if (isQualifiedField(dim)) {
-            const resolution = resolveQualifiedField(ds, dim);
-            if (resolution?.error) {
-                errors.push(resolution.error);
-            }
-            continue;
-        }
-        if (!dimensionNames.includes(dim)) {
-            errors.push(`Unknown dimension "${dim}". Available: ${dimensionNames.join(', ')}`);
-        }
-    }
-    // Validate filters
-    for (const filter of query.filters ?? []) {
-        if (isQualifiedField(filter.field)) {
-            const filterError = validateQualifiedFilter(ds, filter, context);
-            if (filterError) {
-                errors.push(filterError);
-            }
-            continue;
-        }
-        if (!filterNames.includes(filter.field)) {
-            errors.push(`Unknown filter field "${filter.field}". Available: ${filterNames.join(', ')}`);
-            continue;
-        }
-        const filterDefinition = ds.filters[filter.field];
-        if (filterDefinition?.operators && !filterDefinition.operators.includes(filter.operator)) {
-            errors.push(`Filter "${filter.field}" does not allow operator "${filter.operator}". Allowed: ${filterDefinition.operators.join(', ')}`);
-            continue;
-        }
-        const resolvedField = ds.filters[filter.field]?.field ?? filter.field;
-        if (isTenantScopedFilter(ds, filter, context)) {
-            errors.push(`Cannot filter on tenant field "${filter.field}" when runtime tenancy enforcement is active.`);
-            continue;
-        }
-        const fieldType = ds.dimensions[resolvedField]?.fieldType;
-        if (fieldType) {
-            const filterError = validateFilterValue(filter, fieldType);
-            if (filterError) {
-                errors.push(filterError);
-            }
-        }
-    }
-    // Validate order by fields against the metric output shape
-    for (const order of query.orderBy ?? []) {
-        if (!orderableFields.has(order.field)) {
-            errors.push(`Unknown orderBy field "${order.field}". Available: ${Array.from(orderableFields).join(', ')}`);
-        }
-    }
-    // Validate grain requires timeKey
-    if (query.by && !ds.timeKey) {
-        errors.push(`Cannot use "by" grain — dataset "${ds.name}" has no timeKey.`);
-    }
-    // Validate grain is one the planner can bucket on
-    errors.push(...segmentSelectionErrors(ds, query.segments));
-    const grainError = query.by && ds.timeKey ? unsupportedTimeGrainError(ds, query.by) : undefined;
-    if (grainError) {
-        errors.push(grainError);
-    }
-    if (query.limit != null && (!Number.isInteger(query.limit) || query.limit < 0)) {
-        errors.push(`Invalid limit: expected a non-negative integer.`);
-    }
-    if (query.offset != null && (!Number.isInteger(query.offset) || query.offset < 0)) {
-        errors.push(`Invalid offset: expected a non-negative integer.`);
-    }
-    // Validate limits
-    if (ds.limits) {
-        if (ds.limits.maxDimensions && (query.dimensions?.length ?? 0) > ds.limits.maxDimensions) {
-            errors.push(`Too many dimensions (${query.dimensions?.length}). Max: ${ds.limits.maxDimensions}`);
-        }
-        if (ds.limits.maxMeasures && 1 > ds.limits.maxMeasures) {
-            errors.push(`Too many measures (1). Max: ${ds.limits.maxMeasures}`);
-        }
-        if (ds.limits.maxFilters && (query.filters?.length ?? 0) > ds.limits.maxFilters) {
-            errors.push(`Too many filters (${query.filters?.length}). Max: ${ds.limits.maxFilters}`);
-        }
-        if (ds.limits.maxResultSize && query.limit != null && query.limit > ds.limits.maxResultSize) {
-            errors.push(`Too many results requested (${query.limit}). Max: ${ds.limits.maxResultSize}`);
-        }
-    }
-    return { valid: errors.length === 0, errors };
-}
-function isDatasetInstance(target) {
-    return !!target && typeof target === 'object' && '__type' in target && target.__type === 'dataset';
-}
-/** Resolves the per-call builder override, adapted to the call contract. */
-function resolveBuilderFactory(context, fallback) {
-    const override = context?.runtime?.builderFactory;
-    return override ? toQueryBuilderFactory(override) : fallback;
-}
-export class MetricQueryEngine {
-    builderFactory;
-    constructor(options) {
-        this.builderFactory = toQueryBuilderFactory(options.builderFactory);
-    }
-    getBuilderFactory() {
-        return this.builderFactory;
-    }
-    /**
-     * Execute a metric query. Generates SQL, applies tenant/filter context, executes.
-     */
-    async run(metric, query = {}, context) {
-        assertMetricHandle(metric);
-        const validation = this.validate(metric, query, context);
-        if (!validation.valid) {
-            throw new Error(`Invalid metric query: ${validation.errors.join('; ')}`);
-        }
-        const start = Date.now();
-        return this.runViaBuilder(metric, query, context, start);
-    }
-    /**
-     * Generate SQL without executing.
-     */
-    toSQL(metric, query = {}, context) {
-        assertMetricHandle(metric);
-        const validation = this.validate(metric, query, context);
-        if (!validation.valid) {
-            throw new Error(`Invalid metric query: ${validation.errors.join('; ')}`);
-        }
-        const ref = getMetricRef(metric);
-        const grain = getMetricGrain(metric, query);
-        const spec = ref.spec;
-        if (spec.__type === 'derived_metric_spec') {
-            return this.buildDerivedSQLViaBuilder(ref, spec, query, grain, context).sql;
-        }
-        const builder = this.buildBaseQuery(ref, spec, ref.dataset, query, grain, context);
-        return builder.toSQLWithParams().sql;
-    }
-    /**
-     * Validate a metric query against the metric's contract.
-     */
-    validate(metric, query, context) {
-        assertMetricHandle(metric);
-        const queryValidation = validateQuery(metric, query, context);
-        if (!queryValidation.valid) {
-            return queryValidation;
-        }
-        const ref = getMetricRef(metric);
-        const grain = getMetricGrain(metric, query);
-        try {
-            if (ref.spec.__type === 'derived_metric_spec') {
-                this.buildDerivedSQLViaBuilder(ref, ref.spec, query, grain, context);
-            }
-            else {
-                this.buildBaseQuery(ref, ref.spec, ref.dataset, query, grain, context).toSQLWithParams();
-            }
-        }
-        catch (error) {
-            return {
-                valid: false,
-                errors: [error instanceof Error ? error.message : String(error)],
-            };
-        }
-        return queryValidation;
-    }
-    // ---------------------------------------------------------------------------
-    // Query builder path
-    // ---------------------------------------------------------------------------
-    async runViaBuilder(metric, query, context, start) {
-        const ref = getMetricRef(metric);
-        const grain = getMetricGrain(metric, query);
-        const spec = ref.spec;
-        const activeBuilderFactory = resolveBuilderFactory(context, this.builderFactory);
-        // Over-fetch one row so we can report `hasMore` without a count query.
-        const buildQuery = { ...query, limit: overfetchLimit(query.limit) };
-        if (spec.__type === 'derived_metric_spec') {
-            // Derived metrics: build CTE via builder, outer query via string, execute via rawQuery
-            const { sql, params } = this.buildDerivedSQLViaBuilder(ref, spec, buildQuery, grain, context);
-            const rows = await activeBuilderFactory.rawQuery(sql, params, {
-                abortSignal: context?.abortSignal,
-            });
-            const timingMs = Date.now() - start;
-            const { data, pagination } = applyPagination(rows, query.limit, query.offset);
-            const serializedData = serializeSemanticMeasureValues(data, [ref.name]);
-            return {
-                data: serializedData,
-                meta: {
-                    sql,
-                    timingMs,
-                    tenant: getRuntimeTenantId(context),
-                    rowCount: serializedData.length,
-                    pagination,
-                },
-            };
-        }
-        // Base metrics: fully use the builder's execute()
-        const builder = this.buildBaseQuery(ref, spec, ref.dataset, buildQuery, grain, context);
-        const { sql } = builder.toSQLWithParams();
-        const rows = await builder.execute({ abortSignal: context?.abortSignal });
-        const timingMs = Date.now() - start;
-        const { data, pagination } = applyPagination(rows, query.limit, query.offset);
-        const serializedData = serializeSemanticMeasureValues(data, [ref.name]);
-        return {
-            data: serializedData,
-            meta: {
-                sql,
-                timingMs,
-                tenant: getRuntimeTenantId(context),
-                rowCount: serializedData.length,
-                pagination,
-            },
-        };
-    }
-    buildBaseQuery(ref, spec, ds, query, grain, context) {
-        const activeBuilderFactory = resolveBuilderFactory(context, this.builderFactory);
-        const joinCtx = buildRelationshipBuilderContext(ds, query, context);
-        let qb = activeBuilderFactory.table(ds.source);
-        qb = applyRelationshipJoins(qb, joinCtx);
-        const { selectParts, groupByParts } = buildDimensionSelectionPlan(ds, query.dimensions ?? [], grain, joinCtx, query.timezone);
-        if (selectParts.length > 0) {
-            qb = qb.select(selectParts);
-        }
-        // Aggregation (appends to select, auto-sets groupBy on non-agg columns)
-        qb = applyAggregationSpec(qb, ds, spec, ref.name, joinCtx);
-        // Explicit groupBy (ensures period + dims are grouped even if aggregation auto-groupBy misses them)
-        if (groupByParts.length > 0) {
-            qb = qb.groupBy(groupByParts);
-        }
-        // Tenant auto-injection
-        const tenantColumn = resolveTenantFilterColumn(ds, context);
-        const tenantPredicate = getRuntimeTenantPredicate(context);
-        if (tenantPredicate && tenantColumn) {
-            qb = qb.where(qualifyBaseColumn(joinCtx, tenantColumn), tenantPredicate.operator, tenantPredicate.value);
-        }
-        // User filters
-        for (const filter of query.filters ?? []) {
-            if (isTenantScopedFilter(ds, filter, context)) {
-                throw new Error(`Cannot filter on tenant field "${filter.field}" when runtime tenancy enforcement is active.`);
-            }
-            const resolvedField = resolveFilterField(ds, filter.field, joinCtx);
-            qb = qb.where(queryTimeFilterSql(ds, filter.field, resolvedField, query.timezone), filter.operator, filter.value);
-        }
-        // Segments: author-defined, so they resolve dimensions directly rather
-        // than through the caller-facing filter allow-list.
-        for (const filter of segmentFilters(ds, query.segments)) {
-            qb = qb.where(resolveDimensionExpression(ds, filter.field, joinCtx), filter.operator, filter.value);
-        }
-        // Order, limit, offset
-        qb = appendOrderLimitOffset(qb, query.orderBy, grain, query.limit, query.offset, joinCtx);
-        return qb;
-    }
-    buildDerivedSQLViaBuilder(ref, spec, query, grain, context) {
-        const activeBuilderFactory = resolveBuilderFactory(context, this.builderFactory);
-        const ds = ref.dataset;
-        const joinCtx = buildRelationshipBuilderContext(ds, query, context);
-        // Build the CTE inner query using the builder
-        let cteBuilder = activeBuilderFactory.table(ds.source);
-        cteBuilder = applyRelationshipJoins(cteBuilder, joinCtx);
-        const { selectParts, groupByParts } = buildDimensionSelectionPlan(ds, query.dimensions ?? [], grain, joinCtx, query.timezone);
-        if (selectParts.length > 0) {
-            cteBuilder = cteBuilder.select(selectParts);
-        }
-        // Base aggregations
-        const refAliases = {};
-        const aggregateAliases = [];
-        for (const [alias, baseMetric] of Object.entries(spec.uses)) {
-            const baseSpec = baseMetric.spec;
-            if (baseSpec.__type !== 'aggregation_spec') {
-                throw new Error(`Derived metric "${ref.name}" references non-base metric "${alias}".`);
-            }
-            cteBuilder = applyAggregationSpec(cteBuilder, ds, baseSpec, alias, joinCtx);
-            refAliases[alias] = alias;
-            aggregateAliases.push(alias);
-        }
-        if (groupByParts.length > 0) {
-            cteBuilder = cteBuilder.groupBy(groupByParts);
-        }
-        // Filters on CTE
-        const tenantColumn = resolveTenantFilterColumn(ds, context);
-        const tenantPredicate = getRuntimeTenantPredicate(context);
-        if (tenantPredicate && tenantColumn) {
-            cteBuilder = cteBuilder.where(qualifyBaseColumn(joinCtx, tenantColumn), tenantPredicate.operator, tenantPredicate.value);
-        }
-        for (const filter of query.filters ?? []) {
-            if (isTenantScopedFilter(ds, filter, context)) {
-                throw new Error(`Cannot filter on tenant field "${filter.field}" when runtime tenancy enforcement is active.`);
-            }
-            const resolvedField = resolveFilterField(ds, filter.field, joinCtx);
-            cteBuilder = cteBuilder.where(queryTimeFilterSql(ds, filter.field, resolvedField, query.timezone), filter.operator, filter.value);
-        }
-        for (const filter of segmentFilters(ds, query.segments)) {
-            cteBuilder = cteBuilder.where(resolveDimensionExpression(ds, filter.field, joinCtx), filter.operator, filter.value);
-        }
-        const { sql: cteSql, parameters: cteParams } = cteBuilder.toSQLWithParams();
-        const groupingErrors = validateDerivedCteGrouping(cteSql, aggregateAliases, groupByParts);
-        if (groupingErrors.length > 0) {
-            throw new Error(groupingErrors.join('; '));
-        }
-        // Outer query: trivial SELECT from the CTE — stays as string concat
-        // because table('base') would fail schema typing
-        const outerSelectParts = [];
-        if (grain)
-            outerSelectParts.push('period');
-        for (const dim of query.dimensions ?? []) {
-            // Joined dimensions surface from the CTE under their quoted qualified alias.
-            if (joinCtx && isQualifiedField(dim)) {
-                outerSelectParts.push(quoteSQLIdentifier(dim));
-                continue;
-            }
-            validateSQLIdentifier(dim, 'dimension name');
-            outerSelectParts.push(dim);
-        }
-        const formulaExpr = spec.formula(refAliases);
-        validateSQLIdentifier(ref.name, 'metric name');
-        outerSelectParts.push(`${formulaExpr.toSQL()} AS ${ref.name}`);
-        let sql = `WITH base AS (${cteSql}) SELECT ${outerSelectParts.join(', ')} FROM base`;
-        // ORDER BY
-        if (query.orderBy && query.orderBy.length > 0) {
-            const orderParts = query.orderBy.map(o => {
-                if (joinCtx && isQualifiedField(o.field)) {
-                    return `${quoteSQLIdentifier(o.field)} ${o.direction.toUpperCase()}`;
-                }
-                validateSQLIdentifier(o.field, 'order by field');
-                return `${o.field} ${o.direction.toUpperCase()}`;
-            });
-            sql += ` ORDER BY ${orderParts.join(', ')}`;
-        }
-        else if (grain) {
-            sql += ' ORDER BY period';
-        }
-        if (query.limit != null) {
-            // Ensure limit is a safe integer
-            const limit = Math.floor(Math.abs(query.limit));
-            sql += ` LIMIT ${limit}`;
-        }
-        if (query.offset != null) {
-            // Ensure offset is a safe integer
-            const offset = Math.floor(Math.abs(query.offset));
-            sql += ` OFFSET ${offset}`;
-        }
-        return { sql, params: cteParams };
-    }
-}
+// Preserve the existing module surface for internal consumers.
+export { MetricQueryEngine } from './metric-query-engine.js';
 export class DatasetClientImpl extends MetricQueryEngine {
     backend;
     defaultTimezone;
@@ -460,11 +97,6 @@ export class DatasetClientImpl extends MetricQueryEngine {
         }
         return this.cacheEnabledByDefault;
     }
-    /**
-     * Context used for cache-key building: fills in the client-level default
-     * `cache.scope` unless the call sets its own, so clients sharing a custom
-     * store can be namespaced apart.
-     */
     /** The call's cache partition: its own `cache.scope`, else the client default. */
     cacheScope(context) {
         if (context?.cache === false)
@@ -474,7 +106,7 @@ export class DatasetClientImpl extends MetricQueryEngine {
     planMetric(metric, query = {}, context) {
         query = this.withTimezone(query);
         assertMetricHandle(metric);
-        const validation = validateQuery(metric, query, context);
+        const validation = validateMetricQueryInput(metric, query, context);
         if (!validation.valid) {
             throw new Error(`Invalid metric query: ${validation.errors.join('; ')}`);
         }
@@ -484,7 +116,10 @@ export class DatasetClientImpl extends MetricQueryEngine {
         return buildDatasetPlan(ds, this.withTimezone(query), context);
     }
     execute(target, query = {}, context) {
-        query = this.withTimezone(query);
+        // An async cache read must not let caller mutations change the query or
+        // tenant after its key has been derived.
+        query = this.withTimezone(structuredClone(query));
+        context = snapshotExecutionContext(context);
         if (this.backend && query.timezone !== undefined) {
             throw new Error('Execution timezone requires the queryBuilder execution path.');
         }
@@ -493,6 +128,16 @@ export class DatasetClientImpl extends MetricQueryEngine {
         }
         return this.executeMetric(target, query, context);
     }
+    compileDataset(target, query = {}, context) {
+        if (this.backend)
+            throw new Error('Dataset compilation requires the queryBuilder execution path.');
+        if (!isDatasetInstance(target))
+            throw new Error('Dataset compilation requires a dataset target.');
+        return prepareDatasetQuery(target, this.withTimezone(query), {
+            builderFactory: this.resolveBuilderFactory(context),
+            context,
+        }).compilation;
+    }
     toSQL(target, query = {}, context) {
         query = this.withTimezone(query);
         if (this.backend && query.timezone !== undefined) {
@@ -522,7 +167,7 @@ export class DatasetClientImpl extends MetricQueryEngine {
         const cacheRuntime = this.datasetCacheContext(ds, context);
         const run = () => {
             if (this.backend) {
-                const validation = validateQuery(metric, boundedQuery, context);
+                const validation = validateMetricQueryInput(metric, boundedQuery, context);
                 if (!validation.valid) {
                     throw new Error(`Invalid metric query: ${validation.errors.join('; ')}`);
                 }
@@ -540,7 +185,7 @@ export class DatasetClientImpl extends MetricQueryEngine {
         // missing tenant runtime cannot be served from cache. Avoid this.validate()
         // here because it dry-builds SQL, which is unnecessary on cache hits and
         // invalid for backend-only clients.
-        const validation = validateQuery(metric, boundedQuery, context);
+        const validation = validateMetricQueryInput(metric, boundedQuery, context);
         if (!validation.valid) {
             throw new Error(`Invalid metric query: ${validation.errors.join('; ')}`);
         }
@@ -575,7 +220,7 @@ export class DatasetClientImpl extends MetricQueryEngine {
                 }));
             }
             return runDatasetQuery(ds, boundedQuery, {
-                builderFactory: resolveBuilderFactory(context, this.getBuilderFactory()),
+                builderFactory: this.resolveBuilderFactory(context),
                 context,
             });
         };
@@ -603,18 +248,10 @@ export class DatasetClientImpl extends MetricQueryEngine {
         return { ...context, cache };
     }
     toDatasetSQL(ds, query, context) {
-        const builderFactory = resolveBuilderFactory(context, this.getBuilderFactory());
-        if (selectedTimeMeasures(ds, query).size) {
-            return buildTimeMeasureDatasetSql(ds, query, { builderFactory, context }).sql;
-        }
-        if (hasSelectedDerivedMeasure(ds, query)) {
-            return buildDerivedDatasetSql(ds, query, { builderFactory, context }, buildDatasetQueryBuilder).sql;
-        }
-        const builder = buildDatasetQueryBuilder(ds, query, {
-            builderFactory,
+        return prepareDatasetQuery(ds, query, {
+            builderFactory: this.resolveBuilderFactory(context),
             context,
-        });
-        return builder.toSQLWithParams().sql;
+        }, 'logical').compilation.sql;
     }
 }
 export function createDatasetClient(options) {

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { createDatasetRegistry } from './registry.js';
 export { publishDatasets } from './publishing/publisher.js';
 export type { DatasetPublisher } from './publishing/publisher.js';
 export type { PublishableMetric, PublishedMetricHandle, PublishedMetricMap, PublishedMetrics, PublishedDataset, PublishedDatasetRegistry, PublishDatasetOptions, } from './publishing/types.js';
-export { getDatasetCatalog, getDatasetCatalogs, getQueryableRelationshipFields } from './catalog.js';
+export { getDatasetCatalog, getDatasetCatalogs, getQueryableRelationshipFields, getQueryableRelationshipMeasures } from './catalog.js';
 export { listQueryableRelationshipFields } from './utils/relationship-fields.js';
 export type { DatasetCatalog, DatasetCatalogMap, DatasetCatalogSource, DimensionCatalogEntry, MeasureCatalogEntry, SegmentCatalogEntry, MetricCatalogEntry, FilterCatalogEntry, RelationshipCatalogEntry, } from './catalog.js';
 export { DEFAULT_AGENT_CATALOG_MAX_BYTES, assertAgentSafeCatalogBudget, projectAgentSafeCatalog, projectTrustedDebugCatalog, } from './agent-catalog.js';
@@ -26,8 +26,8 @@ export { rehydrateProtocolDeploymentContract } from './protocol-rehydrate.js';
 export type { BuildProtocolDatasetContractOptions } from './protocol-adapter.js';
 export { publishToCloud } from './cloud-publishing.js';
 export type { CloudPublishingOptions } from './cloud-publishing.js';
-export { createPortableSemanticExecutor, PortableExecutionBudgetError, PortableExecutionTenantError, PortableExecutionUnsupportedError, } from './portable-executor.js';
-export type { PortableSemanticBudget, PortableSemanticExecutionInput, PortableSemanticExecutorOptions, } from './portable-executor.js';
+export { createPortableSemanticExecutor, createPortableSemanticRuntime, PortableExecutionBudgetError, PortableExecutionTenantError, PortableExecutionUnsupportedError, } from './portable-executor.js';
+export type { PortableSemanticBudget, PortableSemanticRuntime, PortableDatasetCompilation, PortableSemanticExecutionInput, PortableSemanticExecutorOptions, } from './portable-executor.js';
 export { compilePortableSqlExpression, DEFAULT_SQL_PORTABILITY_LIMITS, } from './sql-portability.js';
 export type { SqlPortabilityIssue, SqlPortabilityIssueCode, SqlPortabilityLimits, SqlPortabilityOptions, SqlPortabilityResult, } from './sql-portability.js';
 export type { SemanticContract, SerializeSemanticContractOptions, ContractDataset, ContractDimension, ContractMeasure, ContractMetric, ContractFilter, ContractRelationship, } from './contract.js';
@@ -36,6 +36,7 @@ export { buildDatasetInputSchema, buildMetricInputSchema, buildCanonicalSemantic
 export type { CanonicalSemanticQuerySchemas, SemanticMetricQueryContract, SemanticQuerySchemaLimits, SemanticQuerySchemaOptions, SemanticQuerySchemaSource, } from './semantic-query-schema.js';
 export type { AISDKToolDefinition, DatasetToolAnalytics, DatasetToolMode, GenerateDatasetToolsOptions, JsonSchema, McpToolDefinition, OpenAIToolDefinition, SemanticToolDefinition, } from './tools.js';
 export { createDatasetClient } from './executor.js';
+export type { DatasetSqlDialect } from './dataset-sql-dialect.js';
 export type { DatasetClient, CreateDatasetClientOptions } from './executor.js';
 export { createMemoryCacheStore } from './cache/semantic-query-cache.js';
 export type { SemanticCacheEntry, SemanticCacheMetaInfo, SemanticCacheOptions, SemanticCacheRuntime, SemanticCacheStats, SemanticCacheStore, } from './cache/semantic-query-cache.js';
@@ -49,6 +50,10 @@ export type { QueryBuilderLike, QueryBuilderFactoryLike, QueryBuilderFactoryComp
 export { toQueryBuilderFactory } from './query-builder-protocol.js';
 export { validateSQLIdentifier, isSafeSQLIdentifier, quoteSQLIdentifier } from './sql-utils.js';
 export { GRAIN_FUNCTIONS, SEMANTIC_FILTER_OPERATORS, SUPPORTED_TIME_GRAINS } from './constants.js';
-export type { FieldType, DimensionType, DimensionOptions, DimensionDefinition, MeasureOptions, MeasureDefinition, MeasureTimeInterval, WindowMeasureDefinition, ShiftMeasureDefinition, DatasetMeasureDefinition, DerivedMeasureDefinition, DerivedMeasureOptions, DerivedMeasureUses, InferDimensionType, RelationshipKind, RelationshipDefinition, AggregationType, MeasureAggregation, AggregationSpec, FormulaExpr, DerivedMetricSpec, TimeGrain, MetricRef, BaseMetricRef, DerivedMetricRef, GrainedMetricRef, MetricContract, MetricFilter, MetricOrderBy, MetricQuery, DatasetQuery, MetricResultMeta, MetricResult, DatasetQueryResult, MetricHandle, ExecutionContext, SemanticExecutionRuntime, SemanticTenantRuntime, SemanticFilterDefinition, SegmentDefinition, SemanticFiltersDefinition, DatasetConfig, DatasetDefaults, DatasetFreshness, DatasetLimits, DatasetCachePolicy, SemanticMetadata, SemanticSensitivity, DatasetInstance, AnyDatasetInstance, BaseMetricConfig, DerivedMetricConfig, DatasetRegistryInstance, DatasetFieldNames, DatasetDimensionNames, DatasetQueryableDimensions, DatasetMeasureNames, DatasetSegmentNames, DatasetOrderableNames, DatasetQueryFor, DatasetRow, DatasetRowFor, DatasetQueryResultFor, MetricQueryFor, MetricRow, MetricRowFor, MetricResultFor, KnownStringKeys, } from './types.js';
+export type { FieldType, DimensionType, DimensionOptions, DimensionDefinition, MeasureOptions, MeasureDefinition, MeasureTimeInterval, WindowMeasureDefinition, ShiftMeasureDefinition, DatasetMeasureDefinition, DerivedMeasureDefinition, DerivedMeasureOptions, DerivedMeasureUses, InferDimensionType, RelationshipKind, RelationshipDefinition, AggregationType, MeasureAggregation, AggregationSpec, FormulaExpr, DerivedMetricSpec, TimeGrain, MetricRef, BaseMetricRef, DerivedMetricRef, GrainedMetricRef, MetricContract, MetricFilter, MetricFilterOperator, MetricOrderBy, MetricQuery, DatasetQuery, MetricResultMeta, MetricResult, DatasetQueryResult, MetricHandle, ExecutionContext, SemanticExecutionRuntime, SemanticTenantRuntime, SemanticFilterDefinition, SegmentDefinition, SemanticFiltersDefinition, DatasetConfig, DatasetDefaults, DatasetFreshness, DatasetLimits, DatasetCachePolicy, SemanticMetadata, SemanticSensitivity, DatasetInstance, AnyDatasetInstance, BaseMetricConfig, DerivedMetricConfig, DatasetRegistryInstance, DatasetFieldNames, DatasetDimensionNames, DatasetQueryableDimensions, DatasetQueryableMeasures, DatasetMeasureNames, DatasetSegmentNames, DatasetOrderableNames, DatasetQueryFor, DatasetRow, DatasetRowFor, DatasetQueryResultFor, MetricQueryFor, MetricRow, MetricRowFor, MetricResultFor, KnownStringKeys, } from './types.js';
 export { ProtocolSchemaAdapterError, zodToProtocolSchema } from './protocol-schema-adapter.js';
+export type { DatasetCompilation, DatasetCompiledStatement, DatasetCompilationDescription, } from './dataset-compilation.js';
+export { DATASET_EXECUTION_CAPABILITIES } from './execution-capabilities.js';
+export type { DatasetFeature, DatasetFeatureSupport, DatasetExecutionCapabilities } from './execution-capabilities.js';
+export type { DatasetFilterNames, DatasetFilterFor } from './utils/dataset-filter-types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -18,7 +18,7 @@ export { createDatasetRegistry } from './registry.js';
 // First-class publication builder for Serve, MCP, and agent consumers.
 export { publishDatasets } from './publishing/publisher.js';
 // Catalog
-export { getDatasetCatalog, getDatasetCatalogs, getQueryableRelationshipFields } from './catalog.js';
+export { getDatasetCatalog, getDatasetCatalogs, getQueryableRelationshipFields, getQueryableRelationshipMeasures } from './catalog.js';
 export { listQueryableRelationshipFields } from './utils/relationship-fields.js';
 // Agent-safe and separately authorized trusted-debug catalog projections.
 export { DEFAULT_AGENT_CATALOG_MAX_BYTES, assertAgentSafeCatalogBudget, projectAgentSafeCatalog, projectTrustedDebugCatalog, } from './agent-catalog.js';
@@ -31,7 +31,7 @@ export { buildProtocolDeploymentContract } from './protocol-deployment-adapter.j
 export { rehydrateProtocolDeploymentContract } from './protocol-rehydrate.js';
 export { publishToCloud } from './cloud-publishing.js';
 // Portable native execution of a semantic invocation (decision 0005).
-export { createPortableSemanticExecutor, PortableExecutionBudgetError, PortableExecutionTenantError, PortableExecutionUnsupportedError, } from './portable-executor.js';
+export { createPortableSemanticExecutor, createPortableSemanticRuntime, PortableExecutionBudgetError, PortableExecutionTenantError, PortableExecutionUnsupportedError, } from './portable-executor.js';
 // SQL portability compiler (R1A-07)
 export { compilePortableSqlExpression, DEFAULT_SQL_PORTABILITY_LIMITS, } from './sql-portability.js';
 // Agent/tool metadata
@@ -54,3 +54,4 @@ export { validateSQLIdentifier, isSafeSQLIdentifier, quoteSQLIdentifier } from '
 // Constants
 export { GRAIN_FUNCTIONS, SEMANTIC_FILTER_OPERATORS, SUPPORTED_TIME_GRAINS } from './constants.js';
 export { ProtocolSchemaAdapterError, zodToProtocolSchema } from './protocol-schema-adapter.js';
+export { DATASET_EXECUTION_CAPABILITIES } from './execution-capabilities.js';

package/dist/internal.d.ts

@@ -12,6 +12,9 @@ export type { DatasetClient, CreateDatasetClientOptions, MetricQueryEngineOption
 export { createInMemoryBackend } from './in-memory-backend.js';
 export type { InMemoryTable, InMemoryTables } from './in-memory-backend.js';
 export type { PlanNode, SemanticBackend, SemanticBackendResult, SemanticExpression, SemanticAggregationPlan, SemanticDimensionPlan, SemanticGrainPlan, } from './semantic-plan.js';
+export type { DatasetSqlDialect } from './dataset-sql-dialect.js';
+export { clickhouseDatasetSqlDialect } from './utils/clickhouse-dataset-sql-dialect.js';
+export { resolveDatasetSqlDialect } from './utils/dataset-sql-dialect.js';
 export type { QueryBuilderLike, QueryBuilderFactoryLike } from './query-builder-protocol.js';
 export type { ValidationResult } from './validation.js';
 export { validateFilterValue, matchesFieldType } from './validation.js';

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1F,YAAY,EAAE,aAAa,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACV,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1F,YAAY,EAAE,aAAa,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACV,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/internal.js

@@ -10,6 +10,8 @@
 // Dataset client internals - used by serve to create metric/dataset endpoints
 export { createDatasetClient, DatasetClientImpl, MetricQueryEngine } from './executor.js';
 export { createInMemoryBackend } from './in-memory-backend.js';
+export { clickhouseDatasetSqlDialect } from './utils/clickhouse-dataset-sql-dialect.js';
+export { resolveDatasetSqlDialect } from './utils/dataset-sql-dialect.js';
 export { validateFilterValue, matchesFieldType } from './validation.js';
 // SQL utilities - used by serve for SQL generation
 export { validateSQLIdentifier, isSafeSQLIdentifier, quoteSQLIdentifier } from './sql-utils.js';