@lightdash/common 0.2104.6 → 0.2104.8

package/dist/types/utils/convertCustomDimensionsToYaml.js

@@ -0,0 +1,115 @@
+import { NotImplementedError } from '../types/errors';
+import { BinType, DimensionType, friendlyName, isCustomBinDimension, } from '../types/field';
+import { getCustomRangeSelectSql, getFixedWidthBinSelectSql, } from './customDimensions';
+export const convertCustomSqlDimensionToDbt = (field) => ({
+    label: friendlyName(field.name),
+    type: field.dimensionType,
+    sql: field.sql,
+});
+export const convertCustomBinDimensionToDbt = ({ customDimension, baseDimensionSql, warehouseSqlBuilder, }) => {
+    switch (customDimension.binType) {
+        case BinType.CUSTOM_RANGE:
+            return {
+                label: friendlyName(customDimension.name),
+                type: DimensionType.STRING,
+                sql: getCustomRangeSelectSql({
+                    binRanges: customDimension.customRange || [],
+                    baseDimensionSql,
+                    warehouseSqlBuilder,
+                }),
+            };
+        case BinType.FIXED_WIDTH:
+            return {
+                label: friendlyName(customDimension.name),
+                type: DimensionType.STRING,
+                sql: getFixedWidthBinSelectSql({
+                    binWidth: customDimension.binWidth || 1,
+                    baseDimensionSql,
+                    warehouseSqlBuilder,
+                }),
+            };
+        case BinType.FIXED_NUMBER:
+            throw new NotImplementedError('Bin with fixed number of bins can not be converted to dbt as it requires a CTE');
+        default:
+            const never = customDimension.binType;
+            throw new Error(`Unknown bin type ${never}`);
+    }
+};
+// Mock Bigquery warehouse client for preview
+const warehouseClientMock = {
+    credentials: undefined,
+    getCatalog() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    getAsyncQueryResults() {
+        throw new NotImplementedError('getAsyncQueryResults not implemented');
+    },
+    getAdapterType() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    getAllTables() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    getFields() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    getMetricSql() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    getStartOfWeek() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    parseError() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    parseWarehouseCatalog() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    runQuery() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    streamQuery() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    executeAsyncQuery() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    test() {
+        throw new NotImplementedError('getCatalog not implemented');
+    },
+    concatString(...args) {
+        return `CONCAT(${args.join(', ')})`;
+    },
+    getStringQuoteChar() {
+        return "'";
+    },
+    getEscapeStringQuoteChar() {
+        return '\\';
+    },
+    getFieldQuoteChar() {
+        return '"';
+    },
+    getFloatingType() {
+        return 'FLOAT';
+    },
+    escapeString(value) {
+        return value;
+    },
+};
+export const previewConvertCustomDimensionToDbt = (field) => {
+    if (isCustomBinDimension(field)) {
+        // Mock base dimension SQL and warehouse client for preview
+        const preview = convertCustomBinDimensionToDbt({
+            customDimension: field,
+            baseDimensionSql: '${reference_column}',
+            warehouseSqlBuilder: warehouseClientMock,
+        });
+        return {
+            ...preview,
+            // Add a comment at the top of the multiline string to indicate that this is a preview
+            sql: `/* This is a preview! Replace column references and confirm SQL before using in production. */\n${preview.sql}`,
+        };
+    }
+    return convertCustomSqlDimensionToDbt(field);
+};
+//# sourceMappingURL=convertCustomDimensionsToYaml.js.map

package/dist/types/utils/convertCustomDimensionsToYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertCustomDimensionsToYaml.js","sourceRoot":"","sources":["../../../src/utils/convertCustomDimensionsToYaml.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/convertCustomMetricsToYaml.js

@@ -0,0 +1,15 @@
+import { friendlyName } from '../types/field';
+import { convertMetricFilterToDbt } from '../types/filterGrammarConversion';
+import { getFormatExpression } from './formatting';
+export function convertCustomMetricToDbt(field) {
+    const filters = convertMetricFilterToDbt(field.filters);
+    return {
+        label: field.label || friendlyName(field.name),
+        description: field.description,
+        type: field.type,
+        format: getFormatExpression(field),
+        percentile: field.percentile,
+        filters,
+    };
+}
+//# sourceMappingURL=convertCustomMetricsToYaml.js.map

