CodeSampleX

Sample

search and load configuration file using cosmiconfig

sha256:26b7509992f940548573383616ac6d1641f47af2e96d95ce95cbd6beb7bc049c

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
1
Signing keys that built it
1
Declared environment linux 24 · ubuntu · glibc 2.39 x64 npm

Verification-run environments

Environment Contract Stages Run
node 22 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1node:22-alpine@sha256:c610fcdfb1d5…
2026-08-23

Case

HOW
Goal
search and load configuration file using cosmiconfig
Packages
Symbols
  • cosmiconfig
  • cosmiconfigSync
Created
2026-08-23T15:50:54Z

Contract

  1. cosmiconfig and cosmiconfigSync return explorer instances with search, load, clearLoadCache, clearSearchCache, and clearCaches methods
  2. default searchStrategy is none which searches only the starting directory without parent directory traversal
  3. searchStrategy project searches upward through parent directories until configuration is found
  4. cosmiconfigSync search with searchStrategy project synchronously searches upward through parent directories
  5. specifying stopDir implicitly sets searchStrategy to global and traverses parent directories up to stopDir
  6. specifying stopDir with searchStrategy project or none throws an error
  7. cosmiconfig load parses YAML configuration files asynchronously
  8. cosmiconfigSync load parses CommonJS configuration files synchronously
  9. cosmiconfig load supports custom loaders for non-standard file extensions
  10. cosmiconfig search returns null when no configuration file is found
  11. cosmiconfig caches loaded configuration and returns fresh copies after clearCaches

Files

  • PROMPT.md
  • csx.json
  • package-lock.json
  • package.json
  • spec.json
  • test/contract.mjs
  • test/fixtures/custom.conf
  • test/fixtures/js-config/sampleapp.config.cjs
  • test/fixtures/json-config/.sampleapprc.json
  • test/fixtures/nested/.sampleapprc.json
  • test/fixtures/yaml-config/.sampleapprc.yaml

Download the source artifact (tar.gz)

Origin Seeder

anonymous