@humanwhocodes/module-importer 1.0.1

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 pkg:npm/%40humanwhocodes/module-importer@1.0.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40humanwhocodes/module-importer@1.0.1
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - runtime: node@22.23.2

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:a67f088aa0fb814c929e11a3ebdc8032971c3853e38720f1cb6ad99aca03405a","constraints":{"executionContext":"node"},"contract":["ModuleImporter resolves relative CommonJS module path to absolute path","ModuleImporter resolves relative ESM module path to absolute path","ModuleImporter imports CommonJS module dynamically with exported members","ModuleImporter imports ESM module dynamically with exported members"],"goal":"verify pkg:npm/%40humanwhocodes/module-importer@1.0.1","kind":"HOW","packages":["pkg:npm/%40humanwhocodes/module-importer@1.0.1"],"schemaVersion":1},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/%40humanwhocodes/module-importer@1.0.1"],"schemaVersion":1,"subject":"pkg:npm/%40humanwhocodes/module-importer@1.0.1","verifierAdapter":"node-typescript@1"}

module.exports = {
  greeting: "hello from cjs",
  compute: (a, b) => a + b
};

export const greeting = "hello from esm";
export const compute = (a, b) => a * b;

const { ModuleImporter } = require("@humanwhocodes/module-importer");

function createImporter(baseDir) {
  return new ModuleImporter(baseDir);
}

module.exports = { createImporter, ModuleImporter };

{
  "name": "module-importer-contract",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "module-importer-contract",
      "version": "1.0.0",
      "dependencies": {
        "@humanwhocodes/module-importer": "1.0.1"
      }
    },
    "node_modules/@humanwhocodes/module-importer": {
      "version": "1.0.1",
      "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz",
      "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==",
      "license": "Apache-2.0",
      "engines": {
        "node": ">=12.22"
      },
      "funding": {
        "type": "github",
        "url": "https://github.com/sponsors/nzakas"
      }
    }
  }
}

{
  "name": "module-importer-contract",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification sample for @humanwhocodes/module-importer",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "@humanwhocodes/module-importer": "1.0.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/%40humanwhocodes/module-importer@1.0.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40humanwhocodes/module-importer@1.0.1"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "runtime": "node@22.23.2"
  }
}

const assert = require("assert");
const path = require("path");
const { ModuleImporter } = require("@humanwhocodes/module-importer");

async function main() {
  const baseDir = path.resolve(__dirname, "../fixtures");
  const importer = new ModuleImporter(baseDir);

  // 1. Resolve CommonJS module
  const cjsResolved = importer.resolve("./target.cjs");
  assert.strictEqual(typeof cjsResolved, "string", "resolve should return a string path");
  assert(cjsResolved.endsWith("target.cjs"), "resolved path should end with target.cjs");

  // 2. Import CommonJS module
  const cjsMod = await importer.import("./target.cjs");
  assert(cjsMod, "imported cjs module should exist");
  assert(cjsMod.default, "cjs module default export should exist");
  assert.strictEqual(cjsMod.default.greeting, "hello from cjs", "cjs greeting should match");
  assert.strictEqual(cjsMod.default.compute(2, 3), 5, "cjs compute should match");

  // 3. Resolve ESM module
  const esmResolved = importer.resolve("./target.mjs");
  assert.strictEqual(typeof esmResolved, "string", "resolve should return a string path");
  assert(esmResolved.endsWith("target.mjs"), "resolved path should end with target.mjs");

  // 4. Import ESM module
  const esmMod = await importer.import("./target.mjs");
  assert(esmMod, "imported esm module should exist");
  assert.strictEqual(esmMod.greeting, "hello from esm", "esm greeting should match");
  assert.strictEqual(esmMod.compute(2, 3), 6, "esm compute should match");

  console.log("Contract verified successfully.");
}

main().catch((err) => {
  console.error("Contract test failed:", err);
  process.exit(1);
});