@lightdash/common 3.214.1 → 3.215.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/dist/cjs/.tsbuildinfo +1 -1
  2. package/dist/cjs/ee/AiAgent/composerArtifact.d.ts.map +1 -1
  3. package/dist/cjs/ee/AiAgent/composerArtifact.js +1 -0
  4. package/dist/cjs/ee/AiAgent/composerArtifact.js.map +1 -1
  5. package/dist/cjs/ee/AiAgent/composerMergeChart.d.ts +18 -0
  6. package/dist/cjs/ee/AiAgent/composerMergeChart.d.ts.map +1 -0
  7. package/dist/cjs/ee/AiAgent/composerMergeChart.js +109 -0
  8. package/dist/cjs/ee/AiAgent/composerMergeChart.js.map +1 -0
  9. package/dist/cjs/ee/AiAgent/index.d.ts +1 -0
  10. package/dist/cjs/ee/AiAgent/index.d.ts.map +1 -1
  11. package/dist/cjs/ee/AiAgent/index.js +1 -0
  12. package/dist/cjs/ee/AiAgent/index.js.map +1 -1
  13. package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts +144 -2
  14. package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts.map +1 -1
  15. package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js +188 -3
  16. package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js.map +1 -1
  17. package/dist/cjs/schemas/chartAsCodeSchema.d.ts +38 -38
  18. package/dist/cjs/schemas/json/mcp-tools-1.0.json +220 -2
  19. package/dist/cjs/types/mergeQuery.d.ts +20 -0
  20. package/dist/cjs/types/mergeQuery.d.ts.map +1 -1
  21. package/dist/cjs/types/mergeQuery.js +50 -1
  22. package/dist/cjs/types/mergeQuery.js.map +1 -1
  23. package/dist/cjs/types/queryHistory.d.ts +2 -0
  24. package/dist/cjs/types/queryHistory.d.ts.map +1 -1
  25. package/dist/cjs/types/querySources.d.ts +40 -2
  26. package/dist/cjs/types/querySources.d.ts.map +1 -1
  27. package/dist/cjs/types/querySources.js +45 -1
  28. package/dist/cjs/types/querySources.js.map +1 -1
  29. package/dist/cjs/utils/i18n/uiStrings.d.ts +15 -0
  30. package/dist/cjs/utils/i18n/uiStrings.d.ts.map +1 -1
  31. package/dist/cjs/utils/i18n/uiStrings.js +15 -0
  32. package/dist/cjs/utils/i18n/uiStrings.js.map +1 -1
  33. package/dist/cjs/utils/item.js +1 -1
  34. package/dist/cjs/utils/item.js.map +1 -1
  35. package/dist/esm/.tsbuildinfo +1 -1
  36. package/dist/esm/ee/AiAgent/composerArtifact.d.ts.map +1 -1
  37. package/dist/esm/ee/AiAgent/composerArtifact.js +1 -0
  38. package/dist/esm/ee/AiAgent/composerArtifact.js.map +1 -1
  39. package/dist/esm/ee/AiAgent/composerMergeChart.d.ts +18 -0
  40. package/dist/esm/ee/AiAgent/composerMergeChart.d.ts.map +1 -0
  41. package/dist/esm/ee/AiAgent/composerMergeChart.js +105 -0
  42. package/dist/esm/ee/AiAgent/composerMergeChart.js.map +1 -0
  43. package/dist/esm/ee/AiAgent/index.d.ts +1 -0
  44. package/dist/esm/ee/AiAgent/index.d.ts.map +1 -1
  45. package/dist/esm/ee/AiAgent/index.js +1 -0
  46. package/dist/esm/ee/AiAgent/index.js.map +1 -1
  47. package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts +144 -2
  48. package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts.map +1 -1
  49. package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js +189 -4
  50. package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js.map +1 -1
  51. package/dist/esm/schemas/chartAsCodeSchema.d.ts +38 -38
  52. package/dist/esm/schemas/json/mcp-tools-1.0.json +220 -2
  53. package/dist/esm/types/mergeQuery.d.ts +20 -0
  54. package/dist/esm/types/mergeQuery.d.ts.map +1 -1
  55. package/dist/esm/types/mergeQuery.js +46 -0
  56. package/dist/esm/types/mergeQuery.js.map +1 -1
  57. package/dist/esm/types/queryHistory.d.ts +2 -0
  58. package/dist/esm/types/queryHistory.d.ts.map +1 -1
  59. package/dist/esm/types/querySources.d.ts +40 -2
  60. package/dist/esm/types/querySources.d.ts.map +1 -1
  61. package/dist/esm/types/querySources.js +42 -0
  62. package/dist/esm/types/querySources.js.map +1 -1
  63. package/dist/esm/utils/i18n/uiStrings.d.ts +15 -0
  64. package/dist/esm/utils/i18n/uiStrings.d.ts.map +1 -1
  65. package/dist/esm/utils/i18n/uiStrings.js +15 -0
  66. package/dist/esm/utils/i18n/uiStrings.js.map +1 -1
  67. package/dist/esm/utils/item.js +1 -1
  68. package/dist/esm/utils/item.js.map +1 -1
  69. package/dist/types/.tsbuildinfo +1 -1
  70. package/dist/types/ee/AiAgent/composerArtifact.d.ts.map +1 -1
  71. package/dist/types/ee/AiAgent/composerArtifact.js +1 -0
  72. package/dist/types/ee/AiAgent/composerArtifact.js.map +1 -1
  73. package/dist/types/ee/AiAgent/composerMergeChart.d.ts +18 -0
  74. package/dist/types/ee/AiAgent/composerMergeChart.d.ts.map +1 -0
  75. package/dist/types/ee/AiAgent/composerMergeChart.js +105 -0
  76. package/dist/types/ee/AiAgent/composerMergeChart.js.map +1 -0
  77. package/dist/types/ee/AiAgent/index.d.ts +1 -0
  78. package/dist/types/ee/AiAgent/index.d.ts.map +1 -1
  79. package/dist/types/ee/AiAgent/index.js +1 -0
  80. package/dist/types/ee/AiAgent/index.js.map +1 -1
  81. package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts +144 -2
  82. package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts.map +1 -1
  83. package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js +189 -4
  84. package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js.map +1 -1
  85. package/dist/types/schemas/chartAsCodeSchema.d.ts +38 -38
  86. package/dist/types/schemas/json/mcp-tools-1.0.json +220 -2
  87. package/dist/types/types/mergeQuery.d.ts +20 -0
  88. package/dist/types/types/mergeQuery.d.ts.map +1 -1
  89. package/dist/types/types/mergeQuery.js +46 -0
  90. package/dist/types/types/mergeQuery.js.map +1 -1
  91. package/dist/types/types/queryHistory.d.ts +2 -0
  92. package/dist/types/types/queryHistory.d.ts.map +1 -1
  93. package/dist/types/types/querySources.d.ts +40 -2
  94. package/dist/types/types/querySources.d.ts.map +1 -1
  95. package/dist/types/types/querySources.js +42 -0
  96. package/dist/types/types/querySources.js.map +1 -1
  97. package/dist/types/utils/i18n/uiStrings.d.ts +15 -0
  98. package/dist/types/utils/i18n/uiStrings.d.ts.map +1 -1
  99. package/dist/types/utils/i18n/uiStrings.js +15 -0
  100. package/dist/types/utils/i18n/uiStrings.js.map +1 -1
  101. package/dist/types/utils/item.js +1 -1
  102. package/dist/types/utils/item.js.map +1 -1
  103. package/package.json +1 -1
