semanticdb-v2 2.0.0-alpha.8 → 2.0.0-alpha.9

package/dist/executor/execute-query.d.ts

@@ -2,7 +2,8 @@ import type { CompiledQuery } from '../compiler/index';
 import type { DataRow } from '../physical/index';
 import type { LogicalPlan } from '../planner/index';
 import type { SchemaMappingDefinition, SchemaMappingRegistry } from '../schema-mappings/index';
-import type { InternalExecuteOptions } from './types';
+import type { InternalExecuteOptions, SqlExecutionSource } from './types';
+export type SqlExecutionSourceReporter = (source: SqlExecutionSource) => void;
 export interface PhysicalQuerySource {
     readonly schemaId: string;
     readonly source: string;
@@ -13,6 +14,6 @@ export interface PhysicalQuerySource {
 export declare const resolvePhysicalSourceMapping: (source: PhysicalQuerySource, mappings: SchemaMappingRegistry) => SchemaMappingDefinition | undefined;
 export declare const collectPlanSources: (plan: LogicalPlan) => readonly PhysicalQuerySource[];
 export declare const mergePhysicalSources: (groups: readonly (readonly PhysicalQuerySource[])[]) => readonly PhysicalQuerySource[];
-export declare const executeCompiledQuery: (compiled: CompiledQuery, sources: readonly PhysicalQuerySource[], options: Pick<InternalExecuteOptions, "cache" | "provider" | "schemaMappings" | "signal" | "connectionId">) => Promise<DataRow[]>;
+export declare const executeCompiledQuery: (compiled: CompiledQuery, sources: readonly PhysicalQuerySource[], options: Pick<InternalExecuteOptions, "cache" | "provider" | "schemaMappings" | "signal" | "connectionId">, reportExecutionSource?: SqlExecutionSourceReporter) => Promise<DataRow[]>;
 /** Apply final SQL shaping after all plans, views, and derived sources are compiled. */
 export declare const shortenCompiledQuery: (compiled: CompiledQuery) => CompiledQuery;

package/dist/executor/federated-execution.d.ts

@@ -4,6 +4,7 @@ import type { OperatorRegistry } from '../operators/index';
 import type { CoreComputeProvider, DataRow } from '../physical/index';
 import type { LogicalPlan } from '../planner/index';
 import type { SchemaMappingRegistry } from '../schema-mappings/index';
+import type { SqlExecutionSourceReporter } from './execute-query';
 import type { InternalExecuteOptions } from './types';
 export declare const coordinatorConnectionId = "__semanticdb_coordinator__";
 export interface FederatedCompiledQuery {
@@ -21,7 +22,7 @@ interface FederatedExecutionOptions {
     readonly cache?: InternalExecuteOptions['cache'];
     readonly signal?: AbortSignal;
     readonly maxMaterializedRows: number;
-    readonly onCompiled: (query: FederatedCompiledQuery) => void;
+    readonly onCompiled: (query: FederatedCompiledQuery) => SqlExecutionSourceReporter;
 }
 export interface FederatedExecutionResult {
     readonly rows: DataRow[];

package/dist/executor/fetch-entities.d.ts

@@ -9,6 +9,7 @@ import type { Permissions } from '../permissions/index';
 import type { ResolvedSemanticSchema, SemanticTypeRegistry } from '../semantic-types/index';
 import type { EntityFetchRequest } from './result-hydrator/index';
 import type { SemanticDBPlugin } from '../plugins/index';
+import type { SqlExecutionSourceReporter } from './execute-query';
 import type { LocaleRegistry } from '../i18n/index';
 interface FetchEntityOptions {
     readonly version: string;
@@ -25,7 +26,7 @@ interface FetchEntityOptions {
     readonly preferredConnectionId?: string;
     readonly cache?: QueryCacheExecutionOptions;
     readonly signal?: AbortSignal;
-    readonly onCompiled?: (compiled: CompiledQuery, logicform: LogicformType, provider: CoreComputeProvider, connectionId?: string) => void;
+    readonly onCompiled?: (compiled: CompiledQuery, logicform: LogicformType, provider: CoreComputeProvider, connectionId?: string) => SqlExecutionSourceReporter | undefined;
 }
 export declare const fetchEntities: (request: EntityFetchRequest, options: FetchEntityOptions) => Promise<DataRow[]>;
 export {};

package/dist/executor/index.d.ts

@@ -1,3 +1,3 @@
 export { execute } from './execute';
 export { closeConnections } from './connection-registry';
-export type { ExecuteOptions, ExecuteFailureResult, ExecuteProgressEvent, ExecuteResult, ExecuteSuccessResult, ExecutedSql, ExecutedSqlType, PartialExecuteResult, ProgressCallback, } from './types';
+export type { ExecuteOptions, ExecuteFailureResult, ExecuteProgressEvent, ExecuteResult, ExecuteSuccessResult, ExecutedSql, ExecutedSqlType, SqlExecutionSource, PartialExecuteResult, ProgressCallback, } from './types';

package/dist/executor/types.d.ts

@@ -140,6 +140,7 @@ export interface ExecuteFailureResult {
 }
 export type ExecuteResult = ExecuteSuccessResult | ExecuteFailureResult;
 export type ExecutedSqlType = 'computation' | 'semantic-resolution' | 'total';
+export type SqlExecutionSource = 'cache' | 'database';
 export interface ExecutedSql {
     /** Why this SQL participates in the LogicForm execution. */
     readonly type: ExecutedSqlType;
@@ -155,6 +156,8 @@ export interface ExecutedSql {
     readonly parameters: SqlParameters;
     /** Dialect-formatted diagnostic SQL. SemanticDB never executes this string. */
     readonly displaySql: string;
+    /** Actual row source. Absent only before execution, such as in the compiled progress event. */
+    readonly executionSource?: SqlExecutionSource;
 }
 export type PartialExecuteResult = Partial<ExecuteSuccessResult>;
 export {};

package/dist/index.d.ts

@@ -19,7 +19,7 @@ export type { OperatorDefinition, OperatorDefaultNameContext, OperatorExecutionC
 export type { SchemaMappingDefinition, SchemaMappingEnrichmentDefinition, SchemaMappingEnrichmentKey, SchemaMappingItem, SchemaMappingGranularity, SchemaMappingGranularityExtensions, SchemaMappingPointTemporalDefinition, SchemaMappingPredDefinition, SchemaMappingPredMatch, SchemaMappingSelection, RejectedSchemaMapping, SourceFreshnessPolicy, YiAskSchemaMappingItem, YiAskSchemaMappingRecord, } from './schema-mappings/index';
 export { QueryCacheManager } from './cache/index';
 export type { InvalidateQueryCacheSourceOptions, QueryCacheConfiguration, } from './cache/index';
-export type { ExecuteOptions, ExecuteFailureResult, ExecuteProgressEvent, ExecuteResult, ExecuteSuccessResult, ExecutedSql, ExecutedSqlType, PartialExecuteResult, ProgressCallback, } from './executor/index';
+export type { ExecuteOptions, ExecuteFailureResult, ExecuteProgressEvent, ExecuteResult, ExecuteSuccessResult, ExecutedSql, ExecutedSqlType, SqlExecutionSource, PartialExecuteResult, ProgressCallback, } from './executor/index';
 export type { ColumnPermissions, Permissions, SchemaPermissions, } from './permissions/index';
 export type { CreateLogicalPlanOptions, LogicalPlan, QueryLineage, } from './planner/index';
 export { PlannerSemanticRegistry, createPlannerSemanticRegistry, } from './planner/index';

package/dist/operators/types.d.ts

@@ -174,9 +174,9 @@ export interface OperatorRewriteLogicformContext extends OperatorHookContext {
     readonly getOperator?: (name: string) => OperatorDefinition;
 }
 export interface OperatorComponentContext extends OperatorHookContext {
-    /** Fully normalized LogicForm containing this top-level operator projection. */
+    /** Normalized input LogicForm; having, sort, limit, limitBy, and page stay on the merged result. */
     readonly logicform: LogicformType;
-    /** Caller-authored normalized LogicForm before executor row policies were added. */
+    /** Caller-authored normalized input before executor row policies, with result operations removed. */
     readonly sourceLogicform?: LogicformType;
     /** The operator projection for which the component is being built. */
     readonly pred: PredItemType;