@hamelin.sh/compiler 0.11.0 → 0.11.2

package/dist/main.d.ts

@@ -169,6 +169,8 @@ type QueryAggregation = {
     fields: string[];
     by: string[];
     sort: QuerySort[];
+    /** Index of this command in the main pipeline (`command` list, 0-based). */
+    pipelineStageIndex: number;
 };
 declare const getAggregations: (query: string) => QueryAggregation[];
 
@@ -195,9 +197,48 @@ declare function getMainPipelineText(hamelinQuery: string): string;
 
 declare const getOutputTimestampColumns: (catalog: Catalog, hamelinInput: string) => Promise<GetOutputTimestampColumnsResult>;
 
+/**
+ * How the main pipeline defines one logical output row for identity purposes.
+ *
+ * When multiple `AGG` (with `BY`) and/or `SUPPRESS` commands appear, the **last**
+ * such command in the main pipeline wins — it defines the final row shape.
+ */
+type RowCollapsingIdentity = {
+    kind: "none";
+} | {
+    kind: "aggregated";
+    by: string[];
+} | {
+    kind: "suppressed";
+    interval: string;
+    by: string[];
+};
+/**
+ * Returns which row-collapsing command defines output-row identity for the query.
+ *
+ * - `none` — no `AGG` with `BY` and no `SUPPRESS`; callers typically use per-event identity.
+ * - `aggregated` — last `AGG` with non-empty `BY` wins over any earlier `SUPPRESS`.
+ * - `suppressed` — last `SUPPRESS` wins over any earlier `AGG` with `BY`.
+ */
+declare const getRowCollapsingIdentity: (query: string) => RowCollapsingIdentity;
+
 type FieldNames = string[] | null;
 declare const getSelectedFields: (query: string) => FieldNames;
 
+type QuerySuppress = {
+    /** Interval literal text (e.g. `15m`, `1h`). */
+    interval: string;
+    /** Output field names for each BY clause (aliases inferred like AGG). */
+    by: string[];
+    /** Index of this command in the main pipeline (`command` list, 0-based). */
+    pipelineStageIndex: number;
+};
+/**
+ * Returns each `SUPPRESS` command in the main query pipeline, in pipeline order.
+ */
+declare const getSuppress: (query: string) => QuerySuppress[];
+declare const hasSuppress: (query: string) => boolean;
+
 /**
  * Inserts `sortInsertion` immediately before the `|` that precedes the last `LIMIT` stage
  * in the **main** query pipeline (not inside `DEF` bodies). `sortInsertion` should include
@@ -225,4 +266,4 @@ declare const sampleCatalog: Catalog;
  */
 declare const substituteTemplateParameters: (hamelinInput: string, templateValues: Record<string, WasmTemplateParameterValue>, templateParameters?: Record<string, WasmTemplateParameterKind>) => Promise<SubstituteTemplateParametersResult>;
 
-export { type BuildCatalogError, type BuildCatalogOutput, type Catalog, type Column, type CompileHamelinQueryResult, type CompileHamelinQueryResultOk, type Completion, type CompletionItem, type ContextualTranslationError, type ContextualTranslationErrors, type FunctionDescription, type GetOutputTimestampColumnsResult, type GetOutputTimestampColumnsResultOk, type HamelinType, type IncrementalEligibilityResult, type OutputTimestampColumn, type QuerySort, type SubstituteTemplateParametersOk, type SubstituteTemplateParametersResult, type TranslationError, type TruncUnit, type WasmTemplateParameterKind, type WasmTemplateParameterValue, buildCatalog, checkIncrementalEligibility, compileHamelinQuery, getAggregations, getCompletions, getDatasetsFromQuery, getFunctionDescriptions, getLimits, getMainPipelineSourceRange, getMainPipelineText, getOutputTimestampColumns, getSelectedFields, getSorts, hamelinGrammar, hamelinPrompt, insertImplicitSortBeforeLastMainLimit, parseTokenValueClass, sampleCatalog, substituteTemplateParameters };
+export { type BuildCatalogError, type BuildCatalogOutput, type Catalog, type Column, type CompileHamelinQueryResult, type CompileHamelinQueryResultOk, type Completion, type CompletionItem, type ContextualTranslationError, type ContextualTranslationErrors, type FunctionDescription, type GetOutputTimestampColumnsResult, type GetOutputTimestampColumnsResultOk, type HamelinType, type IncrementalEligibilityResult, type OutputTimestampColumn, type QueryAggregation, type QuerySort, type QuerySuppress, type RowCollapsingIdentity, type SubstituteTemplateParametersOk, type SubstituteTemplateParametersResult, type TranslationError, type TruncUnit, type WasmTemplateParameterKind, type WasmTemplateParameterValue, buildCatalog, checkIncrementalEligibility, compileHamelinQuery, getAggregations, getCompletions, getDatasetsFromQuery, getFunctionDescriptions, getLimits, getMainPipelineSourceRange, getMainPipelineText, getOutputTimestampColumns, getRowCollapsingIdentity, getSelectedFields, getSorts, getSuppress, hamelinGrammar, hamelinPrompt, hasSuppress, insertImplicitSortBeforeLastMainLimit, parseTokenValueClass, sampleCatalog, substituteTemplateParameters };