@@ -79,9 +79,9 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
79
79
  metricQuery: {
80
80
  allOf: ({
81
81
  type?: undefined;
82
- $ref: string;
83
- properties?: undefined;
84
82
  required?: undefined;
83
+ properties?: undefined;
84
+ $ref: string;
85
85
  } | {
86
86
  $ref?: undefined;
87
87
  properties: {
@@ -219,8 +219,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
219
219
  };
220
220
  format: {
221
221
  anyOf: ({
222
- $ref: string;
223
222
  type?: undefined;
223
+ $ref: string;
224
224
  } | {
225
225
  $ref?: undefined;
226
226
  type: string;
@@ -800,9 +800,9 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
800
800
  metricQuery: {
801
801
  allOf: ({
802
802
  type?: undefined;
803
- $ref: string;
804
- properties?: undefined;
805
803
  required?: undefined;
804
+ properties?: undefined;
805
+ $ref: string;
806
806
  } | {
807
807
  $ref?: undefined;
808
808
  properties: {
@@ -1015,9 +1015,9 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
1015
1015
  };
1016
1016
  CompactOrAlias: {
1017
1017
  anyOf: ({
1018
+ enum?: undefined;
1018
1019
  type?: undefined;
1019
1020
  $ref: string;
1020
- enum?: undefined;
1021
1021
  } | {
1022
1022
  $ref?: undefined;
1023
1023
  enum: string[];
@@ -1180,8 +1180,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
1180
1180
  ConditionalFormattingWithCompareTarget: {
1181
1181
  allOf: ({
1182
1182
  type?: undefined;
1183
- properties?: undefined;
1184
1183
  required?: undefined;
1184
+ properties?: undefined;
1185
1185
  $ref: string;
1186
1186
  } | {
1187
1187
  $ref?: undefined;
@@ -1220,8 +1220,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
1220
1220
  "ConditionalFormattingWithCompareTarget_number-or-string_": {
1221
1221
  allOf: ({
1222
1222
  type?: undefined;
1223
- properties?: undefined;
1224
1223
  required?: undefined;
1224
+ properties?: undefined;
1225
1225
  $ref: string;
1226
1226
  } | {
1227
1227
  $ref?: undefined;
@@ -1260,8 +1260,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
1260
1260
  ConditionalFormattingWithValues: {
1261
1261
  allOf: ({
1262
1262
  type?: undefined;
1263
- properties?: undefined;
1264
1263
  required?: undefined;
1264
+ properties?: undefined;
1265
1265
  $ref: string;
1266
1266
  } | {
1267
1267
  $ref?: undefined;
@@ -1287,8 +1287,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
1287
1287
  "ConditionalFormattingWithValues_number-or-string_": {
1288
1288
  allOf: ({
1289
1289
  type?: undefined;
1290
- properties?: undefined;
1291
1290
  required?: undefined;
1291
+ properties?: undefined;
1292
1292
  $ref: string;
1293
1293
  } | {
1294
1294
  $ref?: undefined;
@@ -2013,8 +2013,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
2013
2013
  FormulaTableCalculation: {
2014
2014
  allOf: ({
2015
2015
  type?: undefined;
2016
- properties?: undefined;
2017
2016
  required?: undefined;
2017
+ properties?: undefined;
2018
2018
  $ref: string;
2019
2019
  } | {
2020
2020
  $ref?: undefined;
@@ -2833,13 +2833,13 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
2833
2833
  };
2834
2834
  ParameterValue: {
2835
2835
  anyOf: ({
2836
+ items?: undefined;
2836
2837
  format?: undefined;
2837
2838
  type: string;
2838
- items?: undefined;
2839
2839
  } | {
2840
+ items?: undefined;
2840
2841
  format: string;
2841
2842
  type: string;
2842
- items?: undefined;
2843
2843
  } | {
2844
2844
  format?: undefined;
2845
2845
  items: {
@@ -3973,8 +3973,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
3973
3973
  SqlTableCalculation: {
3974
3974
  allOf: ({
3975
3975
  type?: undefined;
3976
- properties?: undefined;
3977
3976
  required?: undefined;
3977
+ properties?: undefined;
3978
3978
  $ref: string;
3979
3979
  } | {
3980
3980
  $ref?: undefined;
@@ -4297,8 +4297,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
4297
4297
  TemplateTableCalculation: {
4298
4298
  allOf: ({
4299
4299
  type?: undefined;
4300
- properties?: undefined;
4301
4300
  required?: undefined;
4301
+ properties?: undefined;
4302
4302
  $ref: string;
4303
4303
  } | {
4304
4304
  $ref?: undefined;
@@ -4397,8 +4397,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
4397
4397
  VizBarChartConfig: {
4398
4398
  allOf: ({
4399
4399
  type?: undefined;
4400
- properties?: undefined;
4401
4400
  required?: undefined;
4401
+ properties?: undefined;
4402
4402
  $ref: string;
4403
4403
  } | {
4404
4404
  $ref?: undefined;
@@ -4465,8 +4465,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
4465
4465
  VizBigNumberConfig: {
4466
4466
  allOf: ({
4467
4467
  type?: undefined;
4468
- properties?: undefined;
4469
4468
  required?: undefined;
4469
+ properties?: undefined;
4470
4470
  $ref: string;
4471
4471
  } | {
4472
4472
  $ref?: undefined;
@@ -4582,8 +4582,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
4582
4582
  VizLineChartConfig: {
4583
4583
  allOf: ({
4584
4584
  type?: undefined;
4585
- properties?: undefined;
4586
4585
  required?: undefined;
4586
+ properties?: undefined;
4587
4587
  $ref: string;
4588
4588
  } | {
4589
4589
  $ref?: undefined;
@@ -4605,8 +4605,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
4605
4605
  VizPieChartConfig: {
4606
4606
  allOf: ({
4607
4607
  type?: undefined;
4608
- properties?: undefined;
4609
4608
  required?: undefined;
4609
+ properties?: undefined;
4610
4610
  $ref: string;
4611
4611
  } | {
4612
4612
  $ref?: undefined;
@@ -4658,8 +4658,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
4658
4658
  VizTableConfig: {
4659
4659
  allOf: ({
4660
4660
  type?: undefined;
4661
- properties?: undefined;
4662
4661
  required?: undefined;
4662
+ properties?: undefined;
4663
4663
  $ref: string;
4664
4664
  } | {
4665
4665
  $ref?: undefined;
@@ -4820,8 +4820,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
4820
4820
  };
4821
4821
  format: {
4822
4822
  anyOf: ({
4823
- $ref: string;
4824
4823
  type?: undefined;
4824
+ $ref: string;
4825
4825
  } | {
4826
4826
  $ref?: undefined;
4827
4827
  type: string;
@@ -5401,9 +5401,9 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
5401
5401
  metricQuery: {
5402
5402
  allOf: ({
5403
5403
  type?: undefined;
5404
- $ref: string;
5405
- properties?: undefined;
5406
5404
  required?: undefined;
5405
+ properties?: undefined;
5406
+ $ref: string;
5407
5407
  } | {
5408
5408
  $ref?: undefined;
5409
5409
  properties: {
@@ -5616,9 +5616,9 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
5616
5616
  };
5617
5617
  CompactOrAlias: {
5618
5618
  anyOf: ({
5619
+ enum?: undefined;
5619
5620
  type?: undefined;
5620
5621
  $ref: string;
5621
- enum?: undefined;
5622
5622
  } | {
5623
5623
  $ref?: undefined;
5624
5624
  enum: string[];
@@ -5781,8 +5781,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
5781
5781
  ConditionalFormattingWithCompareTarget: {
5782
5782
  allOf: ({
5783
5783
  type?: undefined;
5784
- properties?: undefined;
5785
5784
  required?: undefined;
5785
+ properties?: undefined;
5786
5786
  $ref: string;
5787
5787
  } | {
5788
5788
  $ref?: undefined;
@@ -5821,8 +5821,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
5821
5821
  "ConditionalFormattingWithCompareTarget_number-or-string_": {
5822
5822
  allOf: ({
5823
5823
  type?: undefined;
5824
- properties?: undefined;
5825
5824
  required?: undefined;
5825
+ properties?: undefined;
5826
5826
  $ref: string;
5827
5827
  } | {
5828
5828
  $ref?: undefined;
@@ -5861,8 +5861,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
5861
5861
  ConditionalFormattingWithValues: {
5862
5862
  allOf: ({
5863
5863
  type?: undefined;
5864
- properties?: undefined;
5865
5864
  required?: undefined;
5865
+ properties?: undefined;
5866
5866
  $ref: string;
5867
5867
  } | {
5868
5868
  $ref?: undefined;
@@ -5888,8 +5888,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
5888
5888
  "ConditionalFormattingWithValues_number-or-string_": {
5889
5889
  allOf: ({
5890
5890
  type?: undefined;
5891
- properties?: undefined;
5892
5891
  required?: undefined;
5892
+ properties?: undefined;
5893
5893
  $ref: string;
5894
5894
  } | {
5895
5895
  $ref?: undefined;
@@ -6614,8 +6614,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
6614
6614
  FormulaTableCalculation: {
6615
6615
  allOf: ({
6616
6616
  type?: undefined;
6617
- properties?: undefined;
6618
6617
  required?: undefined;
6618
+ properties?: undefined;
6619
6619
  $ref: string;
6620
6620
  } | {
6621
6621
  $ref?: undefined;
@@ -7434,13 +7434,13 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
7434
7434
  };
7435
7435
  ParameterValue: {
7436
7436
  anyOf: ({
7437
+ items?: undefined;
7437
7438
  format?: undefined;
7438
7439
  type: string;
7439
- items?: undefined;
7440
7440
  } | {
7441
+ items?: undefined;
7441
7442
  format: string;
7442
7443
  type: string;
7443
- items?: undefined;
7444
7444
  } | {
7445
7445
  format?: undefined;
7446
7446
  items: {
@@ -8574,8 +8574,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
8574
8574
  SqlTableCalculation: {
8575
8575
  allOf: ({
8576
8576
  type?: undefined;
8577
- properties?: undefined;
8578
8577
  required?: undefined;
8578
+ properties?: undefined;
8579
8579
  $ref: string;
8580
8580
  } | {
8581
8581
  $ref?: undefined;
@@ -8898,8 +8898,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
8898
8898
  TemplateTableCalculation: {
8899
8899
  allOf: ({
8900
8900
  type?: undefined;
8901
- properties?: undefined;
8902
8901
  required?: undefined;
8902
+ properties?: undefined;
8903
8903
  $ref: string;
8904
8904
  } | {
8905
8905
  $ref?: undefined;
@@ -8998,8 +8998,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
8998
8998
  VizBarChartConfig: {
8999
8999
  allOf: ({
9000
9000
  type?: undefined;
9001
- properties?: undefined;
9002
9001
  required?: undefined;
9002
+ properties?: undefined;
9003
9003
  $ref: string;
9004
9004
  } | {
9005
9005
  $ref?: undefined;
@@ -9066,8 +9066,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
9066
9066
  VizBigNumberConfig: {
9067
9067
  allOf: ({
9068
9068
  type?: undefined;
9069
- properties?: undefined;
9070
9069
  required?: undefined;
9070
+ properties?: undefined;
9071
9071
  $ref: string;
9072
9072
  } | {
9073
9073
  $ref?: undefined;
@@ -9183,8 +9183,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
9183
9183
  VizLineChartConfig: {
9184
9184
  allOf: ({
9185
9185
  type?: undefined;
9186
- properties?: undefined;
9187
9186
  required?: undefined;
9187
+ properties?: undefined;
9188
9188
  $ref: string;
9189
9189
  } | {
9190
9190
  $ref?: undefined;
@@ -9206,8 +9206,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
9206
9206
  VizPieChartConfig: {
9207
9207
  allOf: ({
9208
9208
  type?: undefined;
9209
- properties?: undefined;
9210
9209
  required?: undefined;
9210
+ properties?: undefined;
9211
9211
  $ref: string;
9212
9212
  } | {
9213
9213
  $ref?: undefined;
@@ -9259,8 +9259,8 @@ export declare const getChartAsCodeBranchSchema: (contentType: ChartAsCodeConten
9259
9259
  VizTableConfig: {
9260
9260
  allOf: ({
9261
9261
  type?: undefined;
9262
- properties?: undefined;
9263
9262
  required?: undefined;
9263
+ properties?: undefined;
9264
9264
  $ref: string;
9265
9265
  } | {
9266
9266
  $ref?: undefined;
@@ -3194,7 +3194,7 @@
3194
3194
  "type": ["string", "null"]
3195
3195
  },
3196
3196
  "queries": {
3197
- "description": "The nodes to submit, in any order: reads are resolved from duckdb references.",
3197
+ "description": "The nodes to submit, in any order: reads are resolved from duckdb references and merge sources.",
3198
3198
  "items": {
3199
3199
  "anyOf": [
3200
3200
  {
@@ -3646,6 +3646,223 @@
3646
3646
  "tables"
3647
3647
  ],
3648
3648
  "type": "object"
3649
+ },
3650
+ {
3651
+ "properties": {
3652
+ "description": {
3653
+ "description": "One sentence for a business user on what this node does to the data, adding to the title rather than repeating it, e.g. \"Sums completed order revenue per month over the last year.\" Shown as the node's heading in the pipeline list.",
3654
+ "type": "string"
3655
+ },
3656
+ "joinKey": {
3657
+ "description": "The dimensions the sources share, one entry per key.",
3658
+ "items": {
3659
+ "properties": {
3660
+ "fields": {
3661
+ "description": "One dimension per source, the same value at the same grain (both a month, both a customer id).",
3662
+ "items": {
3663
+ "properties": {
3664
+ "fieldId": {
3665
+ "description": "A dimension that node selects.",
3666
+ "type": "string"
3667
+ },
3668
+ "nodeId": {
3669
+ "pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
3670
+ "type": "string"
3671
+ }
3672
+ },
3673
+ "required": [
3674
+ "nodeId",
3675
+ "fieldId"
3676
+ ],
3677
+ "type": "object"
3678
+ },
3679
+ "minItems": 2,
3680
+ "type": "array"
3681
+ },
3682
+ "name": {
3683
+ "description": "snake_case name of the shared key column, which the result calls merge_<name>.",
3684
+ "pattern": "^[a-z][a-z0-9_]*$",
3685
+ "type": "string"
3686
+ }
3687
+ },
3688
+ "required": ["name", "fields"],
3689
+ "type": "object"
3690
+ },
3691
+ "minItems": 1,
3692
+ "type": "array"
3693
+ },
3694
+ "joinType": {
3695
+ "description": "\"full\" keeps keys found in any source, \"left\" keeps the first source's keys, \"inner\" keeps keys found in every source.",
3696
+ "enum": ["full", "left", "inner"],
3697
+ "type": "string"
3698
+ },
3699
+ "limit": {
3700
+ "default": 500,
3701
+ "description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
3702
+ "exclusiveMinimum": 0,
3703
+ "maximum": 5000,
3704
+ "type": "integer"
3705
+ },
3706
+ "nodeId": {
3707
+ "description": "Names this node so other nodes can read its result.",
3708
+ "pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
3709
+ "type": "string"
3710
+ },
3711
+ "sorts": {
3712
+ "anyOf": [
3713
+ {
3714
+ "items": {
3715
+ "properties": {
3716
+ "descending": {
3717
+ "description": "If true sorts in descending order, ascending otherwise.",
3718
+ "type": "boolean"
3719
+ },
3720
+ "fieldId": {
3721
+ "description": "Field id to sort by.",
3722
+ "type": "string"
3723
+ }
3724
+ },
3725
+ "required": [
3726
+ "fieldId",
3727
+ "descending"
3728
+ ],
3729
+ "type": "object"
3730
+ },
3731
+ "type": "array"
3732
+ },
3733
+ {
3734
+ "type": "null"
3735
+ }
3736
+ ],
3737
+ "default": null,
3738
+ "description": "Sorts by merged column id (`merge_<name>`, `<source nodeId>_<fieldId>`). null sorts by every join key, in order."
3739
+ },
3740
+ "sources": {
3741
+ "description": "The semanticLayer nodes to merge, in order; a left join keeps the first one's rows. Each node selects its join-key dimensions plus metrics; one source may keep another dimension when every other source sets repeatValues. Each returns fewer rows than its limit: a node cut off at its limit is refused.",
3742
+ "items": {
3743
+ "properties": {
3744
+ "nodeId": {
3745
+ "description": "A semanticLayer node of this call or of the thread.",
3746
+ "pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
3747
+ "type": "string"
3748
+ },
3749
+ "repeatValues": {
3750
+ "default": null,
3751
+ "description": "true repeats this node's values on every row of the one source that keeps a dimension outside the join key, e.g. a monthly target beside daily sales. Every source but that one sets it. null otherwise.",
3752
+ "type": [
3753
+ "boolean",
3754
+ "null"
3755
+ ]
3756
+ }
3757
+ },
3758
+ "required": ["nodeId"],
3759
+ "type": "object"
3760
+ },
3761
+ "minItems": 2,
3762
+ "type": "array"
3763
+ },
3764
+ "sourceType": {
3765
+ "const": "merge",
3766
+ "type": "string"
3767
+ },
3768
+ "tableCalculations": {
3769
+ "anyOf": [
3770
+ {
3771
+ "items": {
3772
+ "properties": {
3773
+ "displayName": {
3774
+ "description": "Column label.",
3775
+ "type": "string"
3776
+ },
3777
+ "format": {
3778
+ "anyOf": [
3779
+ {
3780
+ "properties": {
3781
+ "currency": {
3782
+ "default": null,
3783
+ "description": "ISO code for \"currency\", the governed metric's currency (e.g. \"USD\"). null otherwise.",
3784
+ "type": [
3785
+ "string",
3786
+ "null"
3787
+ ]
3788
+ },
3789
+ "decimals": {
3790
+ "anyOf": [
3791
+ {
3792
+ "maximum": 6,
3793
+ "minimum": 0,
3794
+ "type": "integer"
3795
+ },
3796
+ {
3797
+ "type": "null"
3798
+ }
3799
+ ],
3800
+ "default": null,
3801
+ "description": "Decimal places. null keeps the default."
3802
+ },
3803
+ "type": {
3804
+ "description": "\"percent\" shows 0.12 as 12%.",
3805
+ "enum": [
3806
+ "number",
3807
+ "percent",
3808
+ "currency"
3809
+ ],
3810
+ "type": "string"
3811
+ }
3812
+ },
3813
+ "required": [
3814
+ "type"
3815
+ ],
3816
+ "type": "object"
3817
+ },
3818
+ {
3819
+ "type": "null"
3820
+ }
3821
+ ],
3822
+ "default": null,
3823
+ "description": "How the column displays, matching the metrics it is built from: money stays money, so a revenue change or revenue per customer is currency in the revenue metric's currency; a share or growth rate is percent. null shows a plain number."
3824
+ },
3825
+ "formula": {
3826
+ "description": "Spreadsheet formula over merged columns by id: `<source nodeId>_<fieldId>` for a source's column, `merge_<name>` for a join key. Sources `weekly_orders` and `weekly_sessions` give `weekly_orders_orders_total_revenue / weekly_sessions_sessions_count`. It supports: arithmetic across sources (dividing by zero gives blank); a blank-safe sum, `COALESCE(a, 0) + COALESCE(b, 0)`; SUM, AVG, MIN, MAX and COUNT over all rows, so `a / SUM(a)` is a share of total, and `SUM(a) OVER (PARTITION BY merge_<name>)` a group's total; LAG, LEAD, RUNNING_TOTAL, MOVING_AVG and RANK, each naming its order, as in `a / LAG(a, PARTITION BY merge_category, ORDER BY merge_year) - 1` for year on year; conditions with IF, ISNULL, comparisons and AND/OR between them, as in `IF(YEAR(merge_year) = 2025, \"Full year\", \"Partial year\")` for a label; YEAR, MONTH and DATE_TRUNC on a date key; ROUND and ABS.",
3827
+ "type": "string"
3828
+ },
3829
+ "name": {
3830
+ "description": "snake_case name; the result calls it merge_<name>.",
3831
+ "pattern": "^[a-z][a-z0-9_]*$",
3832
+ "type": "string"
3833
+ }
3834
+ },
3835
+ "required": [
3836
+ "name",
3837
+ "displayName",
3838
+ "formula"
3839
+ ],
3840
+ "type": "object"
3841
+ },
3842
+ "type": "array"
3843
+ },
3844
+ {
3845
+ "type": "null"
3846
+ }
3847
+ ],
3848
+ "default": null,
3849
+ "description": "Every calculation over the merged columns: ratios, year on year, shares of total, conditional labels. null for none."
3850
+ },
3851
+ "title": {
3852
+ "description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
3853
+ "type": "string"
3854
+ }
3855
+ },
3856
+ "required": [
3857
+ "sourceType",
3858
+ "nodeId",
3859
+ "title",
3860
+ "description",
3861
+ "sources",
3862
+ "joinKey",
3863
+ "joinType"
3864
+ ],
3865
+ "type": "object"
3649
3866
  }
3650
3867
  ]
3651
3868
  },
@@ -3768,7 +3985,8 @@
3768
3985
  "duckdb",
3769
3986
  "external",
3770
3987
  "python",
3771
- "api"
3988
+ "api",
3989
+ "merge"
3772
3990
  ],
3773
3991
  "type": "string"
3774
3992
  },
@@ -291,6 +291,18 @@ export declare const toMergedSorts: ({ sorts, primarySourceId, primaryMetricQuer
291
291
  primaryMetricQuery: Pick<MetricQuery, 'dimensions' | 'metrics' | 'tableCalculations'>;
292
292
  joinKey: MergeJoinKeyPart[];
293
293
  }) => SortField[];
294
+ /**
295
+ * The inverse of toMergedSorts: a merged field id as the chart's own query
296
+ * names it, so a chart saved from a merge stores what the Explorer stores.
297
+ */
298
+ export declare const toPrimaryFieldId: ({ fieldId, primarySourceId, primaryMetricQuery, joinKey, }: {
299
+ fieldId: string;
300
+ primarySourceId: string;
301
+ primaryMetricQuery: Pick<MetricQuery, 'dimensions' | 'metrics' | 'tableCalculations'>;
302
+ joinKey: MergeJoinKeyPart[];
303
+ }) => string;
304
+ /** The dimension ids a merged result carries: one per join key, plus each source's unkeyed dimensions. */
305
+ export declare const getMergedDimensionIds: (mergeQuery: MetricSourcedMergeQuery) => string[];
294
306
  export declare const validateMergeQuery: (mergeQuery: MergeQuery,
295
307
  /**
296
308
  * Types of every field named in the join key. Omitting it skips the type
@@ -433,6 +445,14 @@ export declare const getMergeSourceTableLabel: (sourceIndex: number) => string;
433
445
  * as compiled when the warehouse is unknown, since the generic dialect can
434
446
  * break warehouse syntax such as `->>`. Null when the merge did not compile.
435
447
  */
448
+ /** A source's header label: its explore's, told apart by slot when explores collide, or for a composer by node title. */
449
+ export declare const getMergeSourceTableLabels: ({ sources, sourceTitleById, }: {
450
+ sources: Array<{
451
+ id: string;
452
+ exploreLabel: string;
453
+ }>;
454
+ sourceTitleById: Record<string, string> | null;
455
+ }) => Record<string, string>;
436
456
  export declare const getMergeCompiledSqlText: (compiled: Pick<ApiCompiledMergeQueryResults, 'legs' | 'sql'>, warehouseType: WarehouseTypes | undefined) => string | null;
437
457
  /**
438
458
  * Where a merged field came from. Carried beside the fields rather than on