minizlib 3.1.0: Inflate

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 minizlib.Inflate in pkg:npm/minizlib@3.1.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/minizlib@3.1.0
Demonstrate these symbols/APIs:
  - minizlib.Inflate

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:85407a520ce734f15ff8c2f31e289051d691b6a0daf84d230a23f9436cf8035d","contract":["Inflate class is exported and instantiates stream instances extending Zlib","Inflate synchronously decompresses deflate compressed data back to original content","Inflate decompresses chunked compressed data across multiple writes","Inflate piped from an upstream stream processes and emits decompressed data asynchronously","Inflate raises ZlibError when consuming invalid or corrupted compressed input"],"goal":"verify minizlib.Inflate in pkg:npm/minizlib@3.1.0","kind":"HOW","packages":["pkg:npm/minizlib@3.1.0"],"schemaVersion":1,"symbols":["minizlib.Inflate"]},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"esm","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/minizlib@3.1.0"],"schemaVersion":1,"subject":"pkg:npm/minizlib@3.1.0","symbols":["minizlib.Inflate"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-minizlib-inflate",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-minizlib-inflate",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "minizlib": "3.1.0"
      }
    },
    "node_modules/minipass": {
      "version": "7.1.3",
      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
      "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
      "license": "BlueOak-1.0.0",
      "engines": {
        "node": ">=16 || 14 >=14.17"
      }
    },
    "node_modules/minizlib": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-3.1.0.tgz",
      "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==",
      "license": "MIT",
      "dependencies": {
        "minipass": "^7.1.2"
      },
      "engines": {
        "node": ">= 18"
      }
    }
  }
}

{
  "name": "sample-minizlib-inflate",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "description": "Clean-room verification for minizlib Inflate stream",
  "main": "src/index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "minizlib": "3.1.0"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "verify minizlib.Inflate in pkg:npm/minizlib@3.1.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/minizlib@3.1.0"
  ],
  "symbols": [
    "minizlib.Inflate"
  ]
}

import { Inflate, Deflate, Zlib, ZlibError } from 'minizlib';

/**
 * Compresses data synchronously using minizlib Deflate.
 * @param {string | Buffer} data
 * @param {import('zlib').ZlibOptions} [options]
 * @returns {Buffer}
 */
export function deflateSync(data, options) {
  const zip = new Deflate(options);
  zip.end(data);
  return zip.read();
}

/**
 * Decompresses deflate data synchronously using minizlib Inflate.
 * @param {Buffer} data
 * @param {import('zlib').ZlibOptions} [options]
 * @returns {Buffer}
 */
export function inflateSync(data, options) {
  const unzip = new Inflate(options);
  unzip.end(data);
  return unzip.read();
}

/**
 * Creates a configured Inflate decompression stream.
 * @param {import('zlib').ZlibOptions} [options]
 * @returns {Inflate}
 */
export function createInflateStream(options) {
  return new Inflate(options);
}

/**
 * Creates a configured Deflate compression stream.
 * @param {import('zlib').ZlibOptions} [options]
 * @returns {Deflate}
 */
export function createDeflateStream(options) {
  return new Deflate(options);
}

export { Inflate, Deflate, Zlib, ZlibError };

import assert from 'node:assert/strict';
import {
  Inflate,
  Deflate,
  Zlib,
  ZlibError,
  deflateSync,
  inflateSync,
  createInflateStream,
  createDeflateStream,
} from '../src/index.js';

// 1. Inflate class is exported and instantiates stream instances extending Zlib
assert.equal(typeof Inflate, 'function', 'Inflate must be a constructor function');
const inflateInstance = new Inflate();
assert.ok(inflateInstance instanceof Zlib, 'Inflate must inherit from Zlib');

// 2. Inflate synchronously decompresses deflate compressed data back to original content
const sampleText = 'CodeSampleX minizlib Inflate verification payload 12345';
const compressedBuffer = deflateSync(sampleText);
assert.ok(Buffer.isBuffer(compressedBuffer), 'Compressed output must be a Buffer');
assert.ok(compressedBuffer.length > 0, 'Compressed output must not be empty');

const decompressedBuffer = inflateSync(compressedBuffer);
assert.ok(Buffer.isBuffer(decompressedBuffer), 'Decompressed output must be a Buffer');
assert.equal(decompressedBuffer.toString('utf8'), sampleText, 'Decompressed text must match original');

// 3. Inflate decompresses chunked compressed data across multiple writes
const chunkedInflate = createInflateStream();
const chunkSize = 8;
for (let i = 0; i < compressedBuffer.length; i += chunkSize) {
  chunkedInflate.write(compressedBuffer.subarray(i, i + chunkSize));
}
chunkedInflate.end();
const chunkedResult = chunkedInflate.read();
assert.ok(Buffer.isBuffer(chunkedResult), 'Chunked result must be a Buffer');
assert.equal(chunkedResult.toString('utf8'), sampleText, 'Chunked result must match original payload');

// 4. Inflate piped from an upstream stream processes and emits decompressed data asynchronously
const zipStream = createDeflateStream();
const unzipStream = createInflateStream();
zipStream.pipe(unzipStream);

const receivedChunks = [];
unzipStream.on('data', chunk => receivedChunks.push(chunk));

await new Promise((resolve, reject) => {
  unzipStream.on('end', () => {
    const pipedResult = Buffer.concat(receivedChunks).toString('utf8');
    assert.equal(pipedResult, sampleText, 'Stream piped result must match original payload');
    resolve();
  });
  zipStream.on('error', reject);
  unzipStream.on('error', reject);
  zipStream.end(sampleText);
});

// 5. Inflate raises ZlibError when consuming invalid or corrupted compressed input
let caughtError = null;
try {
  inflateSync(Buffer.from('not valid compressed deflate payload'));
} catch (err) {
  caughtError = err;
}
assert.ok(caughtError !== null, 'Inflate must throw an error on invalid compressed input');
assert.ok(caughtError instanceof Error, 'Thrown error must be an instance of Error');
assert.ok(
  caughtError instanceof ZlibError || caughtError.code !== undefined || caughtError.message.length > 0,
  'Error must have diagnostic details'
);
assert.equal(caughtError.code, 'Z_DATA_ERROR', 'Error code must be Z_DATA_ERROR');

console.log('All minizlib Inflate contract assertions passed successfully.');