node-releases 2.0.56: length

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify node-releases.length in pkg:npm/node-releases@2.0.56
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/node-releases@2.0.56
Demonstrate these symbols/APIs:
  - node-releases.length

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:0ce6f0b485774f51f7a99783bcaa342b5d520ce2054bccbca0d930ba13311080","constraints":{"executionContext":"node"},"contract":["bare import or require of node-releases fails with ERR_MODULE_NOT_FOUND or MODULE_NOT_FOUND because no root entrypoint is exported","importing node-releases/data/processed/envs.json provides an array where length is a positive integer greater than 300","envs.length exactly matches the count of Node.js release metadata records in node-releases@2.0.56","filtering envs by LTS release status yields a non-empty array whose length reflects all LTS releases","filtering envs by security release flag yields a non-empty array whose length reflects all security patch releases","Object.keys length of release-schedule.json reflects all tracked major release version branches"],"goal":"verify node-releases.length in pkg:npm/node-releases@2.0.56","kind":"HOW","packages":["pkg:npm/node-releases@2.0.56"],"schemaVersion":1,"symbols":["node-releases.length"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"esm","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/node-releases@2.0.56"],"schemaVersion":1,"subject":"pkg:npm/node-releases@2.0.56","symbols":["node-releases.length"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-node-releases",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-node-releases",
      "version": "1.0.0",
      "dependencies": {
        "node-releases": "2.0.56"
      }
    },
    "node_modules/node-releases": {
      "version": "2.0.56",
      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.56.tgz",
      "integrity": "sha512-x0InOIyzgdk+eyaWaRJFH5snEtiImgBgblZ2CyPrLmqqcuMQkEvcDPHbzqbD8eDsSeJbVOjn+crzyzHaM4D+/A==",
      "license": "MIT",
      "engines": {
        "node": ">=18"
      }
    }
  }
}

{
  "name": "sample-node-releases",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "dependencies": {
    "node-releases": "2.0.56"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify node-releases.length in pkg:npm/node-releases@2.0.56",
  "kind": "HOW",
  "packages": [
    "pkg:npm/node-releases@2.0.56"
  ],
  "symbols": [
    "node-releases.length"
  ]
}

import assert from 'node:assert/strict';
import { createRequire } from 'node:module';
import envs from 'node-releases/data/processed/envs.json' with { type: 'json' };
import schedule from 'node-releases/data/release-schedule/release-schedule.json' with { type: 'json' };

// 1. bare import or require of node-releases fails with ERR_MODULE_NOT_FOUND or MODULE_NOT_FOUND because no root entrypoint is exported
await assert.rejects(
  () => import('node-releases'),
  (err) => err.code === 'ERR_MODULE_NOT_FOUND' || err.code === 'MODULE_NOT_FOUND'
);

const require = createRequire(import.meta.url);
assert.throws(
  () => require('node-releases'),
  (err) => err.code === 'MODULE_NOT_FOUND'
);

// 2. importing node-releases/data/processed/envs.json provides an array where length is a positive integer greater than 300
assert.ok(Array.isArray(envs));
assert.equal(typeof envs.length, 'number');
assert.ok(Number.isInteger(envs.length));
assert.ok(envs.length > 300);

// 3. envs.length exactly matches the count of Node.js release metadata records in node-releases@2.0.56
assert.equal(envs.length, 378);
assert.equal(envs[0].version, '0.2.0');
assert.equal(envs[envs.length - 1].version, '26.9.0');

// 4. filtering envs by LTS release status yields a non-empty array whose length reflects all LTS releases
const ltsReleases = envs.filter((entry) => entry.lts !== false);
assert.ok(ltsReleases.length > 0);
assert.ok(ltsReleases.length < envs.length);
assert.ok(ltsReleases.every((entry) => typeof entry.lts === 'string'));

// 5. filtering envs by security release flag yields a non-empty array whose length reflects all security patch releases
const securityReleases = envs.filter((entry) => entry.security === true);
assert.ok(securityReleases.length > 0);
assert.ok(securityReleases.length < envs.length);
assert.ok(securityReleases.every((entry) => entry.security === true));

// 6. Object.keys length of release-schedule.json reflects all tracked major release version branches
assert.ok(typeof schedule === 'object' && schedule !== null && !Array.isArray(schedule));
const scheduleKeys = Object.keys(schedule);
assert.ok(scheduleKeys.length > 20);
assert.equal(scheduleKeys.length, 27);
assert.ok(scheduleKeys.includes('v20'));
assert.ok(scheduleKeys.includes('v22'));