package/dist/types/utils/convertCustomMetricsToYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertCustomMetricsToYaml.js","sourceRoot":"","sources":["../../../src/utils/convertCustomMetricsToYaml.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,UAAU,wBAAwB,CACpC,KAAuB;IAEvB,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO;QACH,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;QAC9C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO;KACV,CAAC;AACN,CAAC"}

package/dist/types/utils/customDimensions.js

@@ -0,0 +1,27 @@
+export const getFixedWidthBinSelectSql = ({ binWidth, baseDimensionSql, warehouseSqlBuilder, }) => {
+    const quoteChar = warehouseSqlBuilder.getStringQuoteChar();
+    return `${warehouseSqlBuilder.concatString(`FLOOR(${baseDimensionSql} / ${binWidth}) * ${binWidth}`, `${quoteChar} - ${quoteChar}`, `(FLOOR(${baseDimensionSql} / ${binWidth}) + 1) * ${binWidth} - 1`)}`;
+};
+export const getCustomRangeSelectSql = ({ binRanges, baseDimensionSql, warehouseSqlBuilder, }) => {
+    const quoteChar = warehouseSqlBuilder.getStringQuoteChar();
+    const binRangeWhens = binRanges.map((range) => {
+        if (range.from === undefined) {
+            // First range
+            return `WHEN ${baseDimensionSql} < ${range.to} THEN ${warehouseSqlBuilder.concatString(`${quoteChar}<${quoteChar}`, `${range.to}`)}`;
+        }
+        if (range.to === undefined) {
+            // Last range
+            return `ELSE ${warehouseSqlBuilder.concatString(`${quoteChar}≥${quoteChar}`, `${range.from}`)}`;
+        }
+        return `WHEN ${baseDimensionSql} >= ${range.from} AND ${baseDimensionSql} < ${range.to} THEN ${warehouseSqlBuilder.concatString(`${range.from}`, "'-'", `${range.to}`)}`;
+    });
+    // Add a NULL case for when the dimension is NULL, returning null as the value so it get's correctly formated with the symbol ∅
+    const rangeWhens = [
+        `WHEN ${baseDimensionSql} IS NULL THEN NULL`,
+        ...binRangeWhens,
+    ];
+    return `CASE
+            ${rangeWhens.join('\n')}
+            END`;
+};
+//# sourceMappingURL=customDimensions.js.map

package/dist/types/utils/customDimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customDimensions.js","sourceRoot":"","sources":["../../../src/utils/customDimensions.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,EACtC,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,GAKtB,EAAE,EAAE;IACD,MAAM,SAAS,GAAG,mBAAmB,CAAC,kBAAkB,EAAE,CAAC;IAC3D,OAAO,GAAG,mBAAmB,CAAC,YAAY,CACtC,SAAS,gBAAgB,MAAM,QAAQ,OAAO,QAAQ,EAAE,EACxD,GAAG,SAAS,MAAM,SAAS,EAAE,EAC7B,UAAU,gBAAgB,MAAM,QAAQ,YAAY,QAAQ,MAAM,CACrE,EAAE,CAAC;AACR,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,EACpC,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GAKtB,EAAE,EAAE;IACD,MAAM,SAAS,GAAG,mBAAmB,CAAC,kBAAkB,EAAE,CAAC;IAC3D,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,cAAc;YACd,OAAO,QAAQ,gBAAgB,MAC3B,KAAK,CAAC,EACV,SAAS,mBAAmB,CAAC,YAAY,CACrC,GAAG,SAAS,IAAI,SAAS,EAAE,EAC3B,GAAG,KAAK,CAAC,EAAE,EAAE,CAChB,EAAE,CAAC;QACR,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACzB,aAAa;YACb,OAAO,QAAQ,mBAAmB,CAAC,YAAY,CAC3C,GAAG,SAAS,IAAI,SAAS,EAAE,EAC3B,GAAG,KAAK,CAAC,IAAI,EAAE,CAClB,EAAE,CAAC;QACR,CAAC;QAED,OAAO,QAAQ,gBAAgB,OAC3B,KAAK,CAAC,IACV,QAAQ,gBAAgB,MACpB,KAAK,CAAC,EACV,SAAS,mBAAmB,CAAC,YAAY,CACrC,GAAG,KAAK,CAAC,IAAI,EAAE,EACf,KAAK,EACL,GAAG,KAAK,CAAC,EAAE,EAAE,CAChB,EAAE,CAAC;IACR,CAAC,CAAC,CAAC;IAEH,+HAA+H;IAC/H,MAAM,UAAU,GAAG;QACf,QAAQ,gBAAgB,oBAAoB;QAC5C,GAAG,aAAa;KACnB,CAAC;IAEF,OAAO;cACG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBACnB,CAAC;AACjB,CAAC,CAAC"}

