@hamelin.sh/compiler 0.15.0 → 0.15.2

package/dist/main.d.ts

@@ -46,6 +46,11 @@ interface Column {
     type: HamelinType;
 }
 
+interface CombineQueriesForInliningOk {
+    query: string;
+    cte_names: CteNameEntry[];
+}
+
 interface CompileHamelinQueryResultOk {
     columns: Column[];
 }
@@ -93,6 +98,11 @@ interface ContextualTranslationErrors {
     errors: ContextualTranslationError[];
 }
 
+interface CteNameEntry {
+    catalog_key: string;
+    cte_name: string;
+}
+
 interface FunctionDescription {
     name: string;
     parameters: string;
@@ -115,10 +125,18 @@ interface TranslationError {
     source_desc: string | undefined;
 }
 
+interface WasmCteInline {
+    catalog_key: string;
+    query: string;
+    cte_name: string;
+}
+
 type BuildCatalogError = { kind: "catalogInit"; message: string } | { kind: "compilation"; name: string; errors: ContextualTranslationErrors } | { kind: "datasetParse"; name: string; message: string };
 
 type Catalog = Record<QualifiedDatasetIdentifier, Column[]>;
 
+type CombineQueriesForInliningResult = { Ok: CombineQueriesForInliningOk } | { Err: ContextualTranslationErrors } | { CombineError: string };
+
 type CompileHamelinQueryResult = { Ok: CompileHamelinQueryResultOk } | { Err: ContextualTranslationErrors };
 
 type CompletionItemKind = "Text" | "Variable" | "Function" | "Command" | "Keyword";
@@ -148,6 +166,33 @@ declare const buildCatalog: (startingCatalog: Catalog, resources: Array<CatalogR
 
 declare const checkIncrementalEligibility: (catalog: Catalog, query: string, allowLookups: boolean, defaultSpace?: string | null) => Promise<IncrementalEligibilityResult>;
 
+type CombineQueriesForInliningInput = {
+    mainQuery: string;
+    cteInlines: WasmCteInline[];
+    defaultSpaceCatalogName?: string | null;
+};
+type CombineQueriesForInliningSuccess = {
+    query: string;
+    cteNames: Record<string, string>;
+};
+type CombineQueriesForInliningOutput = {
+    kind: "Ok";
+    value: CombineQueriesForInliningSuccess;
+} | {
+    kind: "Err";
+    value: CombineQueriesForInliningResult & {
+        Err: unknown;
+    };
+} | {
+    kind: "CombineError";
+    message: string;
+};
+/**
+ * Merge upstream queries as tabular DEFs for catalog inlining, rewrite catalog table refs,
+ * and attach the main query.
+ */
+declare const combineQueriesForInlining: ({ mainQuery, cteInlines, defaultSpaceCatalogName, }: CombineQueriesForInliningInput) => Promise<CombineQueriesForInliningOutput>;
+
 declare const compileHamelinQuery: (catalog: Catalog, hamelinInput: string, templateParameters?: Record<string, WasmTemplateParameterKind> | null, defaultSpace?: string | null) => Promise<CompileHamelinQueryResult>;
 
 declare function getCompletions(catalog: Catalog, hamelinInput: string, pos: number, templateParameters?: Record<string, WasmTemplateParameterKind> | null, defaultSpace?: string | null): Promise<Completion | null>;
@@ -266,4 +311,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 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 };
+export { type BuildCatalogError, type BuildCatalogOutput, type Catalog, type Column, type CombineQueriesForInliningOk, type CombineQueriesForInliningResult, 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 WasmCteInline, type WasmTemplateParameterKind, type WasmTemplateParameterValue, buildCatalog, checkIncrementalEligibility, combineQueriesForInlining, compileHamelinQuery, getAggregations, getCompletions, getDatasetsFromQuery, getFunctionDescriptions, getLimits, getMainPipelineSourceRange, getMainPipelineText, getOutputTimestampColumns, getRowCollapsingIdentity, getSelectedFields, getSorts, getSuppress, hamelinGrammar, hamelinPrompt, hasSuppress, insertImplicitSortBeforeLastMainLimit, parseTokenValueClass, sampleCatalog, substituteTemplateParameters };