@seorii/libcollect 0.1.0 → 1.0.0

package/include-deps.test.mjs

@@ -0,0 +1,437 @@
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+
+import { includeDependencies } from "./include-deps.mjs";
+
+function cloneJson(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+function createRegistryMeta(name, version, extra = {}) {
+  return {
+    name,
+    version,
+    dependencies: {},
+    peerDependencies: {},
+    optionalDependencies: {},
+    ...extra,
+  };
+}
+
+async function withMockedFetch(packageMetas, fn) {
+  const originalFetch = globalThis.fetch;
+
+  globalThis.fetch = async function mockedFetch(url) {
+    const name = decodeURIComponent(new URL(url).pathname.slice(1));
+    const entry = packageMetas[name];
+    const meta = Array.isArray(entry) ? entry.shift() : entry;
+
+    if (meta instanceof Error) {
+      throw meta;
+    }
+
+    if (!meta) {
+      return {
+        ok: false,
+        status: 404,
+        async json() {
+          return { error: "not found" };
+        },
+      };
+    }
+
+    if (typeof meta === "object" && (typeof meta.ok === "boolean" || typeof meta.status === "number")) {
+      const status = meta.status ?? (meta.ok ? 200 : 500);
+      return {
+        ok: meta.ok ?? (status >= 200 && status < 300),
+        status,
+        async json() {
+          return cloneJson(meta.body || {});
+        },
+      };
+    }
+
+    return {
+      ok: true,
+      async json() {
+        return cloneJson(meta);
+      },
+    };
+  };
+
+  try {
+    return await fn();
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+}
+
+async function withImmediateTimers(fn) {
+  const originalSetTimeout = globalThis.setTimeout;
+  const delays = [];
+
+  globalThis.setTimeout = (callback, delay = 0, ...args) => {
+    delays.push(delay);
+    callback(...args);
+    return 0;
+  };
+
+  try {
+    return await fn(delays);
+  } finally {
+    globalThis.setTimeout = originalSetTimeout;
+  }
+}
+
+async function createFixturePackage(packageJson) {
+  const fixtureDir = await fs.mkdtemp(path.join(os.tmpdir(), "libcollect-"));
+  const packageJsonPath = path.join(fixtureDir, "package.json");
+  await fs.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf8");
+  return { fixtureDir, packageJsonPath };
+}
+
+test("includeDependencies resolves mixed dist-tag and semver disjunctions", async () => {
+  const { packageJsonPath } = await createFixturePackage({
+    name: "fixture-app",
+    version: "1.0.0",
+    dependencies: {
+      "fixture-root": "^1.0.0",
+    },
+    libcollect: {
+      sourceSections: ["dependencies"],
+      includeDependencyTypes: ["optionalDependency"],
+      concurrency: 1,
+      exactVersions: true,
+      autoIncludedDependencies: [],
+      autoIncludedDependencySpecs: {},
+    },
+  });
+
+  const progressLogs = [];
+
+  await withMockedFetch(
+    {
+      "fixture-root": {
+        "dist-tags": {
+          latest: "1.0.0",
+        },
+        versions: {
+          "1.0.0": createRegistryMeta("fixture-root", "1.0.0", {
+            optionalDependencies: {
+              tailwindcss: ">=3.0.0 || insiders || >=4.0.0-alpha.20 || >=4.0.0-beta.1",
+            },
+          }),
+        },
+      },
+      tailwindcss: {
+        "dist-tags": {
+          latest: "4.2.2",
+          insiders: "4.0.0-beta.1",
+        },
+        versions: {
+          "3.4.17": createRegistryMeta("tailwindcss", "3.4.17"),
+          "4.0.0-alpha.20": createRegistryMeta("tailwindcss", "4.0.0-alpha.20"),
+          "4.0.0-beta.1": createRegistryMeta("tailwindcss", "4.0.0-beta.1"),
+          "4.2.2": createRegistryMeta("tailwindcss", "4.2.2"),
+        },
+      },
+    },
+    async () => {
+      const result = await includeDependencies(packageJsonPath, {
+        logger(message) {
+          progressLogs.push(message);
+        },
+      });
+
+      assert.equal(result.autoIncludedCount, 1);
+    },
+  );
+
+  const updatedPackage = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  assert.equal(updatedPackage.dependencies["fixture-root"], "^1.0.0");
+  assert.equal(updatedPackage.dependencies.tailwindcss, "4.2.2");
+  assert.ok(progressLogs.some((entry) => entry.includes("collecting dependency graph")));
+  assert.ok(progressLogs.some((entry) => entry.includes("writing updated package.json")));
+});
+
+test("includeDependencies defaults concurrency to 50 when config omits it", async () => {
+  const { packageJsonPath } = await createFixturePackage({
+    name: "fixture-app",
+    version: "1.0.0",
+    dependencies: {
+      "fixture-root": "^1.0.0",
+    },
+    libcollect: {
+      sourceSections: ["dependencies"],
+      includeDependencyTypes: ["optionalDependency"],
+      exactVersions: true,
+      autoIncludedDependencies: [],
+      autoIncludedDependencySpecs: {},
+    },
+  });
+
+  await withMockedFetch(
+    {
+      "fixture-root": {
+        "dist-tags": {
+          latest: "1.0.0",
+        },
+        versions: {
+          "1.0.0": createRegistryMeta("fixture-root", "1.0.0"),
+        },
+      },
+    },
+    async () => {
+      await includeDependencies(packageJsonPath);
+    },
+  );
+
+  const updatedPackage = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  assert.equal(updatedPackage.libcollect.concurrency, 50);
+});
+
+test("includeDependencies retries failed HTTP responses with exponential backoff", async () => {
+  const { packageJsonPath } = await createFixturePackage({
+    name: "fixture-app",
+    version: "1.0.0",
+    dependencies: {
+      "fixture-root": "^1.0.0",
+    },
+    libcollect: {
+      sourceSections: ["dependencies"],
+      includeDependencyTypes: ["optionalDependency"],
+      exactVersions: true,
+      autoIncludedDependencies: [],
+      autoIncludedDependencySpecs: {},
+    },
+  });
+
+  const progressLogs = [];
+
+  await withImmediateTimers(async (delays) => {
+    await withMockedFetch(
+      {
+        "fixture-root": [
+          { ok: false, status: 500, body: {} },
+          { ok: false, status: 500, body: {} },
+          {
+            "dist-tags": {
+              latest: "1.0.0",
+            },
+            versions: {
+              "1.0.0": createRegistryMeta("fixture-root", "1.0.0"),
+            },
+          },
+        ],
+      },
+      async () => {
+        const result = await includeDependencies(packageJsonPath, {
+          logger(message) {
+            progressLogs.push(message);
+          },
+        });
+
+        assert.equal(result.autoIncludedCount, 0);
+      },
+    );
+
+    assert.deepEqual(delays, [250, 500]);
+  });
+
+  assert.equal(progressLogs.filter((entry) => entry.includes("HTTP 500")).length, 2);
+});
+
+test("includeDependencies retries thrown fetch errors with exponential backoff", async () => {
+  const { packageJsonPath } = await createFixturePackage({
+    name: "fixture-app",
+    version: "1.0.0",
+    dependencies: {
+      "fixture-root": "^1.0.0",
+    },
+    libcollect: {
+      sourceSections: ["dependencies"],
+      includeDependencyTypes: ["optionalDependency"],
+      exactVersions: true,
+      autoIncludedDependencies: [],
+      autoIncludedDependencySpecs: {},
+    },
+  });
+
+  const progressLogs = [];
+
+  await withImmediateTimers(async (delays) => {
+    await withMockedFetch(
+      {
+        "fixture-root": [
+          new TypeError("fetch failed"),
+          new Error("socket hang up"),
+          {
+            "dist-tags": {
+              latest: "1.0.0",
+            },
+            versions: {
+              "1.0.0": createRegistryMeta("fixture-root", "1.0.0"),
+            },
+          },
+        ],
+      },
+      async () => {
+        const result = await includeDependencies(packageJsonPath, {
+          logger(message) {
+            progressLogs.push(message);
+          },
+        });
+
+        assert.equal(result.autoIncludedCount, 0);
+      },
+    );
+
+    assert.deepEqual(delays, [250, 500]);
+  });
+
+  assert.ok(progressLogs.some((entry) => entry.includes("fetch failed")));
+  assert.ok(progressLogs.some((entry) => entry.includes("socket hang up")));
+});
+
+test("includeDependencies falls back missing nightly optional dependencies without dropping sibling deps", async () => {
+  const { packageJsonPath } = await createFixturePackage({
+    name: "fixture-app",
+    version: "1.0.0",
+    dependencies: {
+      "fixture-root": "^1.0.0",
+    },
+    libcollect: {
+      sourceSections: ["dependencies"],
+      includeDependencyTypes: ["optionalDependency"],
+      exactVersions: true,
+      autoIncludedDependencies: [],
+      autoIncludedDependencySpecs: {},
+    },
+  });
+
+  let result;
+
+  await withMockedFetch(
+    {
+      "fixture-root": {
+        "dist-tags": {
+          latest: "1.0.0",
+        },
+        versions: {
+          "1.0.0": createRegistryMeta("fixture-root", "1.0.0", {
+            optionalDependencies: {
+              "react-native-worklets": "0.9.0-nightly-20260401-430b7c2f5",
+              tailwindcss: "^4.2.2",
+            },
+          }),
+        },
+      },
+      "react-native-worklets": {
+        "dist-tags": {
+          latest: "0.8.1",
+          nightly: "0.9.0-nightly-20260331-651c56393",
+        },
+        versions: {
+          "0.8.1": createRegistryMeta("react-native-worklets", "0.8.1"),
+          "0.9.0-nightly-20260331-651c56393": createRegistryMeta(
+            "react-native-worklets",
+            "0.9.0-nightly-20260331-651c56393",
+          ),
+        },
+      },
+      tailwindcss: {
+        "dist-tags": {
+          latest: "4.2.2",
+        },
+        versions: {
+          "4.2.2": createRegistryMeta("tailwindcss", "4.2.2"),
+        },
+      },
+    },
+    async () => {
+      result = await includeDependencies(packageJsonPath);
+    },
+  );
+
+  const updatedPackage = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  assert.equal(updatedPackage.dependencies["fixture-root"], "^1.0.0");
+  assert.equal(updatedPackage.dependencies.tailwindcss, "4.2.2");
+  assert.equal(
+    updatedPackage.dependencies["react-native-worklets"],
+    "0.9.0-nightly-20260331-651c56393",
+  );
+  assert.ok(
+    result.warnings.some((warning) =>
+      warning.includes("react-native-worklets") && warning.includes("nearest published"),
+    ),
+  );
+});
+
+test("includeDependencies falls back to nearest published nightly prerelease when exact snapshot is gone", async () => {
+  const { packageJsonPath } = await createFixturePackage({
+    name: "fixture-app",
+    version: "1.0.0",
+    dependencies: {
+      "fixture-root": "^1.0.0",
+    },
+    libcollect: {
+      sourceSections: ["dependencies"],
+      includeDependencyTypes: ["optionalDependency"],
+      exactVersions: true,
+      autoIncludedDependencies: [],
+      autoIncludedDependencySpecs: {},
+    },
+  });
+
+  const warnings = [];
+
+  await withMockedFetch(
+    {
+      "fixture-root": {
+        "dist-tags": {
+          latest: "1.0.0",
+        },
+        versions: {
+          "1.0.0": createRegistryMeta("fixture-root", "1.0.0", {
+            optionalDependencies: {
+              "react-native-worklets": "0.9.0-nightly-20260401-430b7c2f5",
+            },
+          }),
+        },
+      },
+      "react-native-worklets": {
+        "dist-tags": {
+          latest: "0.8.1",
+          nightly: "0.9.0-nightly-20260331-651c56393",
+        },
+        versions: {
+          "0.8.1": createRegistryMeta("react-native-worklets", "0.8.1"),
+          "0.9.0-nightly-20260329-941d1eb01": createRegistryMeta(
+            "react-native-worklets",
+            "0.9.0-nightly-20260329-941d1eb01",
+          ),
+          "0.9.0-nightly-20260331-651c56393": createRegistryMeta(
+            "react-native-worklets",
+            "0.9.0-nightly-20260331-651c56393",
+          ),
+        },
+      },
+    },
+    async () => {
+      const result = await includeDependencies(packageJsonPath);
+      warnings.push(...result.warnings);
+      assert.equal(result.autoIncludedCount, 1);
+    },
+  );
+
+  const updatedPackage = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  assert.equal(
+    updatedPackage.dependencies["react-native-worklets"],
+    "0.9.0-nightly-20260331-651c56393",
+  );
+  assert.ok(warnings.some((entry) => entry.includes("react-native-worklets")));
+  assert.ok(warnings.some((entry) => entry.includes("nearest published")));
+});