package/dist/types/utils/dashboard.js

@@ -0,0 +1,35 @@
+import { ChartSourceType } from '../types/content';
+import { DashboardTileTypes } from '../types/dashboard';
+import { ParameterError } from '../types/errors';
+import assertUnreachable from './assertUnreachable';
+export const convertChartSourceTypeToDashboardTileType = (sourceType) => {
+    switch (sourceType) {
+        case ChartSourceType.DBT_EXPLORE:
+            return DashboardTileTypes.SAVED_CHART;
+        case ChartSourceType.SQL:
+            return DashboardTileTypes.SQL_CHART;
+        default:
+            return assertUnreachable(sourceType, `Unknown source type: ${sourceType}`);
+    }
+};
+/**
+ * Validates that selected tabs exist in the dashboard tiles.
+ * If selectedTabs is provided and not empty, ensures at least one selected tab exists in dashboard tabs.
+ * @param selectedTabs - Array of selected tab UUIDs or null
+ * @param dashboardTiles - Array of dashboard tiles
+ * @throws ParameterError if none of the selected tabs exist in the dashboard
+ */
+export const validateSelectedTabs = (selectedTabs, dashboardTiles) => {
+    // If selectedTabs is provided and not empty, validate that at least one exists in dashboard tabs
+    if (selectedTabs && selectedTabs.length > 0) {
+        const availableTabs = dashboardTiles
+            .map((tile) => tile.tabUuid)
+            .filter((tabUuid) => !!tabUuid)
+            .filter((tabUuid, index, self) => self.indexOf(tabUuid) === index);
+        const validSelectedTabs = selectedTabs.filter((tabUuid) => availableTabs.includes(tabUuid));
+        if (validSelectedTabs.length === 0) {
+            throw new ParameterError(`None of the selected tabs exist in the dashboard`);
+        }
+    }
+};
+//# sourceMappingURL=dashboard.js.map

package/dist/types/utils/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/utils/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAsB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,yCAAyC,GAAG,CACrD,UAA2B,EACT,EAAE;IACpB,QAAQ,UAAU,EAAE,CAAC;QACjB,KAAK,eAAe,CAAC,WAAW;YAC5B,OAAO,kBAAkB,CAAC,WAAW,CAAC;QAC1C,KAAK,eAAe,CAAC,GAAG;YACpB,OAAO,kBAAkB,CAAC,SAAS,CAAC;QACxC;YACI,OAAO,iBAAiB,CACpB,UAAU,EACV,wBAAwB,UAAU,EAAE,CACvC,CAAC;IACV,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAChC,YAA6B,EAC7B,cAA+B,EAC3B,EAAE;IACN,iGAAiG;IACjG,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,cAAc;aAC/B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;aAC3B,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;aACjD,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC;QAEvE,MAAM,iBAAiB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACtD,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAClC,CAAC;QACF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,cAAc,CACpB,kDAAkD,CACrD,CAAC;QACN,CAAC;IACL,CAAC;AACL,CAAC,CAAC"}

package/dist/types/utils/dashboard.test.js

