@lightdash/common 2.507.1 → 2.509.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 (109) hide show
  1. package/dist/cjs/.tsbuildinfo +1 -1
  2. package/dist/cjs/ee/AiAgent/schemas/tools/mcpDocumentContent.d.ts +85 -0
  3. package/dist/cjs/ee/AiAgent/schemas/tools/mcpDocumentContent.d.ts.map +1 -1
  4. package/dist/cjs/ee/AiAgent/schemas/tools/mcpDocumentContent.js +29 -0
  5. package/dist/cjs/ee/AiAgent/schemas/tools/mcpDocumentContent.js.map +1 -1
  6. package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +68 -0
  7. package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
  8. package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js +1 -1
  9. package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
  10. package/dist/cjs/index.d.ts +1 -0
  11. package/dist/cjs/index.d.ts.map +1 -1
  12. package/dist/cjs/index.js +1 -0
  13. package/dist/cjs/index.js.map +1 -1
  14. package/dist/cjs/types/agentAccessReport.d.ts +54 -0
  15. package/dist/cjs/types/agentAccessReport.d.ts.map +1 -0
  16. package/dist/cjs/types/agentAccessReport.js +3 -0
  17. package/dist/cjs/types/agentAccessReport.js.map +1 -0
  18. package/dist/cjs/types/api.d.ts +2 -1
  19. package/dist/cjs/types/api.d.ts.map +1 -1
  20. package/dist/cjs/types/api.js.map +1 -1
  21. package/dist/cjs/types/document.d.ts +25 -4
  22. package/dist/cjs/types/document.d.ts.map +1 -1
  23. package/dist/cjs/types/document.js +3 -0
  24. package/dist/cjs/types/document.js.map +1 -1
  25. package/dist/cjs/types/featureFlags.d.ts +1 -0
  26. package/dist/cjs/types/featureFlags.d.ts.map +1 -1
  27. package/dist/cjs/types/featureFlags.js +1 -0
  28. package/dist/cjs/types/featureFlags.js.map +1 -1
  29. package/dist/cjs/utils/document.d.ts +29 -5
  30. package/dist/cjs/utils/document.d.ts.map +1 -1
  31. package/dist/cjs/utils/document.js +260 -48
  32. package/dist/cjs/utils/document.js.map +1 -1
  33. package/dist/cjs/utils/documentMarkdown.d.ts +27 -4
  34. package/dist/cjs/utils/documentMarkdown.d.ts.map +1 -1
  35. package/dist/cjs/utils/documentMarkdown.js +92 -32
  36. package/dist/cjs/utils/documentMarkdown.js.map +1 -1
  37. package/dist/esm/.tsbuildinfo +1 -1
  38. package/dist/esm/ee/AiAgent/schemas/tools/mcpDocumentContent.d.ts +85 -0
  39. package/dist/esm/ee/AiAgent/schemas/tools/mcpDocumentContent.d.ts.map +1 -1
  40. package/dist/esm/ee/AiAgent/schemas/tools/mcpDocumentContent.js +29 -0
  41. package/dist/esm/ee/AiAgent/schemas/tools/mcpDocumentContent.js.map +1 -1
  42. package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +68 -0
  43. package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
  44. package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js +1 -1
  45. package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
  46. package/dist/esm/index.d.ts +1 -0
  47. package/dist/esm/index.d.ts.map +1 -1
  48. package/dist/esm/index.js +1 -0
  49. package/dist/esm/index.js.map +1 -1
  50. package/dist/esm/types/agentAccessReport.d.ts +54 -0
  51. package/dist/esm/types/agentAccessReport.d.ts.map +1 -0
  52. package/dist/esm/types/agentAccessReport.js +2 -0
  53. package/dist/esm/types/agentAccessReport.js.map +1 -0
  54. package/dist/esm/types/api.d.ts +2 -1
  55. package/dist/esm/types/api.d.ts.map +1 -1
  56. package/dist/esm/types/api.js.map +1 -1
  57. package/dist/esm/types/document.d.ts +25 -4
  58. package/dist/esm/types/document.d.ts.map +1 -1
  59. package/dist/esm/types/document.js +1 -1
  60. package/dist/esm/types/document.js.map +1 -1
  61. package/dist/esm/types/featureFlags.d.ts +1 -0
  62. package/dist/esm/types/featureFlags.d.ts.map +1 -1
  63. package/dist/esm/types/featureFlags.js +1 -0
  64. package/dist/esm/types/featureFlags.js.map +1 -1
  65. package/dist/esm/utils/document.d.ts +29 -5
  66. package/dist/esm/utils/document.d.ts.map +1 -1
  67. package/dist/esm/utils/document.js +258 -48
  68. package/dist/esm/utils/document.js.map +1 -1
  69. package/dist/esm/utils/documentMarkdown.d.ts +27 -4
  70. package/dist/esm/utils/documentMarkdown.d.ts.map +1 -1
  71. package/dist/esm/utils/documentMarkdown.js +89 -31
  72. package/dist/esm/utils/documentMarkdown.js.map +1 -1
  73. package/dist/types/.tsbuildinfo +1 -1
  74. package/dist/types/ee/AiAgent/schemas/tools/mcpDocumentContent.d.ts +85 -0
  75. package/dist/types/ee/AiAgent/schemas/tools/mcpDocumentContent.d.ts.map +1 -1
  76. package/dist/types/ee/AiAgent/schemas/tools/mcpDocumentContent.js +29 -0
  77. package/dist/types/ee/AiAgent/schemas/tools/mcpDocumentContent.js.map +1 -1
  78. package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +68 -0
  79. package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
  80. package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js +1 -1
  81. package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
  82. package/dist/types/index.d.ts +1 -0
  83. package/dist/types/index.d.ts.map +1 -1
  84. package/dist/types/index.js +1 -0
  85. package/dist/types/index.js.map +1 -1
  86. package/dist/types/types/agentAccessReport.d.ts +54 -0
  87. package/dist/types/types/agentAccessReport.d.ts.map +1 -0
  88. package/dist/types/types/agentAccessReport.js +2 -0
  89. package/dist/types/types/agentAccessReport.js.map +1 -0
  90. package/dist/types/types/api.d.ts +2 -1
  91. package/dist/types/types/api.d.ts.map +1 -1
  92. package/dist/types/types/api.js.map +1 -1
  93. package/dist/types/types/document.d.ts +25 -4
  94. package/dist/types/types/document.d.ts.map +1 -1
  95. package/dist/types/types/document.js +1 -1
  96. package/dist/types/types/document.js.map +1 -1
  97. package/dist/types/types/featureFlags.d.ts +1 -0
  98. package/dist/types/types/featureFlags.d.ts.map +1 -1
  99. package/dist/types/types/featureFlags.js +1 -0
  100. package/dist/types/types/featureFlags.js.map +1 -1
  101. package/dist/types/utils/document.d.ts +29 -5
  102. package/dist/types/utils/document.d.ts.map +1 -1
  103. package/dist/types/utils/document.js +258 -48
  104. package/dist/types/utils/document.js.map +1 -1
  105. package/dist/types/utils/documentMarkdown.d.ts +27 -4
  106. package/dist/types/utils/documentMarkdown.d.ts.map +1 -1
  107. package/dist/types/utils/documentMarkdown.js +89 -31
  108. package/dist/types/utils/documentMarkdown.js.map +1 -1
  109. package/package.json +1 -1
