parseurl 1.3.3

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/parseurl@1.3.3
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/parseurl@1.3.3

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:977a84a6b6e4731b6f8da9a6f94dc444ce383277710d2116cc2c9777b0db434e","contract":["parseurl(req) parses pathname, search, and query from req.url","parseurl(req) memoizes parsed URL on req._parsedUrl for identical url","parseurl(req) re-parses when req.url is modified","parseurl(req) returns undefined when req.url is undefined","parseurl.original(req) parses req.originalUrl and caches result on req._parsedOriginalUrl","parseurl.original(req) falls back to req.url when originalUrl is not a string"],"goal":"verify pkg:npm/parseurl@1.3.3","kind":"HOW","packages":["pkg:npm/parseurl@1.3.3"],"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/parseurl@1.3.3"],"schemaVersion":1,"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-parseurl",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-parseurl",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "parseurl": "1.3.3"
      }
    },
    "node_modules/parseurl": {
      "version": "1.3.3",
      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
      "license": "MIT",
      "engines": {
        "node": ">= 0.8"
      }
    }
  }
}

{
  "name": "sample-parseurl",
  "version": "1.0.0",
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "parseurl": "1.3.3"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/parseurl@1.3.3",
  "kind": "HOW",
  "packages": [
    "pkg:npm/parseurl@1.3.3"
  ]
}

import assert from 'node:assert/strict';
import { createRequire } from 'node:module';

const require = createRequire(import.meta.url);
const parseurl = require('parseurl');

// 1. Module export verification
assert.equal(typeof parseurl, 'function', 'parseurl must be a function');
assert.equal(typeof parseurl.original, 'function', 'parseurl.original must be a function');

// 2. parseurl(req) parses pathname, search, and query from req.url
const req1 = { url: '/items?sort=desc&page=2' };
const parsed1 = parseurl(req1);
assert.equal(parsed1.pathname, '/items');
assert.equal(parsed1.search, '?sort=desc&page=2');
assert.equal(parsed1.query, 'sort=desc&page=2');
assert.equal(parsed1.path, '/items?sort=desc&page=2');
assert.equal(parsed1.href, '/items?sort=desc&page=2');

// 3. parseurl memoizes the result on req._parsedUrl when URL remains unchanged
assert.equal(req1._parsedUrl, parsed1);
const parsedCached = parseurl(req1);
assert.strictEqual(parsedCached, parsed1);

// 4. parseurl re-parses when req.url changes
req1.url = '/updated-path';
const parsedUpdated = parseurl(req1);
assert.equal(parsedUpdated.pathname, '/updated-path');
assert.notStrictEqual(parsedUpdated, parsed1);

// 5. parseurl returns undefined when req.url is undefined
const reqUndefined = {};
assert.equal(parseurl(reqUndefined), undefined);

// 6. parseurl.original(req) parses req.originalUrl with memoization
const reqOriginal = {
  originalUrl: '/api/v1/resource?active=true',
  url: '/resource'
};
const parsedOrig = parseurl.original(reqOriginal);
assert.equal(parsedOrig.pathname, '/api/v1/resource');
assert.equal(parsedOrig.query, 'active=true');
assert.strictEqual(parseurl.original(reqOriginal), parsedOrig);

// 7. parseurl.original falls back to req.url when originalUrl is not a string
const reqFallback = { url: '/fallback-path' };
const parsedFallback = parseurl.original(reqFallback);
assert.equal(parsedFallback.pathname, '/fallback-path');