@@ -0,0 +1,36 @@
+import { ParameterError } from '../types/errors';
+import { validateSelectedTabs } from './dashboard';
+describe('validateSelectedTabs', () => {
+    // Simple mock that focuses on just the tabUuid property
+    const mockTiles = [
+        { tabUuid: 'tab1' },
+        { tabUuid: 'tab2' },
+        { tabUuid: null },
+        { tabUuid: undefined },
+    ];
+    it('should not throw when selectedTabs is null', () => {
+        expect(() => validateSelectedTabs(null, mockTiles)).not.toThrow();
+    });
+    it('should not throw when selectedTabs is empty array', () => {
+        expect(() => validateSelectedTabs([], mockTiles)).not.toThrow();
+    });
+    it('should not throw when selectedTabs contains valid tab UUIDs', () => {
+        expect(() => validateSelectedTabs(['tab1'], mockTiles)).not.toThrow();
+        expect(() => validateSelectedTabs(['tab1', 'tab2'], mockTiles)).not.toThrow();
+    });
+    it('should throw ParameterError when none of selectedTabs exist in dashboard', () => {
+        expect(() => validateSelectedTabs(['nonexistent-tab'], mockTiles)).toThrow(ParameterError);
+        expect(() => validateSelectedTabs(['tab1', 'nonexistent-tab'], mockTiles)).not.toThrow(); // Should pass because tab1 exists
+    });
+    it('should throw ParameterError with informative message', () => {
+        expect(() => validateSelectedTabs(['nonexistent-tab'], mockTiles)).toThrow('None of the selected tabs exist in the dashboard');
+    });
+    it('should handle tiles without tabUuid', () => {
+        const tilesWithoutTabUuid = [
+            { tabUuid: undefined },
+            { tabUuid: null },
+        ];
+        expect(() => validateSelectedTabs(['any-tab'], tilesWithoutTabUuid)).toThrow('None of the selected tabs exist in the dashboard');
+    });
+});
+//# sourceMappingURL=dashboard.test.js.map

package/dist/types/utils/dashboard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.test.js","sourceRoot":"","sources":["../../../src/utils/dashboard.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,wDAAwD;IACxD,MAAM,SAAS,GAAG;QACd,EAAE,OAAO,EAAE,MAAM,EAAE;QACnB,EAAE,OAAO,EAAE,MAAM,EAAE;QACnB,EAAE,OAAO,EAAE,IAAI,EAAE;QACjB,EAAE,OAAO,EAAE,SAAS,EAAE;KACN,CAAC;IAErB,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACtE,MAAM,CAAC,GAAG,EAAE,CACR,oBAAoB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CACpD,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAChF,MAAM,CAAC,GAAG,EAAE,CACR,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,CACvD,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,EAAE,CACR,oBAAoB,CAAC,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,SAAS,CAAC,CAC/D,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,kCAAkC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,EAAE,CACR,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,CACvD,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,MAAM,mBAAmB,GAAG;YACxB,EAAE,OAAO,EAAE,SAAS,EAAE;YACtB,EAAE,OAAO,EAAE,IAAI,EAAE;SACD,CAAC;QAErB,MAAM,CAAC,GAAG,EAAE,CACR,oBAAoB,CAAC,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC,CACzD,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/types/utils/dbt.js

@@ -0,0 +1,4 @@
+export const validateDbtSelector = (selector) => 
+// eslint-disable-next-line no-useless-escape
+/^@?[a-zA-Z0-9\s\*\-\.\+:_\/]+$/.test(selector);
+//# sourceMappingURL=dbt.js.map

package/dist/types/utils/dbt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbt.js","sourceRoot":"","sources":["../../../src/utils/dbt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAgB,EAAW,EAAE;AAC7D,6CAA6C;AAC7C,gCAAgC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC"}

package/dist/types/utils/dbt.test.js

