node-abi 4.33.0: additionalTargets

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 node-abi.additionalTargets in pkg:npm/node-abi@4.33.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/node-abi@4.33.0
Demonstrate these symbols/APIs:
  - node-abi.additionalTargets

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:95e63ee5011f73026a9028bb0df9e94384f17af83641cad859e1da213a7faf01","contract":["node-abi.additionalTargets is an array of target specification objects","each target object in node-abi.additionalTargets defines runtime, target, abi, and lts properties","node-abi.additionalTargets contains target objects for the node-webkit runtime","node-abi.additionalTargets target property specifies the version string and abi specifies the corresponding ABI string","node-abi.additionalTargets lts property indicates long-term support status as a boolean","node-abi.additionalTargets is a constituent subset included within node-abi.allTargets"],"goal":"verify node-abi.additionalTargets in pkg:npm/node-abi@4.33.0","kind":"HOW","packages":["pkg:npm/node-abi@4.33.0"],"schemaVersion":1,"symbols":["node-abi.additionalTargets"]},"contractCommand":["node","test/contract.mjs"],"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/node-abi@4.33.0"],"schemaVersion":1,"subject":"pkg:npm/node-abi@4.33.0","symbols":["node-abi.additionalTargets"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-node-abi-additionaltargets",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-node-abi-additionaltargets",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "node-abi": "4.33.0"
      }
    },
    "node_modules/node-abi": {
      "version": "4.33.0",
      "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-4.33.0.tgz",
      "integrity": "sha512-vLBWCKb+7LWsX+TbfzWOkw0W81m377tyx3hOweBTjO43CXZnRGS1/JPWs20fr0PgZyDXk6ROYrylsEycK8raDA==",
      "license": "MIT",
      "dependencies": {
        "semver": "^7.6.3"
      },
      "engines": {
        "node": ">=22.12.0"
      }
    },
    "node_modules/semver": {
      "version": "7.8.5",
      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
      "license": "ISC",
      "bin": {
        "semver": "bin/semver.js"
      },
      "engines": {
        "node": ">=10"
      }
    }
  }
}

{
  "name": "sample-node-abi-additionaltargets",
  "version": "1.0.0",
  "private": true,
  "description": "verify node-abi.additionalTargets in pkg:npm/node-abi@4.33.0",
  "type": "module",
  "main": "src/index.mjs",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "node-abi": "4.33.0"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "verify node-abi.additionalTargets in pkg:npm/node-abi@4.33.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/node-abi@4.33.0"
  ],
  "symbols": [
    "node-abi.additionalTargets"
  ]
}

import { additionalTargets, allTargets } from 'node-abi';

/**
 * Returns all additional targets exported by node-abi.
 * @returns {Array<{runtime: string, target: string, abi: string, lts: boolean}>}
 */
export function getAdditionalTargets() {
  return additionalTargets;
}

/**
 * Finds an additional target by its target version string.
 * @param {string} target
 * @returns {{runtime: string, target: string, abi: string, lts: boolean} | undefined}
 */
export function findAdditionalTarget(target) {
  return additionalTargets.find((t) => t.target === target);
}

/**
 * Filters additional targets by ABI identifier.
 * @param {string} abi
 * @returns {Array<{runtime: string, target: string, abi: string, lts: boolean}>}
 */
export function getAdditionalTargetsByAbi(abi) {
  return additionalTargets.filter((t) => t.abi === String(abi));
}

/**
 * Checks if a target version belongs to additionalTargets.
 * @param {string} target
 * @param {string} [runtime='node-webkit']
 * @returns {boolean}
 */
export function isAdditionalTarget(target, runtime = 'node-webkit') {
  return additionalTargets.some((t) => t.target === target && t.runtime === runtime);
}

export { additionalTargets, allTargets };

import assert from 'node:assert';
import { additionalTargets as rawAdditionalTargets, allTargets as rawAllTargets } from 'node-abi';
import {
  additionalTargets,
  allTargets,
  getAdditionalTargets,
  findAdditionalTarget,
  getAdditionalTargetsByAbi,
  isAdditionalTarget,
} from '../src/index.mjs';