@@ -5,12 +5,36 @@ import { type ChartConfig } from '../types/savedCharts';
5
5
  export declare const DOCUMENT_SCHEMA_VERSION = 2;
6
6
  export declare const getDocumentUrl: (projectUuidOrSlug: UuidOrSlug, documentUuidOrSlug: UuidOrSlug, documentSlug?: string) => string;
7
7
  /**
8
- * Validate Document content and return its canonical form: chart tags carry
9
- * only their id and charts that are not placed in the markdown are dropped.
8
+ * Validate Document content for a write and return its canonical form: chart
9
+ * tags carry only their id and charts not placed in the markdown are dropped.
10
+ *
11
+ * Content this release can't read (charts and block tags from a newer
12
+ * release) is accepted only unchanged from `previous`, the version being
13
+ * replaced. A client may leave such charts out; they are carried over.
10
14
  */
11
- export declare const parseDocumentContent: (schemaVersion: number, raw: unknown) => DocumentContent;
12
- /** A Document as code, as downloaded; an omitted description is empty. */
13
- export declare const parseDocumentAsCode: (raw: unknown) => DocumentAsCode;
15
+ export declare const parseDocumentContent: (schemaVersion: number, raw: unknown, { previous }?: {
16
+ previous?: DocumentContent;
17
+ }) => DocumentContent;
18
+ /**
19
+ * Read stored Document content, keeping what this release can't read (charts
20
+ * and block tags from a newer release) as unsupported content instead of
21
+ * failing the whole Document.
22
+ */
23
+ export declare const parseStoredDocumentContent: (raw: unknown) => DocumentContent;
24
+ /**
25
+ * A Document as code, validated strictly for a write; an omitted description
26
+ * is empty. Content this release can't read must be unchanged from
27
+ * `previous`, as in `parseDocumentContent`.
28
+ */
29
+ export declare const parseDocumentAsCode: (raw: unknown, { previous }?: {
30
+ previous?: DocumentContent;
31
+ }) => DocumentAsCode;
32
+ /**
33
+ * A Document file checked only for its outer shape, for clients such as the
34
+ * CLI. Charts and fields this client doesn't know pass through for the server
35
+ * to validate, so files from a newer release still upload.
36
+ */
37
+ export declare const parseDocumentAsCodeFile: (raw: unknown) => DocumentAsCode;
14
38
  /**
15
39
  * The runtime chart config of a stored Document chart. Stored custom charts
16
40
  * are always pinned to this project's chart type uuid; the portable slug that
@@ -1 +1 @@
1
- {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/utils/document.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EACR,cAAc,EAEd,eAAe,EAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMnE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,cAAc,sBACJ,UAAU,sBACT,UAAU,iBACf,MAAM,KACtB,MAKI,CAAC;AAuGR;;;GAGG;AACH,eAAO,MAAM,oBAAoB,kBACd,MAAM,OAChB,OAAO,KACb,eAiBF,CAAC;AAkBF,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,QAAS,OAAO,KAAG,cAyClD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,gBACzB,iBAAiB,KAC/B,WAcF,CAAC"}
1
+ {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/utils/document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EACR,cAAc,EAEd,eAAe,EAGlB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAM9E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAKzC,eAAO,MAAM,cAAc,sBACJ,UAAU,sBACT,UAAU,iBACf,MAAM,KACtB,MAKI,CAAC;AA6RR;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,kBACd,MAAM,OAChB,OAAO,iBACE;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,KAC7C,eAqDF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAS,OAAO,KAAG,eA+BzD,CAAC;AAiDF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QACvB,OAAO,iBACE;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,KAC7C,cA+BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAS,OAAO,KAAG,cA+BtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,gBACzB,iBAAiB,KAC/B,WAcF,CAAC"}
@@ -1,8 +1,9 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getDocumentRuntimeChartConfig = exports.parseDocumentAsCode = exports.parseDocumentContent = exports.getDocumentUrl = exports.DOCUMENT_SCHEMA_VERSION = void 0;
3
+ exports.getDocumentRuntimeChartConfig = exports.parseDocumentAsCodeFile = exports.parseDocumentAsCode = exports.parseStoredDocumentContent = exports.parseDocumentContent = exports.getDocumentUrl = exports.DOCUMENT_SCHEMA_VERSION = void 0;
4
4
  const tslib_1 = require("tslib");
5
5
  const ajv_1 = tslib_1.__importDefault(require("ajv"));
6
+ const lodash_1 = require("lodash");
6
7
  const uuid_1 = require("uuid");
7
8
  const chart_as_code_1_0_json_1 = tslib_1.__importDefault(require("../schemas/json/chart-as-code-1.0.json"));
8
9
  const errors_1 = require("../types/errors");
@@ -10,6 +11,7 @@ const mergeQuery_1 = require("../types/mergeQuery");
10
11
  const savedCharts_1 = require("../types/savedCharts");
11
12
  const documentMarkdown_1 = require("./documentMarkdown");
12
13
  exports.DOCUMENT_SCHEMA_VERSION = 2;
14
+ const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
13
15
  const getDocumentUrl = (projectUuidOrSlug, documentUuidOrSlug, documentSlug) => `/projects/${encodeURIComponent(projectUuidOrSlug)}/documents/${encodeURIComponent(documentSlug && !(0, uuid_1.validate)(documentSlug)
14
16
  ? documentSlug
15
17
  : documentUuidOrSlug)}`;
@@ -40,33 +42,33 @@ const chartSchema = (merge) => ({
40
42
  ...(merge ? ['merge'] : []),
41
43
  ],
42
44
  });
43
- let contentValidator;
45
+ /**
46
+ * The newest version of each chart source this release reads. An entry from a
47
+ * newer version, or with an unknown source, is kept as an unsupported chart.
48
+ */
49
+ const DOCUMENT_CHART_SOURCE_VERSIONS = {
50
+ semantic: 1,
51
+ merge: 1,
52
+ sql: 1,
53
+ };
54
+ const isKnownChartSource = (source) => typeof source === 'string' &&
55
+ Object.hasOwn(DOCUMENT_CHART_SOURCE_VERSIONS, source);
56
+ let chartValidator;
44
57
  // Lazy compilation keeps importing common safe under browser CSP.
