npm - declapract-typescript-ehmpathy - Versions diffs - 0.49.9 → 0.49.11 - Mend

@@ -0,0 +1,108 @@
+import fs from 'fs/promises';
+import path from 'node:path';
+import { executeApply } from 'declapract';
+import { genTempDir, given, then, useBeforeAll, when } from 'test-fns';
+// executeApply is slow (90+ seconds per invocation due to full practice evaluation)
+jest.setTimeout(180_000); // 3 minutes
+/**
+ * .what = acceptance test for cache practice with .ifInstalled() modifier
+ * .why = verifies that minVersion().ifInstalled() correctly:
+ *        - skips check when package is not installed
+ *        - flags outdated versions when package IS installed
+ *        - passes when package is at or above minimum version
+ */
+describe('cache practice with ifInstalled', () => {
+  given('[case1] repo WITHOUT cache package installed', () => {
+    const tempDir = genTempDir({
+      slug: 'cache-not-installed',
+      clone: './src/practices/cache/.test/assets/repo-without-cache-package',
+      symlink: [
+        { at: 'declarations', to: './src/.test/assets/cache/declarations' },
+        { at: 'node_modules', to: 'node_modules' },
+      ],
+    });
+    // run executeApply before assertions
+    useBeforeAll(async () => {
+      await executeApply({
+        config: path.join(tempDir, 'declapract.use.yml'),
+        practice: 'cache',
+      });
+    }, 120_000); // 2 min timeout
+    when('[t0] after declapract apply', () => {
+      then('package.json is unchanged (ifInstalled skips absent packages)', async () => {
+        const packageJson = JSON.parse(
+          await fs.readFile(path.join(tempDir, 'package.json'), 'utf-8'),
+        );
+        // should NOT have added cache packages since they were absent
+        expect(packageJson.dependencies['simple-in-memory-cache']).toBeUndefined();
+        expect(packageJson.dependencies['simple-on-disk-cache']).toBeUndefined();
+        expect(packageJson.dependencies['with-simple-cache']).toBeUndefined();
+        // original dependency should still be there
+        expect(packageJson.dependencies.lodash).toBe('4.17.21');
+      });
+    });
+  });
+  given('[case2] repo WITH outdated cache package', () => {
+    const tempDir = genTempDir({
+      slug: 'cache-outdated',
+      clone: './src/practices/cache/.test/assets/repo-with-old-cache-package',
+      symlink: [
+        { at: 'declarations', to: './src/.test/assets/cache/declarations' },
+        { at: 'node_modules', to: 'node_modules' },
+      ],
+    });
+    // run executeApply before assertions
+    useBeforeAll(async () => {
+      await executeApply({
+        config: path.join(tempDir, 'declapract.use.yml'),
+        practice: 'cache',
+      });
+    }, 120_000); // 2 min timeout
+    when('[t0] after declapract apply', () => {
+      then('package.json has version upgraded to minimum', async () => {
+        const packageJson = JSON.parse(
+          await fs.readFile(path.join(tempDir, 'package.json'), 'utf-8'),
+        );
+        // should have upgraded from 0.3.0 to 0.4.3
+        expect(packageJson.dependencies['simple-in-memory-cache']).toBe('0.4.3');
+      });
+    });
+  });
+  given('[case3] repo WITH valid cache package version', () => {
+    const tempDir = genTempDir({
+      slug: 'cache-valid',
+      clone: './src/practices/cache/.test/assets/repo-with-valid-cache-package',
+      symlink: [
+        { at: 'declarations', to: './src/.test/assets/cache/declarations' },
+        { at: 'node_modules', to: 'node_modules' },
+      ],
+    });
+    // run executeApply before assertions
+    useBeforeAll(async () => {
+      await executeApply({
+        config: path.join(tempDir, 'declapract.use.yml'),
+        practice: 'cache',
+      });
+    }, 120_000); // 2 min timeout
+    when('[t0] after declapract apply', () => {
+      then('package.json version is unchanged (already at minimum)', async () => {
+        const packageJson = JSON.parse(
+          await fs.readFile(path.join(tempDir, 'package.json'), 'utf-8'),
+        );
+        // should still be 0.4.3 (unchanged, already valid)
+        expect(packageJson.dependencies['simple-in-memory-cache']).toBe('0.4.3');
+      });
+    });
+  });
+});

@@ -0,0 +1,6 @@
+# .note = declarations dir is symlinked by the test (contains declapract.declare.yml + dist/)
+declarations: 'declarations/declapract.declare.yml'
+useCase: typescript-project
+variables:
+  organizationName: 'test-org'
+  projectName: 'test-project-old-cache'

@@ -0,0 +1,7 @@
+{
+  "name": "test-project-old-cache",
+  "version": "1.0.0",
+  "dependencies": {
+    "simple-in-memory-cache": "0.3.0"
+  }
+}

@@ -0,0 +1,6 @@
+# .note = declarations dir is symlinked by the test (contains declapract.declare.yml + dist/)
+declarations: 'declarations/declapract.declare.yml'
+useCase: typescript-project
+variables:
+  organizationName: 'test-org'
+  projectName: 'test-project-valid-cache'

@@ -0,0 +1,7 @@
+{
+  "dependencies": {
+    "simple-in-memory-cache": "@declapract{check.minVersion('0.4.3').ifInstalled()}",
+    "simple-on-disk-cache": "@declapract{check.minVersion('1.7.11').ifInstalled()}",
+    "with-simple-cache": "@declapract{check.minVersion('0.16.2').ifInstalled()}"
+  }
+}

@@ -0,0 +1,5 @@
+# minimal use case for cache practice integration test
+use-cases:
+  typescript-project:
+    practices:
+      - cache

declapract-typescript-ehmpathy 0.49.9 → 0.49.11