// 1. node-abi.additionalTargets is an array of target specification objects
{
  assert.strictEqual(Array.isArray(rawAdditionalTargets), true, 'rawAdditionalTargets must be an array');
  assert.strictEqual(Array.isArray(additionalTargets), true, 'exported additionalTargets must be an array');
  assert.strictEqual(getAdditionalTargets(), rawAdditionalTargets, 'getAdditionalTargets() must return rawAdditionalTargets');
  assert.ok(additionalTargets.length > 0, 'additionalTargets must not be empty');
}

// 2. Each target object in node-abi.additionalTargets defines runtime, target, abi, and lts properties
{
  for (const item of additionalTargets) {
    assert.strictEqual(typeof item, 'object', 'each target must be an object');
    assert.notStrictEqual(item, null, 'target object must not be null');

    assert.strictEqual(typeof item.runtime, 'string', 'target.runtime must be a string');
    assert.ok(item.runtime.length > 0, 'target.runtime must not be empty');

    assert.strictEqual(typeof item.target, 'string', 'target.target must be a string');
    assert.ok(item.target.length > 0, 'target.target must not be empty');

    assert.strictEqual(typeof item.abi, 'string', 'target.abi must be a string');
    assert.ok(item.abi.length > 0, 'target.abi must not be empty');

    assert.strictEqual(typeof item.lts, 'boolean', 'target.lts must be a boolean');
  }
}

// 3. node-abi.additionalTargets contains target objects for the node-webkit runtime
{
  const runtimes = new Set(additionalTargets.map((t) => t.runtime));
  assert.ok(runtimes.has('node-webkit'), 'additionalTargets must contain node-webkit runtime targets');
  assert.ok(
    additionalTargets.every((t) => t.runtime === 'node-webkit'),
    'all entries in additionalTargets must have runtime node-webkit'
  );
}

// 4. node-abi.additionalTargets target property specifies the version string and abi specifies the corresponding ABI string
{
  const target013 = findAdditionalTarget('0.13.0');
  assert.ok(target013, 'target 0.13.0 must exist in additionalTargets');
  assert.strictEqual(target013.abi, '47', 'target 0.13.0 ABI must be 47');

  const target026 = findAdditionalTarget('0.26.5');
  assert.ok(target026, 'target 0.26.5 must exist in additionalTargets');
  assert.strictEqual(target026.abi, '59', 'target 0.26.5 ABI must be 59');

  const abi47Targets = getAdditionalTargetsByAbi('47');
  assert.ok(abi47Targets.length > 0, 'must find additional targets with ABI 47');
  assert.ok(abi47Targets.some((t) => t.target === '0.13.0'), 'ABI 47 targets must include 0.13.0');

  assert.strictEqual(isAdditionalTarget('0.13.0', 'node-webkit'), true);
  assert.strictEqual(isAdditionalTarget('non-existent-version', 'node-webkit'), false);
  assert.strictEqual(isAdditionalTarget('0.13.0', 'electron'), false);
}

// 5. node-abi.additionalTargets lts property indicates long-term support status as a boolean
{
  for (const target of additionalTargets) {
    assert.strictEqual(typeof target.lts, 'boolean', 'lts must be a boolean');
  }
}

// 6. node-abi.additionalTargets is a constituent subset included within node-abi.allTargets
{
  assert.ok(Array.isArray(rawAllTargets), 'allTargets must be an array');
  assert.ok(rawAllTargets.length >= additionalTargets.length, 'allTargets must contain at least as many items as additionalTargets');

  for (const item of additionalTargets) {
    const foundInAll = rawAllTargets.some(
      (t) => t.runtime === item.runtime && t.target === item.target && t.abi === item.abi && t.lts === item.lts
    );
    assert.ok(foundInAll, `target ${item.runtime}@${item.target} must be included within allTargets`);
  }
}

console.log('Contract tests passed successfully.');