45
- const createValidator = () => new ajv_1.default({
58
+ const createChartValidator = () => new ajv_1.default({
46
59
  strict: false,
47
60
  validateFormats: false,
48
61
  }).compile({
49
62
  $defs: chart_as_code_1_0_json_1.default.$defs,
50
- type: 'object',
51
- additionalProperties: false,
52
- required: ['markdown', 'charts'],
53
- properties: {
54
- markdown: { type: 'string' },
55
- charts: {
56
- type: 'object',
57
- additionalProperties: {
58
- oneOf: [false, true].map((merge) => ({
59
- type: 'object',
60
- additionalProperties: false,
61
- required: ['source', 'chart'],
62
- properties: {
63
- source: { const: merge ? 'merge' : 'semantic' },
64
- chart: chartSchema(merge),
65
- },
66
- })),
67
- },
63
+ oneOf: [false, true].map((merge) => ({
64
+ type: 'object',
65
+ additionalProperties: false,
66
+ required: ['source', 'chart'],
67
+ properties: {
68
+ source: { const: merge ? 'merge' : 'semantic' },
69
+ chart: chartSchema(merge),
68
70
  },
69
- },
71
+ })),
70
72
  });
71
73
  const validateChart = (id, content) => {
72
74
  const { chart } = content;
@@ -94,26 +96,194 @@ const validateChart = (id, content) => {
94
96
  }
95
97
  }
96
98
  };
99
+ const invalidContent = (message) => new errors_1.ParameterError(`Invalid Document content: ${message}`);
100
+ const SQL_CHART_KINDS = [
101
+ savedCharts_1.ChartKind.VERTICAL_BAR,
102
+ savedCharts_1.ChartKind.LINE,
103
+ savedCharts_1.ChartKind.PIE,
104
+ savedCharts_1.ChartKind.BIG_NUMBER,
105
+ savedCharts_1.ChartKind.TABLE,
106
+ ];
107
+ const SQL_CHART_KEYS = [
108
+ 'name',
109
+ 'description',
110
+ 'sql',
111
+ 'limit',
112
+ 'chartKind',
113
+ 'config',
114
+ 'connection',
115
+ 'warehouseConnectionUuid',
116
+ ];
117
+ /**
118
+ * A SQL chart checked for its shape; the API boundary validates its
119
+ * visualization config in full.
120
+ */
121
+ const readSqlChartEntry = (id, entry) => {
122
+ const fail = (message) => invalidContent(`/charts/${id}${message}`);
123
+ const { source, chart, ...rest } = entry;
124
+ if (Object.keys(rest).length > 0 || !isRecord(chart)) {
125
+ throw fail(' must have only source and chart');
126
+ }
127
+ const unknownKeys = Object.keys(chart).filter((key) => !SQL_CHART_KEYS.includes(key));
128
+ if (unknownKeys.length > 0) {
129
+ throw fail(`/chart has unknown fields ${unknownKeys.join(', ')}`);
130
+ }
131
+ const { name, description, sql, limit, chartKind, config, connection, warehouseConnectionUuid, } = chart;
132
+ if (typeof name !== 'string' || name.trim() === '') {
133
+ throw fail('/chart/name must be a non-empty string');
134
+ }
135
+ if (description !== undefined && typeof description !== 'string') {
136
+ throw fail('/chart/description must be string');
137
+ }
138
+ if (typeof sql !== 'string' || sql.trim() === '') {
139
+ throw fail('/chart/sql must be a non-empty string');
140
+ }
141
+ if (typeof limit !== 'number' || !Number.isInteger(limit) || limit < 1) {
142
+ throw fail('/chart/limit must be a positive integer');
143
+ }
144
+ if (typeof chartKind !== 'string' || !SQL_CHART_KINDS.includes(chartKind)) {
145
+ throw fail(`/chart/chartKind must be one of ${SQL_CHART_KINDS.join(', ')}`);
146
+ }
147
+ if (!isRecord(config) || config.type !== chartKind) {
148
+ throw fail('/chart/config must be an object whose type is chartKind');
149
+ }
150
+ if ((connection !== undefined && typeof connection !== 'string') ||
151
+ (warehouseConnectionUuid !== undefined &&
152
+ typeof warehouseConnectionUuid !== 'string')) {
153
+ throw fail('/chart/connection must be string');
154
+ }
155
+ return {
156
+ source: 'sql',
157
+ chart: chart,
158
+ };
159
+ };
97
160
  /**
98
- * Validate Document content and return its canonical form: chart tags carry
99
- * only their id and charts that are not placed in the markdown are dropped.
161
+ * A chart entry this release reads, validated and without its `version`, or
162
+ * undefined when it comes from a newer release. Throws when a readable entry
163
+ * is invalid.
100
164
  */
101
- const parseDocumentContent = (schemaVersion, raw) => {
165
+ const readChartEntry = (id, entry) => {
166
+ if (!isRecord(entry)) {
167
+ throw invalidContent(`/charts/${id} must be object`);
168
+ }
169
+ const { version = 1, ...chart } = entry;
170
+ if (!isKnownChartSource(chart.source)) {
171
+ return undefined;
172
+ }
173
+ if (typeof version !== 'number' || !Number.isInteger(version)) {
174
+ throw invalidContent(`/charts/${id}/version must be integer`);
175
+ }
176
+ if (version > DOCUMENT_CHART_SOURCE_VERSIONS[chart.source]) {
177
+ return undefined;
178
+ }
179
+ if (chart.source === 'sql') {
180
+ return readSqlChartEntry(id, chart);
181
+ }
182
+ chartValidator ?? (chartValidator = createChartValidator());
183
+ if (!chartValidator(chart)) {
184
+ throw invalidContent((chartValidator.errors ?? [])
185
+ .map((error) => `/charts/${id}${error.instancePath} ${error.message}`)
186
+ .join('; '));
187
+ }
188
+ validateChart(id, chart);
189
+ return chart;
190
+ };
191
+ const describeChartEntry = (entry) => {
192
+ if (!isRecord(entry) || typeof entry.source !== 'string') {
193
+ return 'an unknown kind';
194
+ }
195
+ return typeof entry.version === 'number'
196
+ ? `"${entry.source}" version ${entry.version}`
197
+ : `"${entry.source}"`;
198
+ };
199
+ const CONTENT_KEYS = ['markdown', 'charts', 'unsupportedCharts'];
200
+ const parseContentEnvelope = (raw) => {
201
+ if (!isRecord(raw)) {
202
+ throw invalidContent('must be object');
203
+ }
204
+ const unknownKeys = Object.keys(raw).filter((key) => !CONTENT_KEYS.includes(key));
205
+ if (unknownKeys.length > 0) {
206
+ throw invalidContent(`unknown fields ${unknownKeys.join(', ')}`);
207
+ }
208
+ const { markdown, charts, unsupportedCharts = {} } = raw;
209
+ if (typeof markdown !== 'string') {
210
+ throw invalidContent('/markdown must be string');
211
+ }
212
+ if (!isRecord(charts)) {
213
+ throw invalidContent('/charts must be object');
214
+ }
215
+ if (!isRecord(unsupportedCharts)) {
216
+ throw invalidContent('/unsupportedCharts must be object');
217
+ }
218
+ return { markdown, entries: { ...unsupportedCharts, ...charts } };
219
+ };
220
+ const getUnsupportedTagLines = (content) => new Set((0, documentMarkdown_1.getDocumentChartBlocks)(content).flatMap((block) => block.type === 'unsupportedTag' ? [block.line] : []));
221
+ /**
222
+ * Validate Document content for a write and return its canonical form: chart
223
+ * tags carry only their id and charts not placed in the markdown are dropped.
224
+ *
225
+ * Content this release can't read (charts and block tags from a newer
226
+ * release) is accepted only unchanged from `previous`, the version being
227
+ * replaced. A client may leave such charts out; they are carried over.
228
+ */
229
+ const parseDocumentContent = (schemaVersion, raw, { previous } = {}) => {
102
230
  if (schemaVersion !== exports.DOCUMENT_SCHEMA_VERSION) {
103
231
  throw new errors_1.ParameterError(`Unsupported Document schema version: ${schemaVersion}`);
104
232
  }
105
- contentValidator ?? (contentValidator = createValidator());
106
- if (!contentValidator(raw)) {
107
- throw new errors_1.ParameterError(`Invalid Document content: ${contentValidator.errors?.map((error) => `${error.instancePath} ${error.message}`).join('; ')}`);
233
+ const { markdown, entries } = parseContentEnvelope(raw);
234
+ const previousUnsupported = previous?.unsupportedCharts ?? {};
235
+ const readEntries = Object.entries(entries).map(([id, entry]) => [id, entry, readChartEntry(id, entry)]);
236
+ const newEntry = readEntries.find(([id, entry, chart]) => chart === undefined &&
237
+ !(Object.hasOwn(previousUnsupported, id) &&
238
+ (0, lodash_1.isEqual)(entry, previousUnsupported[id])));
239
+ if (newEntry) {
240
+ throw new errors_1.ParameterError(`Chart "${newEntry[0]}" is ${describeChartEntry(newEntry[1])}, which this version doesn't support`);
108
241
  }
109
- const blocks = (0, documentMarkdown_1.getDocumentChartBlocks)(raw);
110
- blocks.forEach((block) => {
111
- if (block.type === 'chart')
112
- validateChart(block.id, block.chart);
242
+ const blocks = (0, documentMarkdown_1.getDocumentChartBlocks)({
243
+ markdown,
244
+ charts: Object.fromEntries(readEntries.flatMap(([id, , chart]) => chart === undefined ? [] : [[id, chart]])),
245
+ unsupportedCharts: {
246
+ ...previousUnsupported,
247
+ ...Object.fromEntries(readEntries.flatMap(([id, entry, chart]) => chart === undefined ? [[id, entry]] : [])),
248
+ },
113
249
  });
250
+ const previousTags = previous
251
+ ? getUnsupportedTagLines(previous)
252
+ : new Set();
253
+ const newTag = blocks.find((block) => block.type === 'unsupportedTag' && !previousTags.has(block.line));
254
+ if (newTag?.type === 'unsupportedTag') {
255
+ throw new errors_1.ParameterError(`${newTag.line} isn't supported by this version`);
256
+ }
114
257
  return (0, documentMarkdown_1.fromDocumentChartBlocks)(blocks);
115
258
  };
116
259
  exports.parseDocumentContent = parseDocumentContent;
260
+ /**
261
+ * Read stored Document content, keeping what this release can't read (charts
262
+ * and block tags from a newer release) as unsupported content instead of
263
+ * failing the whole Document.
264
+ */
265
+ const parseStoredDocumentContent = (raw) => {
266
+ const { markdown, entries } = parseContentEnvelope(raw);
267
+ // An invalid stored chart is shown as unsupported rather than failing the Document
268
+ const readEntry = (id, entry) => {
269
+ try {
270
+ return readChartEntry(id, entry);
271
+ }
272
+ catch (error) {
273
+ if (error instanceof errors_1.ParameterError) {
274
+ return undefined;
275
+ }
276
+ throw error;
277
+ }
278
+ };
279
+ const readEntries = Object.entries(entries).map(([id, entry]) => [id, entry, readEntry(id, entry)]);
280
+ return (0, documentMarkdown_1.fromDocumentChartBlocks)((0, documentMarkdown_1.getDocumentChartBlocks)({
281
+ markdown,
282
+ charts: Object.fromEntries(readEntries.flatMap(([id, , chart]) => chart === undefined ? [] : [[id, chart]])),
283
+ unsupportedCharts: Object.fromEntries(readEntries.flatMap(([id, entry, chart]) => chart === undefined ? [[id, entry]] : [])),
284
+ }));
285
+ };
286
+ exports.parseStoredDocumentContent = parseStoredDocumentContent;
117
287
  const DOCUMENT_AS_CODE_KEYS = [
118
288
  'name',
119
289
  'slug',
@@ -122,19 +292,11 @@ const DOCUMENT_AS_CODE_KEYS = [
122
292
  'schemaVersion',
123
293
  'markdown',
124
294
  'charts',
295
+ 'unsupportedCharts',
125
296
  ];
126
- const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
127
297
  const isNonBlankString = (value) => typeof value === 'string' && value.trim() !== '';
128
- /** A Document as code, as downloaded; an omitted description is empty. */
129
- const parseDocumentAsCode = (raw) => {
130
- if (!isRecord(raw)) {
131
- throw new errors_1.ParameterError('Document as code must be an object');
132
- }
133
- const unknownKeys = Object.keys(raw).filter((key) => !DOCUMENT_AS_CODE_KEYS.includes(key));
134
- if (unknownKeys.length > 0) {
135
- throw new errors_1.ParameterError(`Unknown Document fields: ${unknownKeys.join(', ')}`);
136
- }
137
- const { name, slug, description = '', spaceSlug, schemaVersion } = raw;
298
+ const parseDocumentAsCodeMetadata = (raw) => {
299
+ const { name, slug, description = '', spaceSlug } = raw;
138
300
  if (!isNonBlankString(name) ||
139
301
  !isNonBlankString(slug) ||
140
302
  !isNonBlankString(spaceSlug)) {
@@ -143,22 +305,72 @@ const parseDocumentAsCode = (raw) => {
143
305
  if (typeof description !== 'string') {
144
306
  throw new errors_1.ParameterError('Document description must be a string');
145
307
  }
308
+ return { name, slug, description, spaceSlug };
309
+ };
310
+ const assertRecord = (value, message) => {
311
+ if (!isRecord(value)) {
312
+ throw new errors_1.ParameterError(message);
313
+ }
314
+ };
315
+ /**
316
+ * A Document as code, validated strictly for a write; an omitted description
317
+ * is empty. Content this release can't read must be unchanged from
318
+ * `previous`, as in `parseDocumentContent`.
319
+ */
320
+ const parseDocumentAsCode = (raw, { previous } = {}) => {
321
+ assertRecord(raw, 'Document as code must be an object');
322
+ const unknownKeys = Object.keys(raw).filter((key) => !DOCUMENT_AS_CODE_KEYS.includes(key));
323
+ if (unknownKeys.length > 0) {
324
+ throw new errors_1.ParameterError(`Unknown Document fields: ${unknownKeys.join(', ')}`);
325
+ }
326
+ const { schemaVersion } = raw;
146
327
  if (schemaVersion !== exports.DOCUMENT_SCHEMA_VERSION) {
147
328
  throw new errors_1.ParameterError(`Unsupported Document schema version: ${String(schemaVersion)}`);
148
329
  }
149
330
  return {
150
- name,
151
- slug,
152
- description,
153
- spaceSlug,
331
+ ...parseDocumentAsCodeMetadata(raw),
154
332
  schemaVersion,
155
333
  ...(0, exports.parseDocumentContent)(schemaVersion, {
156
334
  markdown: raw.markdown,
157
335
  charts: raw.charts ?? {},
158
- }),
336
+ ...(raw.unsupportedCharts === undefined
337
+ ? {}
338
+ : { unsupportedCharts: raw.unsupportedCharts }),
339
+ }, { previous }),
159
340
  };
160
341
  };
161
342
  exports.parseDocumentAsCode = parseDocumentAsCode;
343
+ /**
344
+ * A Document file checked only for its outer shape, for clients such as the
345
+ * CLI. Charts and fields this client doesn't know pass through for the server
346
+ * to validate, so files from a newer release still upload.
347
+ */
348
+ const parseDocumentAsCodeFile = (raw) => {
349
+ assertRecord(raw, 'Document as code must be an object');
350
+ const { schemaVersion, markdown, charts = {}, unsupportedCharts } = raw;
351
+ if (typeof schemaVersion !== 'number' || !Number.isInteger(schemaVersion)) {
352
+ throw new errors_1.ParameterError('Document schemaVersion must be an integer');
353
+ }
354
+ if (typeof markdown !== 'string') {
355
+ throw new errors_1.ParameterError('Document markdown must be a string');
356
+ }
357
+ assertRecord(charts, 'Document charts must be an object');
358
+ const invalidChart = Object.entries(charts).find(([, chart]) => !isRecord(chart) || typeof chart.source !== 'string');
359
+ if (invalidChart) {
360
+ throw new errors_1.ParameterError(`Document chart "${invalidChart[0]}" must be an object with a source`);
361
+ }
362
+ if (unsupportedCharts !== undefined) {
363
+ assertRecord(unsupportedCharts, 'Document unsupportedCharts must be an object');
364
+ }
365
+ // Typed as known charts; the server validates them on upload.
366
+ return {
367
+ ...raw,
368
+ ...parseDocumentAsCodeMetadata(raw),
369
+ markdown,
370
+ charts,
371
+ };
372
+ };
373
+ exports.parseDocumentAsCodeFile = parseDocumentAsCodeFile;
162
374
  /**
163
375
  * The runtime chart config of a stored Document chart. Stored custom charts
164
376
  * are always pinned to this project's chart type uuid; the portable slug that
@@ -1 +1 @@
1
- {"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/utils/document.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/utils/document.ts"],"names":[],"mappings":"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"}
@@ -11,17 +11,30 @@ export type DocumentTag = {
11
11
  export type DocumentBlock = {
12
12
  type: 'markdown';
13
13
  markdown: string;
14
- } | {
14
+ }
15
+ /** `line` is the tag as written, when it was parsed from markdown. */
16
+ | {
15
17
  type: 'tag';
16
18
  tag: DocumentTag;
19
+ line?: string;
17
20
  };
18
21
  export declare const DOCUMENT_CHART_TAG = "document-chart";
19
- export declare const parseDocumentBlocks: (markdown: string, tagNames: readonly string[]) => DocumentBlock[];
22
+ /**
23
+ * Lightdash block tag names contain a hyphen, which no HTML element does, so
24
+ * tags added by a newer release are recognised here and kept rather than read
25
+ * as markdown.
26
+ */
27
+ export declare const isDocumentBlockTagName: (name: string) => boolean;
28
+ export declare const parseDocumentBlocks: (markdown: string, tagNames: readonly string[] | ((name: string) => boolean)) => DocumentBlock[];
20
29
  export declare const formatDocumentTag: ({ name, attributes }: DocumentTag) => string;
21
30
  export declare const joinDocumentBlocks: (blocks: DocumentBlock[]) => string;
22
31
  export declare const getDocumentChartTag: (id: string) => string;
23
32
  /** The number of a stored chart id (`c3` → 3), or undefined for a temporary key. */
24
33
  export declare const getDocumentChartNumber: (id: string) => number | undefined;
34
+ /**
35
+ * `unsupportedChart` and `unsupportedTag` are content from a newer release:
36
+ * shown as a placeholder and written back unchanged.
37
+ */
25
38
  export type DocumentChartBlock = {
26
39
  type: 'markdown';
27
40
  markdown: string;
@@ -29,13 +42,23 @@ export type DocumentChartBlock = {
29
42
  type: 'chart';
30
43
  id: string;
31
44
  chart: DocumentChartContent;
45
+ } | {
46
+ type: 'unsupportedChart';
47
+ id: string;
48
+ raw: unknown;
49
+ } | {
50
+ type: 'unsupportedTag';
51
+ line: string;
32
52
  };
33
53
  /**
34
54
  * The Document in reading order. Chart tags must reference an entry in
35
- * `charts`, once each; other tags stay markdown.
55
+ * `charts` or `unsupportedCharts`, once each.
36
56
  */
37
57
  export declare const getDocumentChartBlocks: (content: DocumentContent) => DocumentChartBlock[];
38
- /** Canonical content: chart tags carry only their id, unplaced charts are dropped. */
58
+ /**
59
+ * Canonical content: chart tags carry only their id, unplaced charts are
60
+ * dropped, and `unsupportedCharts` is omitted when empty.
61
+ */
39
62
  export declare const fromDocumentChartBlocks: (blocks: DocumentChartBlock[]) => DocumentContent;
40
63
  export declare const mapDocumentCharts: (content: DocumentContent, map: (chart: DocumentChartContent, id: string) => DocumentChartContent) => DocumentContent;
41
64
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"documentMarkdown.d.ts","sourceRoot":"","sources":["../../../src/utils/documentMarkdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAI/E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;AAExC,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAiCnD,eAAO,MAAM,mBAAmB,aAClB,MAAM,YACN,SAAS,MAAM,EAAE,KAC5B,aAAa,EAyCf,CAAC;AAEF,eAAO,MAAM,iBAAiB,yBAA0B,WAAW,KAAG,MAGlD,CAAC;AAErB,eAAO,MAAM,kBAAkB,WAAY,aAAa,EAAE,KAAG,MAOxC,CAAC;AAEtB,eAAO,MAAM,mBAAmB,OAAQ,MAAM,KAAG,MACsB,CAAC;AAExE,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,OAAQ,MAAM,KAAG,MAAM,GAAG,SAG5D,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,YACtB,eAAe,KACzB,kBAAkB,EA4BpB,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,WACxB,kBAAkB,EAAE,KAC7B,eAmBD,CAAC;AAEH,eAAO,MAAM,iBAAiB,YACjB,eAAe,OACnB,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,KAAK,oBAAoB,KACvE,eAQD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,YACtB,eAAe,mBACP,MAAM,KACxB;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAyBrD,CAAC;AAEF,eAAO,MAAM,oBAAoB,YACpB,eAAe,KACzB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAG/C,CAAC;AASN;;;GAGG;AACH,eAAO,MAAM,0BAA0B,YAAa,eAAe,KAAG,MAmBjE,CAAC;AAEN,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,eAAO,MAAM,0BAA0B,6CAG7B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,YACtB,eAAe,YACd,eAAe,KAC1B,eA0BF,CAAC"}
1
+ {"version":3,"file":"documentMarkdown.d.ts","sourceRoot":"","sources":["../../../src/utils/documentMarkdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAK/E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACxC,sEAAsE;GACpE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,SAAU,MAAM,KAAG,OAChC,CAAC;AAiCvB,eAAO,MAAM,mBAAmB,aAClB,MAAM,YACN,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAC1D,aAAa,EA8Cf,CAAC;AAEF,eAAO,MAAM,iBAAiB,yBAA0B,WAAW,KAAG,MAGlD,CAAC;AAErB,eAAO,MAAM,kBAAkB,WAAY,aAAa,EAAE,KAAG,MAOxC,CAAC;AAEtB,eAAO,MAAM,mBAAmB,OAAQ,MAAM,KAAG,MACsB,CAAC;AAExE,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,OAAQ,MAAM,KAAG,MAAM,GAAG,SAG5D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,YACtB,eAAe,KACzB,kBAAkB,EAuCpB,CAAC;AAmBF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,WACxB,kBAAkB,EAAE,KAC7B,eAiBF,CAAC;AAEF,eAAO,MAAM,iBAAiB,YACjB,eAAe,OACnB,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,KAAK,oBAAoB,KACvE,eAQD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,YACtB,eAAe,mBACP,MAAM,KACxB;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAyBrD,CAAC;AAEF,eAAO,MAAM,oBAAoB,YACpB,eAAe,KACzB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAG/C,CAAC;AAaN;;;GAGG;AACH,eAAO,MAAM,0BAA0B,YAAa,eAAe,KAAG,MAiCjE,CAAC;AAEN,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,eAAO,MAAM,0BAA0B,6CAG7B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,YACtB,eAAe,YACd,eAAe,KAC1B,eA0BF,CAAC"}