statuses 2.0.1: code

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 statuses.code in pkg:npm/statuses@2.0.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/statuses@2.0.1
Demonstrate these symbols/APIs:
  - statuses.code
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - packageManager: npm@10.9.8
  - 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:7c8a528b32e441d8fa68c882dc2c1a3cf6361e45b03470114eaaa007d9b85961","constraints":{"executionContext":"node"},"contract":["statuses.code is an object mapping lower-case HTTP status phrases to numeric codes","statuses.code maps lower-case messages to status codes case-sensitively and returns undefined for upper-case queries","statuses.code maps informational 1xx status messages to status codes","statuses.code maps successful 2xx status messages to status codes","statuses.code maps redirection 3xx status messages to status codes","statuses.code maps client error 4xx status messages to status codes","statuses.code maps server error 5xx status messages to status codes","statuses.code returns undefined for unknown status message strings","every entry in statuses.code has a lower-case key and an integer status code between 100 and 599"],"goal":"verify statuses.code in pkg:npm/statuses@2.0.1","kind":"HOW","packages":["pkg:npm/statuses@2.0.1"],"schemaVersion":1,"symbols":["statuses.code"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","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/statuses@2.0.1"],"schemaVersion":1,"subject":"pkg:npm/statuses@2.0.1","symbols":["statuses.code"],"verifierAdapter":"node-typescript@1"}

const statuses = require('statuses');

/**
 * Direct reference to the status message (lower-case) to numeric code map.
 */
const code = statuses.code;

/**
 * Retrieve status code by message name.
 * @param {string} message
 * @returns {number|undefined}
 */
function getStatusCode(message) {
  if (typeof message !== 'string') {
    return undefined;
  }
  return code[message.toLowerCase()];
}

/**
 * Check whether a message key exists in statuses.code.
 * @param {string} message
 * @returns {boolean}
 */
function hasStatusMessage(message) {
  if (typeof message !== 'string') {
    return false;
  }
  return Object.prototype.hasOwnProperty.call(code, message.toLowerCase());
}

module.exports = {
  statuses,
  code,
  getStatusCode,
  hasStatusMessage,
};

{
  "name": "sample-statuses-code",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-statuses-code",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "statuses": "2.0.1"
      }
    },
    "node_modules/statuses": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
      "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
      "license": "MIT",
      "engines": {
        "node": ">= 0.8"
      }
    }
  }
}

{
  "name": "sample-statuses-code",
  "version": "1.0.0",
  "description": "Minimal clean-room sample verifying statuses.code in statuses",
  "main": "index.js",
  "license": "MIT-0",
  "dependencies": {
    "statuses": "2.0.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify statuses.code in pkg:npm/statuses@2.0.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/statuses@2.0.1"
  ],
  "symbols": [
    "statuses.code"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "packageManager": "npm@10.9.8",
    "runtime": "node@22.23.2"
  }
}

import assert from 'node:assert';
import statuses from 'statuses';
import {
  code,
  getStatusCode,
  hasStatusMessage,
} from '../index.js';

// 1. statuses.code is an object mapping lower-case HTTP status phrases to numeric codes
assert.strictEqual(typeof statuses.code, 'object', 'statuses.code must be an object');
assert.strictEqual(code, statuses.code, 'exported code must reference statuses.code');
assert.strictEqual(statuses.code['ok'], 200, 'statuses.code["ok"] must be 200');
assert.strictEqual(statuses.code['not found'], 404, 'statuses.code["not found"] must be 404');
assert.strictEqual(getStatusCode('ok'), 200, 'getStatusCode("ok") must return 200');

// 2. statuses.code maps lower-case messages to status codes case-sensitively and returns undefined for upper-case queries
assert.strictEqual(statuses.code['Not Found'], undefined, 'Upper case status lookup must return undefined');
assert.strictEqual(statuses.code['OK'], undefined, 'Upper case OK must return undefined');
assert.strictEqual(hasStatusMessage('Not Found'), true, 'hasStatusMessage should normalize case');
assert.strictEqual(hasStatusMessage('unknown'), false, 'hasStatusMessage for non-existent status should be false');

// 3. statuses.code maps informational 1xx status messages to status codes
assert.strictEqual(statuses.code['continue'], 100, 'continue must map to 100');
assert.strictEqual(statuses.code['switching protocols'], 101, 'switching protocols must map to 101');

// 4. statuses.code maps successful 2xx status messages to status codes
assert.strictEqual(statuses.code['ok'], 200, 'ok must map to 200');
assert.strictEqual(statuses.code['created'], 201, 'created must map to 201');
assert.strictEqual(statuses.code['accepted'], 202, 'accepted must map to 202');
assert.strictEqual(statuses.code['no content'], 204, 'no content must map to 204');

// 5. statuses.code maps redirection 3xx status messages to status codes
assert.strictEqual(statuses.code['multiple choices'], 300, 'multiple choices must map to 300');
assert.strictEqual(statuses.code['moved permanently'], 301, 'moved permanently must map to 301');
assert.strictEqual(statuses.code['found'], 302, 'found must map to 302');
assert.strictEqual(statuses.code['see other'], 303, 'see other must map to 303');
assert.strictEqual(statuses.code['not modified'], 304, 'not modified must map to 304');

// 6. statuses.code maps client error 4xx status messages to status codes
assert.strictEqual(statuses.code['bad request'], 400, 'bad request must map to 400');
assert.strictEqual(statuses.code['unauthorized'], 401, 'unauthorized must map to 401');
assert.strictEqual(statuses.code['forbidden'], 403, 'forbidden must map to 403');
assert.strictEqual(statuses.code['not found'], 404, 'not found must map to 404');
assert.strictEqual(statuses.code['method not allowed'], 405, 'method not allowed must map to 405');

// 7. statuses.code maps server error 5xx status messages to status codes
assert.strictEqual(statuses.code['internal server error'], 500, 'internal server error must map to 500');
assert.strictEqual(statuses.code['not implemented'], 501, 'not implemented must map to 501');
assert.strictEqual(statuses.code['bad gateway'], 502, 'bad gateway must map to 502');
assert.strictEqual(statuses.code['service unavailable'], 503, 'service unavailable must map to 503');
assert.strictEqual(statuses.code['gateway timeout'], 504, 'gateway timeout must map to 504');

// 8. statuses.code returns undefined for unknown status message strings
assert.strictEqual(statuses.code['non-existent status message'], undefined, 'unknown status must return undefined');
assert.strictEqual(statuses.code['custom application error'], undefined, 'custom error must return undefined');

// 9. every entry in statuses.code has a lower-case key and an integer status code between 100 and 599
const entries = Object.entries(statuses.code);
assert(entries.length > 0, 'statuses.code must contain entries');
for (const [message, statusCode] of entries) {
  assert.strictEqual(message, message.toLowerCase(), `Key "${message}" must be lower-case`);
  assert(Number.isInteger(statusCode), `Code ${statusCode} for "${message}" must be an integer`);
  assert(statusCode >= 100 && statusCode <= 599, `Code ${statusCode} must be in range 100-599`);
}

console.log('All statuses.code contract assertions passed.');