binary-extensions 2.3.0

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/binary-extensions@2.3.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/binary-extensions@2.3.0

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:3bd89f84275df4bcdb3fe0e594699adf0d25f1802560f9c90e386ae9a996e016","contract":["binaryExtensions exports an array of file extension strings without leading dots","binaryExtensions includes common archive formats such as zip, tar, gz, 7z, and rar","binaryExtensions includes common image formats such as png, jpg, jpeg, gif, webp, and bmp","binaryExtensions includes common audio formats such as mp3, wav, flac, aac, and ogg","binaryExtensions includes common video formats such as mp4, mkv, avi, mov, and webm","binaryExtensions includes common executable, library, and document formats such as exe, dll, pdf, bin, and iso","binaryExtensions does not include common plain text, markup, or programming language source extensions","isBinaryExtension helper correctly identifies binary files and extensions while ignoring leading dots and case"],"goal":"verify pkg:npm/binary-extensions@2.3.0","kind":"HOW","packages":["pkg:npm/binary-extensions@2.3.0"],"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/binary-extensions@2.3.0"],"schemaVersion":1,"subject":"pkg:npm/binary-extensions@2.3.0","verifierAdapter":"node-typescript@1"}

'use strict';

const binaryExtensions = require('binary-extensions');

const binaryExtensionsSet = new Set(binaryExtensions.map(ext => ext.toLowerCase()));
for (const ext of binaryExtensions) {
  binaryExtensionsSet.add(ext);
}

/**
 * Checks if a given file name or extension is a recognized binary file extension.
 *
 * @param {string} filePathOrExtension - File path, filename, or extension (with or without leading dot).
 * @returns {boolean} True if the extension is recognized as binary.
 */
function isBinaryExtension(filePathOrExtension) {
  if (typeof filePathOrExtension !== 'string') {
    return false;
  }
  const lastDot = filePathOrExtension.lastIndexOf('.');
  const ext = lastDot !== -1 ? filePathOrExtension.slice(lastDot + 1) : filePathOrExtension;
  if (!ext) {
    return false;
  }
  return binaryExtensionsSet.has(ext) || binaryExtensionsSet.has(ext.toLowerCase());
}

module.exports = {
  binaryExtensions,
  isBinaryExtension,
};

{
  "name": "sample-binary-extensions",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-binary-extensions",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "binary-extensions": "2.3.0"
      }
    },
    "node_modules/binary-extensions": {
      "version": "2.3.0",
      "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
      "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    }
  }
}

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

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/binary-extensions@2.3.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/binary-extensions@2.3.0"
  ]
}

import assert from 'node:assert/strict';
import binaryExtensions from 'binary-extensions';
import { isBinaryExtension } from '../index.js';

// 1. binaryExtensions exports an array of file extension strings without leading dots
assert.ok(Array.isArray(binaryExtensions));
assert.ok(binaryExtensions.length > 200);
assert.ok(binaryExtensions.every(ext => typeof ext === 'string' && ext.length > 0));
assert.ok(binaryExtensions.every(ext => !ext.startsWith('.')));

// 2. binaryExtensions includes common archive formats such as zip, tar, gz, 7z, and rar
for (const ext of ['zip', 'tar', 'gz', '7z', 'rar', 'bz2', 'xz']) {
  assert.ok(binaryExtensions.includes(ext), `expected ${ext} to be included in binaryExtensions`);
}

// 3. binaryExtensions includes common image formats such as png, jpg, jpeg, gif, webp, and bmp
for (const ext of ['png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp', 'ico', 'tiff']) {
  assert.ok(binaryExtensions.includes(ext), `expected ${ext} to be included in binaryExtensions`);
}

// 4. binaryExtensions includes common audio formats such as mp3, wav, flac, aac, and ogg
for (const ext of ['mp3', 'wav', 'flac', 'aac', 'ogg', 'm4a', 'wma']) {
  assert.ok(binaryExtensions.includes(ext), `expected ${ext} to be included in binaryExtensions`);
}

// 5. binaryExtensions includes common video formats such as mp4, mkv, avi, mov, and webm
for (const ext of ['mp4', 'mkv', 'avi', 'mov', 'webm', 'flv', 'wmv']) {
  assert.ok(binaryExtensions.includes(ext), `expected ${ext} to be included in binaryExtensions`);
}

// 6. binaryExtensions includes common executable, library, and document formats such as exe, dll, pdf, bin, and iso
for (const ext of ['exe', 'dll', 'pdf', 'bin', 'iso', 'so', 'dmg', 'apk', 'jar']) {
  assert.ok(binaryExtensions.includes(ext), `expected ${ext} to be included in binaryExtensions`);
}

// 7. binaryExtensions does not include common plain text, markup, or programming language source extensions
for (const ext of ['txt', 'md', 'html', 'css', 'js', 'mjs', 'cjs', 'ts', 'json', 'py', 'rs', 'go', 'c', 'cpp', 'java', 'rb']) {
  assert.ok(!binaryExtensions.includes(ext), `expected ${ext} to NOT be included in binaryExtensions`);
}

// 8. isBinaryExtension helper correctly identifies binary files and extensions while ignoring leading dots and case
assert.equal(isBinaryExtension('photo.PNG'), true);
assert.equal(isBinaryExtension('.zip'), true);
assert.equal(isBinaryExtension('archive.tar.gz'), true);
assert.equal(isBinaryExtension('document.pdf'), true);
assert.equal(isBinaryExtension('video.mp4'), true);
assert.equal(isBinaryExtension('app.exe'), true);
assert.equal(isBinaryExtension('.DS_Store'), true);
assert.equal(isBinaryExtension('script.js'), false);
assert.equal(isBinaryExtension('readme.MD'), false);
assert.equal(isBinaryExtension('styles.css'), false);
assert.equal(isBinaryExtension(''), false);
assert.equal(isBinaryExtension(null), false);
assert.equal(isBinaryExtension(undefined), false);

console.log('All binary-extensions contract assertions passed.');