locate-path 6.0.0: locatePathSync

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 locatePathSync in pkg:npm/locate-path@6.0.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/locate-path@6.0.0
Demonstrate these symbols/APIs:
  - locatePathSync

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:e2ec1836df1ce8c6780d262a6874234bb95a928aeec4251851d30f533dc60122","contract":["locatePath.sync returns the first existing file in candidate paths","locatePath.sync returns undefined when none of the candidate files exist","locatePath.sync resolves directory when type option is set to directory","locatePath.sync supports custom cwd option","locatePath.sync ignores symlinks when allowSymlinks option is false","locatePath.sync throws an error when an invalid type option is passed","findFirstExistingPathSync helper returns the first existing path synchronously","findFirstExistingDirectorySync helper returns the directory path","locatePathSync exported alias matches locatePath.sync"],"goal":"verify locatePathSync in pkg:npm/locate-path@6.0.0","kind":"HOW","packages":["pkg:npm/locate-path@6.0.0"],"schemaVersion":1,"symbols":["locatePathSync"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/locate-path@6.0.0"],"schemaVersion":1,"subject":"pkg:npm/locate-path@6.0.0","symbols":["locatePathSync"],"verifierAdapter":"node-typescript@1"}

'use strict';

const locatePath = require('locate-path');

function findFirstExistingPathSync(paths, options) {
  return locatePath.sync(paths, options);
}

function findFirstExistingFileSync(paths, options) {
  return locatePath.sync(paths, { ...options, type: 'file' });
}

function findFirstExistingDirectorySync(paths, options) {
  return locatePath.sync(paths, { ...options, type: 'directory' });
}

module.exports = {
  findFirstExistingPathSync,
  findFirstExistingFileSync,
  findFirstExistingDirectorySync,
  locatePathSync: locatePath.sync
};

{
  "name": "sample-locate-path-sync",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-locate-path-sync",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "locate-path": "6.0.0"
      }
    },
    "node_modules/locate-path": {
      "version": "6.0.0",
      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
      "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==",
      "license": "MIT",
      "dependencies": {
        "p-locate": "^5.0.0"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/p-limit": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
      "license": "MIT",
      "dependencies": {
        "yocto-queue": "^0.1.0"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/p-locate": {
      "version": "5.0.0",
      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz",
      "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==",
      "license": "MIT",
      "dependencies": {
        "p-limit": "^3.0.2"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/yocto-queue": {
      "version": "0.1.0",
      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    }
  }
}

{
  "name": "sample-locate-path-sync",
  "version": "1.0.0",
  "description": "Minimal sample verifying locatePathSync in pkg:npm/locate-path@6.0.0",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "license": "MIT-0",
  "dependencies": {
    "locate-path": "6.0.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify locatePathSync in pkg:npm/locate-path@6.0.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/locate-path@6.0.0"
  ],
  "symbols": [
    "locatePathSync"
  ]
}

import assert from 'node:assert';
import path from 'node:path';
import os from 'node:os';
import fs from 'node:fs';
import { createRequire } from 'node:module';
import locatePath from 'locate-path';

const require = createRequire(import.meta.url);
const {
  findFirstExistingPathSync,
  findFirstExistingFileSync,
  findFirstExistingDirectorySync,
  locatePathSync
} = require('../index.js');

async function runContract() {
  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'locate-path-sync-contract-'));

  try {
    const fileA = path.join(tmpDir, 'file-a.txt');
    const fileB = path.join(tmpDir, 'file-b.txt');
    const subDir = path.join(tmpDir, 'sub-dir');
    const symlinkFile = path.join(tmpDir, 'symlink-file.txt');

    fs.writeFileSync(fileA, 'alpha content');
    fs.writeFileSync(fileB, 'beta content');
    fs.mkdirSync(subDir);
    fs.symlinkSync(fileB, symlinkFile);

    // 1. locatePath.sync returns the first existing file in candidate paths
    const res1 = locatePath.sync(['nonexistent1.txt', 'file-b.txt', 'file-a.txt'], { cwd: tmpDir });
    assert.strictEqual(res1, 'file-b.txt', 'locatePath.sync should return first existing file');

    // 2. locatePath.sync returns undefined when none of the candidate files exist
    const res2 = locatePath.sync(['missing1.txt', 'missing2.txt'], { cwd: tmpDir });
    assert.strictEqual(res2, undefined, 'locatePath.sync should return undefined when none exist');

    // 3. locatePath.sync resolves directory when type option is set to directory
    const res3 = locatePath.sync(['nonexistent.txt', 'sub-dir'], { cwd: tmpDir, type: 'directory' });
    assert.strictEqual(res3, 'sub-dir', 'locatePath.sync should return directory when type is directory');

    // 4. locatePath.sync supports custom cwd option
    const res4 = locatePath.sync(['file-a.txt'], { cwd: tmpDir });
    assert.strictEqual(res4, 'file-a.txt', 'locatePath.sync should resolve relative to custom cwd');

    // 5. locatePath.sync ignores symlinks when allowSymlinks option is false
    const res5 = locatePath.sync(['symlink-file.txt'], { cwd: tmpDir, allowSymlinks: false });
    assert.strictEqual(res5, undefined, 'locatePath.sync should not resolve symlink when allowSymlinks is false');

    // 6. locatePath.sync throws an error when an invalid type option is passed
    assert.throws(
      () => locatePath.sync(['file-a.txt'], { cwd: tmpDir, type: 'invalid' }),
      /Invalid type specified: invalid/,
      'locatePath.sync should throw on invalid type'
    );

    // 7. findFirstExistingPathSync helper returns the first existing path synchronously
    const res7 = findFirstExistingPathSync(['missing.txt', 'file-a.txt'], { cwd: tmpDir });
    assert.strictEqual(res7, 'file-a.txt', 'findFirstExistingPathSync helper should return existing path');

    // 8. findFirstExistingDirectorySync helper returns the directory path
    const res8 = findFirstExistingDirectorySync(['missing.txt', 'sub-dir'], { cwd: tmpDir });
    assert.strictEqual(res8, 'sub-dir', 'findFirstExistingDirectorySync helper should return directory path');

    // 9. locatePathSync exported alias matches locatePath.sync
    assert.strictEqual(locatePathSync, locatePath.sync, 'locatePathSync should alias locatePath.sync');

    console.log('All locatePathSync contract checks passed.');
  } finally {
    fs.rmSync(tmpDir, { recursive: true, force: true });
  }
}

runContract().catch((err) => {
  console.error('Contract failed:', err);
  process.exit(1);
});