@@ -0,0 +1,39 @@
+import { validateDbtSelector } from './dbt';
+describe('validateDbtSelector', () => {
+    it('should allow valid selectors', () => {
+        const validSelectors = [
+            'model_name',
+            'tag:daily',
+            'my_model+', // select my_model and all descendants
+            '+my_model', // select my_model and all ancestors
+            'folder.model',
+            'model_123',
+            'model-name',
+            'model:staging',
+            'model_name_with_underscore',
+            '*_wildcard_*',
+            'middle_wild*card',
+            '@my_model', // select my_model, its descendants, and the ancestors of its descendants
+            'events +customers tag:lightdash', // Complex selector with multiple parts
+            'model/name', // forward slash
+        ];
+        validSelectors.forEach((selector) => {
+            expect(validateDbtSelector(selector)).toBe(true);
+        });
+    });
+    it('should reject invalid selectors', () => {
+        const invalidSelectors = [
+            'model\\name', // backslash
+            'model$name', // special character
+            'model@name', // @ in the middle
+            'model@', // @ in the end
+            'model;name', // semicolon
+            'model`name', // backtick
+            'model"name', // quotes
+        ];
+        invalidSelectors.forEach((selector) => {
+            expect(validateDbtSelector(selector)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=dbt.test.js.map

package/dist/types/utils/dbt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbt.test.js","sourceRoot":"","sources":["../../../src/utils/dbt.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAE5C,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,MAAM,cAAc,GAAG;YACnB,YAAY;YACZ,WAAW;YACX,WAAW,EAAE,sCAAsC;YACnD,WAAW,EAAE,oCAAoC;YACjD,cAAc;YACd,WAAW;YACX,YAAY;YACZ,eAAe;YACf,4BAA4B;YAC5B,cAAc;YACd,kBAAkB;YAClB,WAAW,EAAE,yEAAyE;YACtF,iCAAiC,EAAE,uCAAuC;YAC1E,YAAY,EAAE,gBAAgB;SACjC,CAAC;QAEF,cAAc,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACvC,MAAM,gBAAgB,GAAG;YACrB,aAAa,EAAE,YAAY;YAC3B,YAAY,EAAE,oBAAoB;YAClC,YAAY,EAAE,kBAAkB;YAChC,QAAQ,EAAE,eAAe;YACzB,YAAY,EAAE,YAAY;YAC1B,YAAY,EAAE,WAAW;YACzB,YAAY,EAAE,SAAS;SAC1B,CAAC;QAEF,gBAAgB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/types/utils/dependencyGraph.js

@@ -0,0 +1,51 @@
+/**
+ * Detects circular dependencies in a dependency graph using depth-first search.
+ * Throws an error if a circular dependency is found.
+ *
+ * @param dependencies - Array of nodes with their dependencies
+ * @param errorPrefix - Prefix for the error message (e.g., "table calculations", "metrics")
+ * @throws Error if a circular dependency is detected, with the full cycle path
+ *
+ * @example
+ * ```typescript
+ * const dependencies = [
+ *   { name: 'A', dependencies: ['B'] },
+ *   { name: 'B', dependencies: ['C'] },
+ *   { name: 'C', dependencies: ['A'] } // Creates a cycle: A -> B -> C -> A
+ * ];
+ * detectCircularDependencies(dependencies, 'table calculations');
+ * // Throws: "Circular dependency detected in table calculations: A -> B -> C -> A"
+ * ```
+ */
+export function detectCircularDependencies(dependencies, errorPrefix = 'items') {
+    const visited = new Set();
+    const recursionStack = new Set();
+    const dfs = (nodeName, path) => {
+        if (recursionStack.has(nodeName)) {
+            const cycle = [...path, nodeName].join(' -> ');
+            throw new Error(`Circular dependency detected in ${errorPrefix}: ${cycle}`);
+        }
+        if (visited.has(nodeName)) {
+            return;
+        }
+        visited.add(nodeName);
+        recursionStack.add(nodeName);
+        const node = dependencies.find((d) => d.name === nodeName);
+        if (node) {
+            for (const dep of node.dependencies) {
+                // Only follow dependencies that are nodes in the graph
+                if (dependencies.some((d) => d.name === dep)) {
+                    dfs(dep, [...path, nodeName]);
+                }
+            }
+        }
+        recursionStack.delete(nodeName);
+    };
+    // Check all nodes for cycles
+    for (const dep of dependencies) {
+        if (!visited.has(dep.name)) {
+            dfs(dep.name, []);
+        }
+    }
+}
+//# sourceMappingURL=dependencyGraph.js.map

package/dist/types/utils/dependencyGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyGraph.js","sourceRoot":"","sources":["../../../src/utils/dependencyGraph.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,0BAA0B,CACtC,YAA8B,EAC9B,cAAsB,OAAO;IAE7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,MAAM,GAAG,GAAG,CAAC,QAAgB,EAAE,IAAc,EAAQ,EAAE;QACnD,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CACX,mCAAmC,WAAW,KAAK,KAAK,EAAE,CAC7D,CAAC;QACN,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC3D,IAAI,IAAI,EAAE,CAAC;YACP,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClC,uDAAuD;gBACvD,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBAC3C,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAClC,CAAC;YACL,CAAC;QACL,CAAC;QAED,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC;IAEF,6BAA6B;IAC7B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/types/utils/dependencyGraph.test.js

@@ -0,0 +1,113 @@
+import { detectCircularDependencies, } from './dependencyGraph';
+describe('detectCircularDependencies', () => {
+    it('should not throw for valid dependency graph with no cycles', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B', 'C'] },
+            { name: 'B', dependencies: ['D'] },
+            { name: 'C', dependencies: ['D'] },
+            { name: 'D', dependencies: [] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'test items')).not.toThrow();
+    });
+    it('should not throw for empty dependency array', () => {
+        expect(() => detectCircularDependencies([], 'test items')).not.toThrow();
+    });
+    it('should not throw for single node with no dependencies', () => {
+        const dependencies = [
+            { name: 'A', dependencies: [] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'test items')).not.toThrow();
+    });
+    it('should not throw when dependencies reference non-existent nodes', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B', 'nonexistent'] },
+            { name: 'B', dependencies: ['C'] },
+            { name: 'C', dependencies: [] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'test items')).not.toThrow();
+    });
+    it('should not throw for multiple disconnected components', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B'] },
+            { name: 'B', dependencies: [] },
+            { name: 'C', dependencies: ['D'] },
+            { name: 'D', dependencies: [] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'test items')).not.toThrow();
+    });
+    it('should detect simple circular dependency (A -> B -> A)', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B'] },
+            { name: 'B', dependencies: ['A'] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'table calculations')).toThrow('Circular dependency detected in table calculations: A -> B -> A');
+    });
+    it('should detect self-referencing circular dependency (A -> A)', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['A'] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'metrics')).toThrow('Circular dependency detected in metrics: A -> A');
+    });
+    it('should detect longer circular dependency chain (A -> B -> C -> A)', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B'] },
+            { name: 'B', dependencies: ['C'] },
+            { name: 'C', dependencies: ['A'] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'calculations')).toThrow('Circular dependency detected in calculations: A -> B -> C -> A');
+    });
+    it('should detect circular dependency in complex graph (A -> B -> C -> D -> B)', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B'] },
+            { name: 'B', dependencies: ['C'] },
+            { name: 'C', dependencies: ['D'] },
+            { name: 'D', dependencies: ['B'] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'fields')).toThrow('Circular dependency detected in fields: A -> B -> C -> D -> B');
+    });
+    it('should detect circular dependency with multiple paths', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B', 'C'] },
+            { name: 'B', dependencies: ['D'] },
+            { name: 'C', dependencies: ['D'] },
+            { name: 'D', dependencies: ['A'] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'nodes')).toThrow('Circular dependency detected in nodes');
+    });
+    it('should use default error prefix when not provided', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B'] },
+            { name: 'B', dependencies: ['A'] },
+        ];
+        expect(() => detectCircularDependencies(dependencies)).toThrow('Circular dependency detected in items: A -> B -> A');
+    });
+    it('should handle graph with cycle not starting from first node', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B'] },
+            { name: 'B', dependencies: [] },
+            { name: 'C', dependencies: ['D'] },
+            { name: 'D', dependencies: ['C'] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'test')).toThrow('Circular dependency detected in test: C -> D -> C');
+    });
+    it('should handle complex valid graph with shared dependencies', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['D'] },
+            { name: 'B', dependencies: ['D'] },
+            { name: 'C', dependencies: ['D'] },
+            { name: 'D', dependencies: ['E'] },
+            { name: 'E', dependencies: [] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'test')).not.toThrow();
+    });
+    it('should handle node with multiple dependencies including a cycle', () => {
+        const dependencies = [
+            { name: 'A', dependencies: ['B', 'C', 'D'] },
+            { name: 'B', dependencies: [] },
+            { name: 'C', dependencies: ['A'] },
+            { name: 'D', dependencies: [] },
+        ];
+        expect(() => detectCircularDependencies(dependencies, 'test')).toThrow('Circular dependency detected in test: A -> C -> A');
+    });
+});
+//# sourceMappingURL=dependencyGraph.test.js.map

