statuses 2.0.2

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/statuses@2.0.2
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/statuses@2.0.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:a3301873b5795ac5af1cd7c8eca983ab2375b99cc722968fd5e68d225c492b11","contract":["status(code) returns the canonical HTTP status message string (e.g. status(200) === 'OK')","status(message) returns the HTTP status code for valid message strings case-insensitively (e.g. status('not found') === 404)","status.message[code] maps numerical status codes to status message strings","status.code[message] maps lowercase status message strings to numerical status codes","status.codes lists all supported numeric HTTP status codes","status.empty[code] identifies status codes with empty response bodies (e.g. 204, 304)","status.redirect[code] identifies redirect status codes (e.g. 301, 302)","status.retry[code] identifies retryable status codes (e.g. 503)","status(invalid) throws an error for unknown status codes or messages"],"goal":"verify pkg:npm/statuses@2.0.2","kind":"HOW","packages":["pkg:npm/statuses@2.0.2"],"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/statuses@2.0.2"],"schemaVersion":1,"verifierAdapter":"node-typescript@1"}

{
  "name": "verify-statuses",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "verify-statuses",
      "version": "1.0.0",
      "dependencies": {
        "statuses": "2.0.2"
      }
    },
    "node_modules/statuses": {
      "version": "2.0.2",
      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
      "license": "MIT",
      "engines": {
        "node": ">= 0.8"
      }
    }
  }
}

{
  "name": "verify-statuses",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "statuses": "2.0.2"
  }
}

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

import status from 'statuses';

export function getStatusInfo(codeOrMessage) {
  const code = typeof codeOrMessage === 'number' ? codeOrMessage : status(codeOrMessage);
  const message = typeof codeOrMessage === 'number' ? status(codeOrMessage) : codeOrMessage;
  return {
    code,
    message,
    isEmpty: Boolean(status.empty[code]),
    isRedirect: Boolean(status.redirect[code]),
    isRetry: Boolean(status.retry[code]),
  };
}

export default status;

import assert from 'node:assert';
import status, { getStatusInfo } from '../src/index.mjs';

// 1. Status code to message lookup
assert.strictEqual(status(200), 'OK');
assert.strictEqual(status(201), 'Created');
assert.strictEqual(status(204), 'No Content');
assert.strictEqual(status(400), 'Bad Request');
assert.strictEqual(status(404), 'Not Found');
assert.strictEqual(status(500), 'Internal Server Error');

// 2. Status message to code lookup (case-insensitive)
assert.strictEqual(status('ok'), 200);
assert.strictEqual(status('OK'), 200);
assert.strictEqual(status('Not Found'), 404);
assert.strictEqual(status('not found'), 404);

// 3. Direct mapping dictionaries
assert.strictEqual(status.message[200], 'OK');
assert.strictEqual(status.message[404], 'Not Found');
assert.strictEqual(status.code['ok'], 200);
assert.strictEqual(status.code['not found'], 404);

// 4. Status code lists
assert(Array.isArray(status.codes));
assert(status.codes.includes(200));
assert(status.codes.includes(404));
assert(status.codes.includes(500));

// 5. Status code category metadata
assert.strictEqual(status.empty[204], true);
assert.strictEqual(status.empty[304], true);
assert.strictEqual(status.empty[200], undefined);

assert.strictEqual(status.redirect[301], true);
assert.strictEqual(status.redirect[302], true);
assert.strictEqual(status.redirect[200], undefined);

assert.strictEqual(status.retry[503], true);
assert.strictEqual(status.retry[200], undefined);

// 6. getStatusInfo helper validation
const info200 = getStatusInfo(200);
assert.strictEqual(info200.code, 200);
assert.strictEqual(info200.message, 'OK');
assert.strictEqual(info200.isEmpty, false);
assert.strictEqual(info200.isRedirect, false);
assert.strictEqual(info200.isRetry, false);

const info204 = getStatusInfo(204);
assert.strictEqual(info204.isEmpty, true);

const info301 = getStatusInfo(301);
assert.strictEqual(info301.isRedirect, true);

const info503 = getStatusInfo(503);
assert.strictEqual(info503.isRetry, true);

// 7. Invalid inputs throw expected errors
assert.throws(() => status(9999), /invalid status code/);
assert.throws(() => status('nonexistent status message'), /invalid status message/);

console.log('Contract test passed.');