responselike 2.0.1: Response

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/responselike@2.0.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/responselike@2.0.1
Demonstrate these symbols/APIs:
  - Response

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:6794ac09ffef6acbc07bb35810a59b06327e4f0768cab5f00a85defb37aee0c1","contract":["Response constructor creates a readable stream with statusCode, lowercase headers, body Buffer, and url","Response pushes body Buffer and EOF on stream read","Response constructor throws TypeError when statusCode is not a number, headers is not an object, body is not a Buffer, or url is not a string"],"goal":"verify pkg:npm/responselike@2.0.1","kind":"HOW","packages":["pkg:npm/responselike@2.0.1"],"schemaVersion":1,"symbols":["Response"]},"contractCommand":["node","test/contract.cjs"],"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/responselike@2.0.1"],"schemaVersion":1,"subject":"pkg:npm/responselike@2.0.1","symbols":["Response"],"verifierAdapter":"node-typescript@1"}

'use strict';

const Response = require('responselike');

function createResponse(statusCode, headers, body, url) {
  return new Response(statusCode, headers, body, url);
}

module.exports = {
  Response,
  createResponse
};

{
  "name": "sample-responselike",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-responselike",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "responselike": "2.0.1"
      }
    },
    "node_modules/lowercase-keys": {
      "version": "2.0.0",
      "resolved": "https://registry.npmjs.org/lowercase-keys/-/lowercase-keys-2.0.0.tgz",
      "integrity": "sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/responselike": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/responselike/-/responselike-2.0.1.tgz",
      "integrity": "sha512-4gl03wn3hj1HP3yzgdI7d3lCkF95F21Pz4BPGvKHinyQzALR5CapwC8yIi0Rh58DEMQ/SguC03wFj2k0M/mHhw==",
      "license": "MIT",
      "dependencies": {
        "lowercase-keys": "^2.0.0"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    }
  }
}

{
  "name": "sample-responselike",
  "version": "1.0.0",
  "private": true,
  "description": "verify pkg:npm/responselike@2.0.1",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.cjs"
  },
  "dependencies": {
    "responselike": "2.0.1"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/responselike@2.0.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/responselike@2.0.1"
  ],
  "symbols": [
    "Response"
  ]
}

'use strict';

const assert = require('assert');
const { Response, createResponse } = require('../index.js');

async function testResponsePropertiesAndStream() {
  const statusCode = 200;
  const headers = { 'Content-Type': 'text/plain; charset=utf-8', 'X-Custom-Header': 'test-val' };
  const body = Buffer.from('hello from responselike');
  const url = 'https://example.com/api/test';

  const res = createResponse(statusCode, headers, body, url);

  assert.strictEqual(res.statusCode, 200, 'statusCode should match');
  assert.strictEqual(res.headers['content-type'], 'text/plain; charset=utf-8', 'headers should have lowercase keys');
  assert.strictEqual(res.headers['x-custom-header'], 'test-val', 'headers should have lowercase keys');
  assert.strictEqual(res.url, 'https://example.com/api/test', 'url should match');
  assert(Buffer.isBuffer(res.body), 'body should be a Buffer');
  assert.strictEqual(res.body.toString('utf8'), 'hello from responselike');

  const chunks = [];
  for await (const chunk of res) {
    chunks.push(chunk);
  }
  const fullBody = Buffer.concat(chunks).toString('utf8');
  assert.strictEqual(fullBody, 'hello from responselike', 'stream content should match body');
}

function testTypeErrors() {
  const validStatus = 200;
  const validHeaders = { 'content-type': 'application/json' };
  const validBody = Buffer.from('{}');
  const validUrl = 'https://example.com';

  assert.throws(() => {
    new Response('200', validHeaders, validBody, validUrl);
  }, /Argument `statusCode` should be a number/);

  assert.throws(() => {
    new Response(validStatus, 'invalid-headers', validBody, validUrl);
  }, /Argument `headers` should be an object/);

  assert.throws(() => {
    new Response(validStatus, validHeaders, 'string-body', validUrl);
  }, /Argument `body` should be a buffer/);

  assert.throws(() => {
    new Response(validStatus, validHeaders, validBody, 12345);
  }, /Argument `url` should be a string/);
}

async function main() {
  await testResponsePropertiesAndStream();
  testTypeErrors();
  console.log('Contract tests passed successfully.');
}

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