@eslint/object-schema 2.1.7: ValidationStrategy

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 @eslint/object-schema.ValidationStrategy in pkg:npm/%40eslint/object-schema@2.1.7
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40eslint/object-schema@2.1.7
Demonstrate these symbols/APIs:
  - @eslint/object-schema.ValidationStrategy

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:db872ccefa6faf04c75d136bc218c74d71a3484c2904339f58be580583ba50f1","contract":["ValidationStrategy.array accepts arrays and throws TypeError for non-arrays","ValidationStrategy.boolean accepts booleans and throws TypeError for non-booleans","ValidationStrategy.number accepts numbers and throws TypeError for non-numbers","ValidationStrategy.object accepts non-null objects and throws TypeError for null or non-objects","ValidationStrategy['object?'] accepts null and objects and throws TypeError for non-objects","ValidationStrategy.string accepts strings including empty strings and throws TypeError for non-strings","ValidationStrategy['string!'] accepts non-empty strings and throws TypeError for empty strings or non-strings","ObjectSchema integrates ValidationStrategy validators to validate object properties and wrap validation errors"],"goal":"verify @eslint/object-schema.ValidationStrategy in pkg:npm/%40eslint/object-schema@2.1.7","kind":"HOW","packages":["pkg:npm/%40eslint/object-schema@2.1.7"],"schemaVersion":1,"symbols":["@eslint/object-schema.ValidationStrategy"]},"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/%40eslint/object-schema@2.1.7"],"schemaVersion":1,"subject":"pkg:npm/%40eslint/object-schema@2.1.7","symbols":["@eslint/object-schema.ValidationStrategy"],"verifierAdapter":"node-typescript@1"}

import { ValidationStrategy, ObjectSchema } from "@eslint/object-schema";

export function validateValue(strategy, value) {
  if (typeof ValidationStrategy[strategy] === "function") {
    ValidationStrategy[strategy](value);
    return true;
  }
  throw new TypeError(`Unknown validation strategy: ${strategy}`);
}

export { ValidationStrategy, ObjectSchema };

{
  "name": "sample-eslint-validation-strategy",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-eslint-validation-strategy",
      "version": "1.0.0",
      "dependencies": {
        "@eslint/object-schema": "2.1.7"
      }
    },
    "node_modules/@eslint/object-schema": {
      "version": "2.1.7",
      "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz",
      "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==",
      "license": "Apache-2.0",
      "engines": {
        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
      }
    }
  }
}

{
  "name": "sample-eslint-validation-strategy",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "@eslint/object-schema": "2.1.7"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify @eslint/object-schema.ValidationStrategy in pkg:npm/%40eslint/object-schema@2.1.7",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40eslint/object-schema@2.1.7"
  ],
  "symbols": [
    "@eslint/object-schema.ValidationStrategy"
  ]
}

import assert from "node:assert/strict";
import { ValidationStrategy, ObjectSchema } from "@eslint/object-schema";

// 1. ValidationStrategy.array accepts arrays and throws TypeError for non-arrays
assert.doesNotThrow(() => ValidationStrategy.array([]));
assert.doesNotThrow(() => ValidationStrategy.array([1, "two", {}]));
assert.throws(() => ValidationStrategy.array(null), /^TypeError: Expected an array\.$/);
assert.throws(() => ValidationStrategy.array(undefined), /^TypeError: Expected an array\.$/);
assert.throws(() => ValidationStrategy.array("not an array"), /^TypeError: Expected an array\.$/);
assert.throws(() => ValidationStrategy.array({ length: 0 }), /^TypeError: Expected an array\.$/);
assert.throws(() => ValidationStrategy.array(123), /^TypeError: Expected an array\.$/);

// 2. ValidationStrategy.boolean accepts booleans and throws TypeError for non-booleans
assert.doesNotThrow(() => ValidationStrategy.boolean(true));
assert.doesNotThrow(() => ValidationStrategy.boolean(false));
assert.throws(() => ValidationStrategy.boolean(1), /^TypeError: Expected a Boolean\.$/);
assert.throws(() => ValidationStrategy.boolean(0), /^TypeError: Expected a Boolean\.$/);
assert.throws(() => ValidationStrategy.boolean("true"), /^TypeError: Expected a Boolean\.$/);
assert.throws(() => ValidationStrategy.boolean(null), /^TypeError: Expected a Boolean\.$/);
assert.throws(() => ValidationStrategy.boolean(undefined), /^TypeError: Expected a Boolean\.$/);