package/dist/types/utils/dependencyGraph.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyGraph.test.js","sourceRoot":"","sources":["../../../src/utils/dependencyGraph.test.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/email.js

@@ -0,0 +1,76 @@
+export const getEmailDomain = (email) => {
+    if (/\s/.test(email)) {
+        throw new Error(`Invalid email, contains whitespace: ${email}`);
+    }
+    const domains = email.split('@');
+    if (domains.length !== 2 || !domains[1]) {
+        throw new Error(`Invalid email: ${email}`);
+    }
+    return domains[1].toLowerCase();
+};
+const EMAIL_PROVIDER_LIST = [
+    'gmail.com',
+    'yahoo.com',
+    'hotmail.com',
+    'aol.com',
+    'hotmail.co.uk',
+    'hotmail.fr',
+    'msn.com',
+    'yahoo.fr',
+    'wanadoo.fr',
+    'orange.fr',
+    'comcast.net',
+    'yahoo.co.uk',
+    'yahoo.com.br',
+    'yahoo.co.in',
+    'live.com',
+    'rediffmail.com',
+    'free.fr',
+    'gmx.de',
+    'web.de',
+    'yandex.ru',
+    'outlook.com',
+    'uol.com.br',
+    'bol.com.br',
+    'mail.ru',
+    'cox.net',
+    'hotmail.it',
+    'sbcglobal.net',
+    'sfr.fr',
+    'live.fr',
+    'verizon.net',
+    'live.co.uk',
+    'googlemail.com',
+    'yahoo.es',
+    'ig.com.br',
+    'live.nl',
+    'bigpond.com',
+    'terra.com.br',
+    'yahoo.it',
+    'yahoo.de',
+    'rocketmail.com',
+    'yahoo.in',
+    'hotmail.es',
+    'hotmail.de',
+    'shaw.ca',
+    'yahoo.co.jp',
+    'sky.com',
+    'blueyonder.co.uk',
+    'icloud.com',
+];
+const isEmailProviderDomain = (domain) => EMAIL_PROVIDER_LIST.includes(domain);
+const VALID_EMAIL_DOMAIN_REGEX = /^[a-zA-Z0-9][\w.-]+\.\w{2,4}/g;
+export const isValidEmailDomain = (value) => value.match(VALID_EMAIL_DOMAIN_REGEX);
+export const validateOrganizationEmailDomains = (domains) => {
+    const invalidDomains = domains.filter((domain) => isEmailProviderDomain(domain));
+    if (!invalidDomains.length) {
+        return undefined;
+    }
+    const readableDomainList = new Intl.ListFormat('en-US', {
+        style: 'long',
+        type: 'conjunction',
+    }).format(invalidDomains);
+    return `${readableDomainList} ${invalidDomains.length === 1 ? 'is' : 'are'} not allowed as organization email(s)`;
+};
+export const isValidEmailAddress = (email) => /^[\w.+-]+@[\w-]+\.[A-Za-z]{2,}(?:\.[A-Za-z]{2,})*$/.test(email);
+//# sourceMappingURL=email.js.map

