@lightdash/cli 1.125.0 → 1.127.0

package/dist/releaseSafety/index.test.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const _1 = require(".");
+const index = {
+    schemaVersion: _1.INDEX_SCHEMA_VERSION,
+    generatedAt: '2026-08-11T00:00:00.000Z',
+    backfillFloorVersion: null,
+    entries: [
+        {
+            version: '1.0.0',
+            previousVersion: '0.9.0',
+            releaseDate: '2026-07-31T00:00:00.000Z',
+            rollingUpdateSafe: true,
+            requiredStops: [],
+            minPreviousVersion: null,
+            backfilled: true,
+            syntheticRequiredStop: false,
+        },
+        {
+            version: '1.1.0',
+            previousVersion: '1.0.0',
+            releaseDate: '2026-08-01T00:00:00.000Z',
+            rollingUpdateSafe: true,
+            requiredStops: [],
+            minPreviousVersion: null,
+            backfilled: true,
+            syntheticRequiredStop: false,
+        },
+        {
+            version: '1.2.0',
+            previousVersion: '1.1.0',
+            releaseDate: '2026-08-02T00:00:00.000Z',
+            rollingUpdateSafe: true,
+            requiredStops: [],
+            minPreviousVersion: null,
+            backfilled: true,
+            syntheticRequiredStop: false,
+        },
+        {
+            version: '1.3.0',
+            previousVersion: '1.2.0',
+            releaseDate: '2026-08-03T00:00:00.000Z',
+            rollingUpdateSafe: 'unknown',
+            requiredStops: [],
+            minPreviousVersion: null,
+            backfilled: true,
+            syntheticRequiredStop: false,
+        },
+    ],
+};
+describe('composeReleaseSafetySpan', () => {
+    it('composes a safe forward span', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '1.0.0', '1.2.0')).toEqual({
+            verdict: true,
+            safe: true,
+            requiredStops: [],
+            minPreviousVersion: null,
+            coveredVersions: ['1.1.0', '1.2.0'],
+            missingRanges: [],
+        });
+    });
+    it('fails closed for an unknown release', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '1.0.0', '1.3.0')).toMatchObject({ verdict: 'unknown', safe: false });
+    });
+    it('normalizes a reverse span to the same covered edges', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '1.2.0', '1.0.0')).toEqual((0, _1.composeReleaseSafetySpan)(index, '1.0.0', '1.2.0'));
+    });
+    it('fails closed when the target version is absent', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '1.0.0', '1.4.0')).toMatchObject({
+            verdict: 'unknown',
+            safe: false,
+            missingRanges: [
+                { afterVersion: '1.3.0', beforeVersion: '1.4.0' },
+            ],
+        });
+    });
+    it('fails closed across an internal coverage gap', () => {
+        const indexWithGap = {
+            ...index,
+            entries: index.entries.filter((entry) => entry.version !== '1.2.0'),
+        };
+        expect((0, _1.composeReleaseSafetySpan)(indexWithGap, '1.0.0', '1.3.0')).toMatchObject({
+            verdict: 'unknown',
+            safe: false,
+            missingRanges: [{ afterVersion: '1.1.0', beforeVersion: '1.3.0' }],
+        });
+    });
+    it('allows a same-version span when the endpoint is known', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '1.2.0', '1.2.0')).toMatchObject({
+            verdict: true,
+            safe: true,
+            coveredVersions: [],
+            missingRanges: [],
+        });
+    });
+    it('fails closed for an absent same-version endpoint', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '1.4.0', '1.4.0')).toMatchObject({
+            verdict: 'unknown',
+            safe: false,
+            coveredVersions: [],
+            missingRanges: [
+                { afterVersion: '1.4.0', beforeVersion: '1.4.0' },
+            ],
+        });
+    });
+    it('fails closed when a same-version endpoint only appears as a predecessor', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '0.9.0', '0.9.0')).toMatchObject({
+            verdict: 'unknown',
+            safe: false,
+            missingRanges: [
+                { afterVersion: '0.9.0', beforeVersion: '0.9.0' },
+            ],
+        });
+    });
+    it('fails closed when the source endpoint only appears as a predecessor', () => {
+        expect((0, _1.composeReleaseSafetySpan)(index, '0.9.0', '1.0.0')).toMatchObject({
+            verdict: 'unknown',
+            safe: false,
+            missingRanges: [
+                { afterVersion: '0.9.0', beforeVersion: '0.9.0' },
+            ],
+        });
+    });
+    it('applies required stops and minimum versions from the normalized lower endpoint', () => {
+        const constrainedIndex = {
+            ...index,
+            entries: index.entries.map((entry) => entry.version === '1.2.0'
+                ? {
+                    ...entry,
+                    requiredStops: ['1.1.0'],
+                    minPreviousVersion: '1.1.0',
+                }
+                : entry),
+        };
+        const forward = (0, _1.composeReleaseSafetySpan)(constrainedIndex, '1.0.0', '1.2.0');
+        const reverse = (0, _1.composeReleaseSafetySpan)(constrainedIndex, '1.2.0', '1.0.0');
+        expect(forward).toMatchObject({
+            verdict: true,
+            safe: false,
+            requiredStops: ['1.1.0'],
+            minPreviousVersion: '1.1.0',
+        });
+        expect(reverse).toEqual(forward);
+    });
+});
+describe('parseReleaseSafetyIndex', () => {
+    it('strictly rejects invalid versions and additional properties', () => {
+        expect(() => (0, _1.parseReleaseSafetyIndex)({
+            ...index,
+            entries: [{ ...index.entries[0], version: 'v1.1.0' }],
+        })).toThrow('Invalid release-safety index');
+        expect(() => (0, _1.parseReleaseSafetyIndex)({ ...index, unexpected: true })).toThrow('Invalid release-safety index');
+    });
+});

