parent-module 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/parent-module@1.0.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/parent-module@1.0.1

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:863d42d6b2a8badde72c7d97c73ee4dfaa1e7f954e1b3eaaf57e98d9d8e0aae7","contract":["parentModule resolves the calling module file URL when called without arguments in ESM","parentModule walks call stack to find the parent of a specified module file URL","parentModule returns undefined when the specified filepath is not present in the call stack","parentModule resolves the calling module filesystem path in CommonJS context","parentModule with filepath argument resolves parent of specified CJS module","direct invocation of parentModule in top-level script resolves to process entry or caller"],"goal":"verify pkg:npm/parent-module@1.0.1","kind":"HOW","packages":["pkg:npm/parent-module@1.0.1"],"schemaVersion":1},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/parent-module@1.0.1"],"schemaVersion":1,"subject":"pkg:npm/parent-module@1.0.1","verifierAdapter":"node-typescript@1"}

{
  "name": "sample-parent-module",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-parent-module",
      "version": "1.0.0",
      "dependencies": {
        "parent-module": "1.0.1"
      }
    },
    "node_modules/callsites": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
      "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
      "license": "MIT",
      "engines": {
        "node": ">=6"
      }
    },
    "node_modules/parent-module": {
      "version": "1.0.1",
      "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
      "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
      "license": "MIT",
      "dependencies": {
        "callsites": "^3.0.0"
      },
      "engines": {
        "node": ">=6"
      }
    }
  }
}

{
  "name": "sample-parent-module",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "dependencies": {
    "parent-module": "1.0.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/parent-module@1.0.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/parent-module@1.0.1"
  ]
}

import assert from 'node:assert/strict';
import { createRequire } from 'node:module';
import path from 'node:path';
import { pathToFileURL } from 'node:url';
import parentModule from 'parent-module';
import { callLeaf, callLeafWithFilepath } from './fixtures/intermediate.mjs';

const require = createRequire(import.meta.url);
const { callCjsLeaf, callCjsLeafWithFilepath } = require('./fixtures/cjs-intermediate.cjs');

// 1. parentModule resolves the calling module file URL when called without arguments in ESM
{
  const caller = callLeaf();
  const expectedCaller = pathToFileURL(path.resolve('test/fixtures/intermediate.mjs')).href;
  assert.equal(caller, expectedCaller);
}

// 2. parentModule walks call stack to find the parent of a specified module file URL
{
  const intermediateUrl = pathToFileURL(path.resolve('test/fixtures/intermediate.mjs')).href;
  const currentUrl = import.meta.url;
  const parentOfIntermediate = callLeafWithFilepath(intermediateUrl);
  assert.equal(parentOfIntermediate, currentUrl);
}

// 3. parentModule returns undefined when the specified filepath is not present in the call stack
{
  const notFound = callLeafWithFilepath('file:///nonexistent/file.mjs');
  assert.equal(notFound, undefined);
}

// 4. parentModule resolves the calling module filesystem path in CommonJS context
{
  const cjsCaller = callCjsLeaf();
  const expectedCjsCaller = path.resolve('test/fixtures/cjs-intermediate.cjs');
  assert.equal(cjsCaller, expectedCjsCaller);
}

// 5. parentModule with filepath argument resolves parent of specified CJS module
{
  const intermediatePath = path.resolve('test/fixtures/cjs-intermediate.cjs');
  const currentUrl = import.meta.url;
  const parentOfCjsIntermediate = callCjsLeafWithFilepath(intermediatePath);
  assert.equal(parentOfCjsIntermediate, currentUrl);
}

// 6. direct invocation of parentModule in top-level script resolves to process entry or caller
{
  function localWrapper() {
    return parentModule();
  }
  const topCaller = localWrapper();
  assert.equal(typeof topCaller, 'string');
  assert.ok(topCaller.length > 0);
}

'use strict';
const getCjsCaller = require('./cjs-leaf.cjs');

module.exports = {
  callCjsLeaf: function () {
    return getCjsCaller();
  },
  callCjsLeafWithFilepath: function (filepath) {
    return getCjsCaller(filepath);
  },
};

'use strict';
const parentModule = require('parent-module');

module.exports = function getCjsCaller(filepath) {
  return parentModule(filepath);
};

import { getCaller } from './leaf.mjs';

export function callLeaf() {
  return getCaller();
}

export function callLeafWithFilepath(filepath) {
  return getCaller(filepath);
}

import parentModule from 'parent-module';

export function getCaller(filepath) {
  return parentModule(filepath);
}