package/dist/types/utils/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../../src/utils/email.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE;IACpD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG;IACxB,WAAW;IACX,WAAW;IACX,aAAa;IACb,SAAS;IACT,eAAe;IACf,YAAY;IACZ,SAAS;IACT,UAAU;IACV,YAAY;IACZ,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,aAAa;IACb,UAAU;IACV,gBAAgB;IAChB,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,SAAS;IACT,YAAY;IACZ,eAAe;IACf,QAAQ;IACR,SAAS;IACT,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,UAAU;IACV,WAAW;IACX,SAAS;IACT,aAAa;IACb,cAAc;IACd,UAAU;IACV,UAAU;IACV,gBAAgB;IAChB,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,aAAa;IACb,SAAS;IACT,kBAAkB;IAClB,YAAY;CACf,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAW,EAAE,CACtD,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAEzC,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,EAAE,CAChD,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,OAAiB,EAAE,EAAE;IAClE,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7C,qBAAqB,CAAC,MAAM,CAAC,CAChC,CAAC;IAEF,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;QACpD,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,aAAa;KACtB,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAE1B,OAAO,GAAG,kBAAkB,IACxB,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KACzC,uCAAuC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAW,EAAE,CAC1D,oDAAoD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC"}

package/dist/types/utils/email.test.js