package/dist/releaseSafety/release-safety-index.schema.json

@@ -0,0 +1,69 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "https://lightdash.com/schemas/release-safety-index/v1.json",
+    "title": "Lightdash cumulative release-safety index",
+    "description": "Derived summaries of per-release v2 artifacts. unknown MUST be treated as unsafe. Per-release artifacts remain the source of truth.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "schemaVersion",
+        "generatedAt",
+        "backfillFloorVersion",
+        "entries"
+    ],
+    "properties": {
+        "schemaVersion": { "type": "string", "const": "1" },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "backfillFloorVersion": {
+            "type": ["string", "null"],
+            "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "entries": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                    "version",
+                    "previousVersion",
+                    "releaseDate",
+                    "rollingUpdateSafe",
+                    "requiredStops",
+                    "minPreviousVersion",
+                    "backfilled",
+                    "syntheticRequiredStop"
+                ],
+                "properties": {
+                    "version": {
+                        "type": "string",
+                        "pattern": "^\\d+\\.\\d+\\.\\d+$"
+                    },
+                    "previousVersion": {
+                        "type": ["string", "null"],
+                        "pattern": "^\\d+\\.\\d+\\.\\d+$"
+                    },
+                    "releaseDate": { "type": "string", "format": "date-time" },
+                    "rollingUpdateSafe": {
+                        "oneOf": [
+                            { "type": "boolean" },
+                            { "type": "string", "const": "unknown" }
+                        ]
+                    },
+                    "requiredStops": {
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "pattern": "^\\d+\\.\\d+\\.\\d+$"
+                        }
+                    },
+                    "minPreviousVersion": {
+                        "type": ["string", "null"],
+                        "pattern": "^\\d+\\.\\d+\\.\\d+$"
+                    },
+                    "backfilled": { "type": "boolean" },
+                    "syntheticRequiredStop": { "type": "boolean" }
+                }
+            }
+        }
+    }
+}

package/dist/releaseSafety/version.d.ts

@@ -0,0 +1,3 @@
+export declare function isReleaseVersion(version: string): boolean;
+export declare function compareVersions(left: string, right: string): number;
+//# sourceMappingURL=version.d.ts.map

package/dist/releaseSafety/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/releaseSafety/version.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBnE"}

package/dist/releaseSafety/version.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReleaseVersion = isReleaseVersion;
+exports.compareVersions = compareVersions;
+const RELEASE_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
+function isReleaseVersion(version) {
+    return RELEASE_VERSION_PATTERN.test(version);
+}
+function compareVersions(left, right) {
+    const invalidLeft = !isReleaseVersion(left);
+    const invalidRight = !isReleaseVersion(right);
+    if (invalidLeft || invalidRight) {
+        const invalidSides = [
+            ...(invalidLeft ? [`left=${left}`] : []),
+            ...(invalidRight ? [`right=${right}`] : []),
+        ];
+        throw new Error(`Invalid release version value(s): ${invalidSides.join(', ')}`);
+    }
+    const leftParts = left.split('.').map(Number);
+    const rightParts = right.split('.').map(Number);
+    for (let partIndex = 0; partIndex < 3; partIndex += 1) {
+        const difference = leftParts[partIndex] - rightParts[partIndex];
+        if (difference !== 0) {
+            return difference > 0 ? 1 : -1;
+        }
+    }
+    return 0;
+}

package/dist/releaseSafety/version.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=version.test.d.ts.map

package/dist/releaseSafety/version.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.test.d.ts","sourceRoot":"","sources":["../../src/releaseSafety/version.test.ts"],"names":[],"mappings":""}

package/dist/releaseSafety/version.test.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const version_1 = require("./version");
+(0, vitest_1.describe)('compareVersions', () => {
+    (0, vitest_1.it)('throws on malformed left input', () => {
+        (0, vitest_1.expect)(() => (0, version_1.compareVersions)('1.2', '1.2.3')).toThrowError('Invalid release version value(s): left=1.2');
+    });
+    (0, vitest_1.it)('throws on malformed right input', () => {
+        (0, vitest_1.expect)(() => (0, version_1.compareVersions)('1.2.3', 'bad-right')).toThrowError('Invalid release version value(s): right=bad-right');
+    });
+    (0, vitest_1.it)('throws on malformed both inputs', () => {
+        (0, vitest_1.expect)(() => (0, version_1.compareVersions)('left', 'right')).toThrowError('Invalid release version value(s): left=left, right=right');
+    });
+    vitest_1.it.each([
+        ['1.2.3', '2.0.0', -1],
+        ['1.2.3', '1.2.3', 0],
+        ['2.0.0', '1.2.3', 1],
+    ])('compares %s and %s as %s', (left, right, expected) => {
+        (0, vitest_1.expect)((0, version_1.compareVersions)(left, right)).toBe(expected);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightdash/cli",
-  "version": "1.125.0",
+  "version": "1.127.0",
   "description": "Lightdash CLI tool",
   "license": "MIT",
   "repository": {
@@ -41,8 +41,8 @@
     "unique-names-generator": "4.7.1",
     "uuid": "11.1.1",
     "yaml": "2.8.3",
-    "@lightdash/common": "1.125.0",
-    "@lightdash/warehouses": "1.125.0"
+    "@lightdash/common": "1.127.0",
+    "@lightdash/warehouses": "1.127.0"
   },
   "devDependencies": {
     "@types/inquirer": "8.2.4",