// 3. ValidationStrategy.number accepts numbers and throws TypeError for non-numbers
assert.doesNotThrow(() => ValidationStrategy.number(0));
assert.doesNotThrow(() => ValidationStrategy.number(-42.5));
assert.doesNotThrow(() => ValidationStrategy.number(NaN));
assert.doesNotThrow(() => ValidationStrategy.number(Infinity));
assert.throws(() => ValidationStrategy.number("42"), /^TypeError: Expected a number\.$/);
assert.throws(() => ValidationStrategy.number(null), /^TypeError: Expected a number\.$/);
assert.throws(() => ValidationStrategy.number(undefined), /^TypeError: Expected a number\.$/);
assert.throws(() => ValidationStrategy.number(true), /^TypeError: Expected a number\.$/);

// 4. ValidationStrategy.object accepts non-null objects and throws TypeError for null or non-objects
assert.doesNotThrow(() => ValidationStrategy.object({}));
assert.doesNotThrow(() => ValidationStrategy.object({ a: 1 }));
assert.doesNotThrow(() => ValidationStrategy.object(Object.create(null)));
assert.throws(() => ValidationStrategy.object(null), /^TypeError: Expected an object\.$/);
assert.throws(() => ValidationStrategy.object(undefined), /^TypeError: Expected an object\.$/);
assert.throws(() => ValidationStrategy.object("string"), /^TypeError: Expected an object\.$/);
assert.throws(() => ValidationStrategy.object(123), /^TypeError: Expected an object\.$/);
assert.throws(() => ValidationStrategy.object(false), /^TypeError: Expected an object\.$/);

// 5. ValidationStrategy['object?'] accepts null and objects and throws TypeError for non-objects
assert.doesNotThrow(() => ValidationStrategy["object?"](null));
assert.doesNotThrow(() => ValidationStrategy["object?"]({}));
assert.doesNotThrow(() => ValidationStrategy["object?"]({ key: "value" }));
assert.doesNotThrow(() => ValidationStrategy["object?"](Object.create(null)));
assert.throws(() => ValidationStrategy["object?"](undefined), /^TypeError: Expected an object or null\.$/);
assert.throws(() => ValidationStrategy["object?"]("string"), /^TypeError: Expected an object or null\.$/);
assert.throws(() => ValidationStrategy["object?"](123), /^TypeError: Expected an object or null\.$/);
assert.throws(() => ValidationStrategy["object?"](true), /^TypeError: Expected an object or null\.$/);

// 6. ValidationStrategy.string accepts strings including empty strings and throws TypeError for non-strings
assert.doesNotThrow(() => ValidationStrategy.string(""));
assert.doesNotThrow(() => ValidationStrategy.string("hello world"));
assert.throws(() => ValidationStrategy.string(123), /^TypeError: Expected a string\.$/);
assert.throws(() => ValidationStrategy.string(null), /^TypeError: Expected a string\.$/);
assert.throws(() => ValidationStrategy.string(undefined), /^TypeError: Expected a string\.$/);
assert.throws(() => ValidationStrategy.string({}), /^TypeError: Expected a string\.$/);

// 7. ValidationStrategy['string!'] accepts non-empty strings and throws TypeError for empty strings or non-strings
assert.doesNotThrow(() => ValidationStrategy["string!"]("hello"));
assert.doesNotThrow(() => ValidationStrategy["string!"](" "));
assert.throws(() => ValidationStrategy["string!"](""), /^TypeError: Expected a non-empty string\.$/);
assert.throws(() => ValidationStrategy["string!"](123), /^TypeError: Expected a non-empty string\.$/);
assert.throws(() => ValidationStrategy["string!"](null), /^TypeError: Expected a non-empty string\.$/);
assert.throws(() => ValidationStrategy["string!"](undefined), /^TypeError: Expected a non-empty string\.$/);

// 8. ObjectSchema integrates ValidationStrategy validators to validate object properties and wrap validation errors
const schema = new ObjectSchema({
  id: { required: true, merge: "replace", validate: "number" },
  name: { required: true, merge: "overwrite", validate: "string!" },
  optionalDescription: { required: false, merge: "replace", validate: "string" },
  tags: { required: false, merge: "overwrite", validate: "array" },
  config: { required: false, merge: "assign", validate: "object" },
  metadata: { required: false, merge: "replace", validate: "object?" },
  active: { required: false, merge: "replace", validate: "boolean" },
  customValidator: { required: false, merge: "replace", validate: ValidationStrategy.number }
});

assert.doesNotThrow(() => {
  schema.validate({
    id: 1,
    name: "item",
    optionalDescription: "",
    tags: ["tag1"],
    config: { enabled: true },
    metadata: null,
    active: true,
    customValidator: 42
  });
});

assert.throws(() => {
  schema.validate({
    id: "not-a-number",
    name: "item"
  });
}, /Expected a number\./);

assert.throws(() => {
  schema.validate({
    id: 1,
    name: ""
  });
}, /Expected a non-empty string\./);

console.log("ValidationStrategy contract assertions verified successfully.");