@@ -0,0 +1,49 @@
+/* eslint-disable no-useless-escape */
+import { getEmailDomain } from './email';
+describe('getEmailDomain', () => {
+    it('should return the correct domain for a valid email', () => {
+        expect(getEmailDomain('user@example.com')).toBe('example.com');
+        expect(getEmailDomain('another.user@sub.domain.co.uk')).toBe('sub.domain.co.uk');
+    });
+    it('should convert the domain to lowercase', () => {
+        expect(getEmailDomain('user@EXAMPLE.COM')).toBe('example.com');
+        expect(getEmailDomain('user@Example.Com')).toBe('example.com');
+    });
+    it('should throw an error for emails containing whitespace', () => {
+        expect(() => getEmailDomain('user @example.com')).toThrow('Invalid email, contains whitespace');
+        expect(() => getEmailDomain(' user@example.com')).toThrow('Invalid email, contains whitespace');
+        expect(() => getEmailDomain('user@example.com ')).toThrow('Invalid email, contains whitespace');
+    });
+    it('should throw an error for emails without exactly one @ symbol', () => {
+        expect(() => getEmailDomain('userexample.com')).toThrow('Invalid email');
+        expect(() => getEmailDomain('user@example@com')).toThrow('Invalid email');
+    });
+    it('should handle email addresses with special characters in the local part', () => {
+        expect(getEmailDomain('user+tag@example.com')).toBe('example.com');
+        expect(getEmailDomain('user.name@example.com')).toBe('example.com');
+        expect(getEmailDomain('user-name@example.com')).toBe('example.com');
+    });
+    it('should correctly handle email addresses with multiple @ symbols', () => {
+        expect(() => getEmailDomain('user@domain.com@example.com')).toThrow('Invalid email');
+        expect(() => getEmailDomain('"user@domain.com"@example.com')).toThrow('Invalid email');
+        expect(() => getEmailDomain('"@domain.com@"@example.com')).toThrow('Invalid email');
+    });
+    it('should not be fooled by attempts to manipulate the domain extraction', () => {
+        expect(() => getEmailDomain('user@malicious.com@legitimate.org')).toThrow('Invalid email');
+        expect(() => getEmailDomain('"@organization.com@"@attacker.com')).toThrow('Invalid email');
+        expect(() => getEmailDomain('user+@company.com@personal.email')).toThrow('Invalid email');
+    });
+    it('should throw an error for invalid email constructions', () => {
+        expect(() => getEmailDomain('user@@domain.com')).toThrow('Invalid email');
+        expect(() => getEmailDomain('@domain.com@')).toThrow('Invalid email');
+        expect(() => getEmailDomain('user@')).toThrow('Invalid email');
+    });
+    it('should handle complex but valid email addresses', () => {
+        // Unusual email without extra @
+        expect(getEmailDomain('"very.(),:;<>[]".VERY."very\\"very".unusual"@strange.example.com')).toBe('strange.example.com');
+        // Unusual email with extra @
+        expect(() => getEmailDomain('"very.(),:;<>[]".VERY."very@\\"very".unusual"@strange.example.com')).toThrow('Invalid email');
+        expect(getEmailDomain("!#$%&'*+-/=?^_`{}|~@example.org")).toBe('example.org');
+    });
+});
+//# sourceMappingURL=email.test.js.map

package/dist/types/utils/email.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.test.js","sourceRoot":"","sources":["../../../src/utils/email.test.ts"],"names":[],"mappings":"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"}