@oxog/vld 2.1.0 → 2.2.5

package/dist/cjs/validators/xor.cjs

@@ -1,69 +1 @@
-'use strict';
-
-var validators_base = require('./base.cjs');
-require('../registry.cjs');
-
-/**
- * VldXor - Exclusive union validator
- * Part of Zod 4 API parity implementation
- * Ensures exactly one schema in the union matches
- */
-/**
- * XOR validator - ensures exactly one option matches
- * Unlike regular union which allows multiple matches, XOR requires exactly one
- */
-class VldXor extends validators_base.VldBase {
-    constructor(_options) {
-        super(validators_base.VLD_VALIDATOR_TYPES.XOR);
-        this._options = _options;
-    }
-    static create(options) {
-        if (options.length < 2) {
-            throw new Error('XOR requires at least 2 options');
-        }
-        return new VldXor(options);
-    }
-    parse(value) {
-        const result = this.safeParse(value);
-        if (!result.success) {
-            throw result.error;
-        }
-        return result.data;
-    }
-    safeParse(value) {
-        let matchCount = 0;
-        let lastSuccess = null;
-        for (const option of this._options) {
-            const result = option.safeParse(value);
-            if (result.success) {
-                matchCount++;
-                lastSuccess = result;
-                if (matchCount > 1) {
-                    // Early exit if more than one match
-                    break;
-                }
-            }
-        }
-        if (matchCount === 0) {
-            return {
-                success: false,
-                error: new Error('No schema matched in XOR union')
-            };
-        }
-        if (matchCount > 1) {
-            return {
-                success: false,
-                error: new Error(`Input matches ${matchCount} schemas in XOR union, but exactly one is required`)
-            };
-        }
-        return lastSuccess;
-    }
-    /**
-     * Get all options
-     */
-    getOptions() {
-        return this._options;
-    }
-}
-
-exports.VldXor = VldXor;
+"use strict";var r=require("./base.cjs");require("../registry.cjs");class VldXor extends r.VldBase{constructor(s){super(r.VLD_VALIDATOR_TYPES.XOR),this._options=s}static create(r){return new VldXor(r)}parse(r){const s=this.safeParse(r);if(!s.success)throw s.error;return s.data}safeParse(r){let s=0,e=null;for(const t of this._options){const o=t.safeParse(r);if(o.success&&(s++,e=o,s>1))break}return 0===s?{success:!1,error:new Error("No schema matched in XOR union")}:s>1?{success:!1,error:new Error(`Input matches ${s} schemas in XOR union, but exactly one is required`)}:e}getOptions(){return this._options}}exports.VldXor=VldXor;

package/dist/cli/bin.js

@@ -1,407 +1,2 @@
 #!/usr/bin/env node
-import { vldCli } from './index.js';
-import * as fs from 'fs';
-import { readFileSync } from 'fs';
-import * as path from 'path';
-import pigment from '../pigment.js';
-import { prettifyError, prettifyErrorColored } from '../errors.js';
-import v from '../index.js';
-
-/**
- * VLD CLI - Validate Command
- *
- * Validate JSON data against a VLD schema file.
- */
-function assertWithinCwd(absolutePath, label, original) {
-    const allowedDir = process.cwd();
-    if (!absolutePath.startsWith(allowedDir + path.sep) && absolutePath !== allowedDir) {
-        throw new Error(`${label} path escapes allowed directory: ${original}`);
-    }
-}
-/**
- * Validate command
- */
-const validateCommand = {
-    name: 'validate',
-    description: 'Validate JSON data against a VLD schema',
-    aliases: ['v'],
-    arguments: [
-        {
-            name: 'schema',
-            description: 'Path to schema file (.ts or .js)',
-            required: true
-        },
-        {
-            name: 'data',
-            description: 'Path to JSON data file or JSON string',
-            required: true
-        }
-    ],
-    options: [
-        {
-            name: 'strict',
-            short: 's',
-            description: 'Enable strict mode (no extra keys)',
-            type: 'boolean',
-            default: false
-        },
-        {
-            name: 'quiet',
-            short: 'q',
-            description: 'Only output errors',
-            type: 'boolean',
-            default: false
-        },
-        {
-            name: 'json',
-            short: 'j',
-            description: 'Output as JSON',
-            type: 'boolean',
-            default: false
-        },
-        {
-            name: 'no-color',
-            description: 'Disable colored output',
-            type: 'boolean',
-            default: false
-        }
-    ],
-    action: async (args, options) => {
-        const schemaPath = args['schema'];
-        const dataArg = args['data'];
-        const quiet = options['quiet'];
-        const json = options['json'];
-        const noColor = options['no-color'];
-        // Load schema
-        let schema;
-        try {
-            const absoluteSchemaPath = path.resolve(process.cwd(), schemaPath);
-            // Security: Ensure resolved path is within allowed directories
-            assertWithinCwd(absoluteSchemaPath, 'Schema', schemaPath);
-            if (!fs.existsSync(absoluteSchemaPath)) {
-                throw new Error(`Schema file not found: ${schemaPath}`);
-            }
-            // Dynamic import for ESM/CJS compatibility
-            const schemaModule = await import(absoluteSchemaPath);
-            schema = schemaModule.default || schemaModule.schema || schemaModule;
-            if (!schema || typeof schema.parse !== 'function') {
-                throw new Error('Schema must export a VLD validator with parse() method');
-            }
-        }
-        catch (error) {
-            if (json) {
-                console.log(JSON.stringify({ success: false, error: error.message }));
-            }
-            else {
-                console.error(pigment.red('Schema Error:'), error.message);
-            }
-            process.exitCode = 1;
-            return;
-        }
-        // Load data
-        let data;
-        try {
-            // Check if it's a file path or JSON string
-            if (dataArg.startsWith('{') || dataArg.startsWith('[')) {
-                data = JSON.parse(dataArg);
-            }
-            else {
-                const absoluteDataPath = path.resolve(process.cwd(), dataArg);
-                // Security: Ensure resolved path is within allowed directories
-                assertWithinCwd(absoluteDataPath, 'Data', dataArg);
-                if (!fs.existsSync(absoluteDataPath)) {
-                    throw new Error(`Data file not found: ${dataArg}`);
-                }
-                const content = fs.readFileSync(absoluteDataPath, 'utf-8');
-                data = JSON.parse(content);
-            }
-        }
-        catch (error) {
-            if (json) {
-                console.log(JSON.stringify({ success: false, error: error.message }));
-            }
-            else {
-                console.error(pigment.red('Data Error:'), error.message);
-            }
-            process.exitCode = 1;
-            return;
-        }
-        // Validate
-        const result = schema.safeParse(data);
-        if (json) {
-            if (result.success) {
-                console.log(JSON.stringify({ success: true, data: result.data }));
-            }
-            else {
-                const err = result.error;
-                const errorJson = {
-                    success: false,
-                    error: err?.message,
-                    issues: err?.issues
-                };
-                console.log(JSON.stringify(errorJson));
-            }
-        }
-        else {
-            if (result.success) {
-                if (!quiet) {
-                    console.log(pigment.green('Validation passed'));
-                    console.log('');
-                    console.log(pigment.dim('Data:'));
-                    console.log(JSON.stringify(result.data, null, 2));
-                }
-            }
-            else {
-                console.error(pigment.red('Validation failed'));
-                console.error('');
-                // Check if it's a VldError with issues
-                if (result.error && 'issues' in result.error) {
-                    const formatted = noColor
-                        ? prettifyError(result.error, { colored: false })
-                        : prettifyErrorColored(result.error);
-                    console.error(formatted);
-                }
-                else {
-                    console.error(result.error?.message || 'Unknown error');
-                }
-                process.exitCode = 1;
-            }
-        }
-    }
-};
-
-/**
- * VLD CLI - Benchmark Command
- *
- * Run performance benchmarks for VLD validation.
- */
-/**
- * Run a single benchmark
- */
-function runBenchmark(name, fn, iterations) {
-    // Warm up
-    for (let i = 0; i < Math.min(100, iterations / 10); i++) {
-        fn();
-    }
-    // Run benchmark
-    const start = performance.now();
-    for (let i = 0; i < iterations; i++) {
-        fn();
-    }
-    const end = performance.now();
-    const totalMs = end - start;
-    const avgMs = totalMs / iterations;
-    const opsPerSec = 1000 / avgMs;
-    return { name, iterations, totalMs, avgMs, opsPerSec };
-}
-/**
- * Format number with comma separators
- */
-function formatNumber(n) {
-    return n.toLocaleString('en-US', { maximumFractionDigits: 2 });
-}
-/**
- * Format benchmark result
- */
-function formatResult(result, colored) {
-    const name = colored ? pigment.cyan(result.name.padEnd(30)) : result.name.padEnd(30);
-    const ops = colored
-        ? pigment.green(formatNumber(result.opsPerSec).padStart(12))
-        : formatNumber(result.opsPerSec).padStart(12);
-    const avg = colored
-        ? pigment.yellow(result.avgMs.toFixed(6).padStart(12))
-        : result.avgMs.toFixed(6).padStart(12);
-    return `${name} ${ops} ops/sec  ${avg} ms/op`;
-}
-/**
- * Benchmark command
- */
-const benchmarkCommand = {
-    name: 'benchmark',
-    description: 'Run performance benchmarks',
-    aliases: ['bench', 'b'],
-    options: [
-        {
-            name: 'iterations',
-            short: 'n',
-            description: 'Number of iterations',
-            type: 'number',
-            default: 10000
-        },
-        {
-            name: 'suite',
-            short: 's',
-            description: 'Benchmark suite to run (all, primitives, objects, arrays)',
-            type: 'string',
-            default: 'all'
-        },
-        {
-            name: 'json',
-            short: 'j',
-            description: 'Output as JSON',
-            type: 'boolean',
-            default: false
-        },
-        {
-            name: 'no-color',
-            description: 'Disable colored output',
-            type: 'boolean',
-            default: false
-        }
-    ],
-    action: async (_args, options) => {
-        const iterations = options['iterations'];
-        const suite = options['suite'];
-        const json = options['json'];
-        const noColor = options['no-color'];
-        const colored = !noColor;
-        const results = [];
-        // Primitive validators
-        const stringSchema = v.string();
-        const numberSchema = v.number();
-        const booleanSchema = v.boolean();
-        const dateSchema = v.date();
-        // Object validator
-        const userSchema = v.object({
-            name: v.string(),
-            email: v.string(),
-            age: v.number(),
-            active: v.boolean()
-        });
-        // Array validator
-        const numbersSchema = v.array(v.number());
-        // Nested object validator
-        const nestedSchema = v.object({
-            user: v.object({
-                name: v.string(),
-                email: v.string()
-            }),
-            items: v.array(v.object({
-                id: v.number(),
-                name: v.string(),
-                price: v.number()
-            }))
-        });
-        // Test data
-        const testString = 'hello world';
-        const testNumber = 42;
-        const testBoolean = true;
-        const testDate = new Date();
-        const testUser = { name: 'John', email: 'john@example.com', age: 30, active: true };
-        const testNumbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
-        const testNested = {
-            user: { name: 'John', email: 'john@example.com' },
-            items: [
-                { id: 1, name: 'Item 1', price: 10.99 },
-                { id: 2, name: 'Item 2', price: 20.99 },
-                { id: 3, name: 'Item 3', price: 30.99 }
-            ]
-        };
-        if (!json) {
-            console.log(pigment.bold('VLD Performance Benchmark'));
-            console.log(pigment.dim(`Running ${formatNumber(iterations)} iterations per test`));
-            console.log('');
-        }
-        // Primitive benchmarks
-        if (suite === 'all' || suite === 'primitives') {
-            if (!json) {
-                console.log(pigment.bold('Primitives:'));
-            }
-            results.push(runBenchmark('string.parse()', () => stringSchema.parse(testString), iterations));
-            results.push(runBenchmark('number.parse()', () => numberSchema.parse(testNumber), iterations));
-            results.push(runBenchmark('boolean.parse()', () => booleanSchema.parse(testBoolean), iterations));
-            results.push(runBenchmark('date.parse()', () => dateSchema.parse(testDate), iterations));
-            results.push(runBenchmark('string.safeParse()', () => stringSchema.safeParse(testString), iterations));
-            if (!json) {
-                for (const result of results.slice(-5)) {
-                    console.log('  ' + formatResult(result, colored));
-                }
-                console.log('');
-            }
-        }
-        // Object benchmarks
-        if (suite === 'all' || suite === 'objects') {
-            if (!json) {
-                console.log(pigment.bold('Objects:'));
-            }
-            results.push(runBenchmark('object.parse()', () => userSchema.parse(testUser), iterations));
-            results.push(runBenchmark('object.safeParse()', () => userSchema.safeParse(testUser), iterations));
-            results.push(runBenchmark('nested.parse()', () => nestedSchema.parse(testNested), iterations));
-            if (!json) {
-                for (const result of results.slice(-3)) {
-                    console.log('  ' + formatResult(result, colored));
-                }
-                console.log('');
-            }
-        }
-        // Array benchmarks
-        if (suite === 'all' || suite === 'arrays') {
-            if (!json) {
-                console.log(pigment.bold('Arrays:'));
-            }
-            results.push(runBenchmark('array.parse()', () => numbersSchema.parse(testNumbers), iterations));
-            results.push(runBenchmark('array.safeParse()', () => numbersSchema.safeParse(testNumbers), iterations));
-            if (!json) {
-                for (const result of results.slice(-2)) {
-                    console.log('  ' + formatResult(result, colored));
-                }
-                console.log('');
-            }
-        }
-        // Summary
-        if (!json) {
-            const totalOps = results.reduce((sum, r) => sum + r.opsPerSec, 0);
-            const avgOps = totalOps / results.length;
-            console.log(pigment.bold('Summary:'));
-            console.log(`  Total benchmarks: ${results.length}`);
-            console.log(`  Average ops/sec:  ${formatNumber(avgOps)}`);
-        }
-        else {
-            console.log(JSON.stringify({
-                iterations,
-                suite,
-                results: results.map((r) => ({
-                    name: r.name,
-                    iterations: r.iterations,
-                    totalMs: r.totalMs,
-                    avgMs: r.avgMs,
-                    opsPerSec: r.opsPerSec
-                }))
-            }));
-        }
-    }
-};
-
-/**
- * VLD CLI Entry Point
- *
- * This is the main entry point for the `vld` command-line tool.
- */
-const packageJson = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf-8'));
-const version = packageJson.version || '0.0.0';
-vldCli.version = version;
-// Register commands
-vldCli.command(validateCommand);
-vldCli.command(benchmarkCommand);
-// Help command
-vldCli.command({
-    name: 'help',
-    description: 'Show help information',
-    aliases: ['h'],
-    action: () => {
-        console.log(vldCli.help());
-    }
-});
-// Version command
-vldCli.command({
-    name: 'version',
-    description: 'Show version information',
-    action: () => {
-        console.log(`vld v${version}`);
-    }
-});
-// Run CLI
-vldCli.run(process.argv.slice(2)).catch((error) => {
-    console.error('Fatal error:', error);
-    process.exitCode = 1;
-});
+import{vldCli as e}from"./index.js";import*as o from"fs";import{readFileSync as s}from"fs";import*as r from"path";import a from"../pigment.js";import{prettifyError as t,prettifyErrorColored as n}from"../errors.js";import i from"../index.js";function c(e,o,s){const a=process.cwd();if(!e.startsWith(a+r.sep)&&e!==a)throw new Error(`${o} path escapes allowed directory: ${s}`)}const l={name:"validate",description:"Validate JSON data against a VLD schema",aliases:["v"],arguments:[{name:"schema",description:"Path to schema file (.ts or .js)",required:!0},{name:"data",description:"Path to JSON data file or JSON string",required:!0}],options:[{name:"strict",short:"s",description:"Enable strict mode (no extra keys)",type:"boolean",default:!1},{name:"quiet",short:"q",description:"Only output errors",type:"boolean",default:!1},{name:"json",short:"j",description:"Output as JSON",type:"boolean",default:!1},{name:"no-color",description:"Disable colored output",type:"boolean",default:!1}],action:async(e,s)=>{const i=e.schema,l=e.data,m=s.quiet,p=s.json,d=s["no-color"];let u,f;try{const e=r.resolve(process.cwd(),i);if(c(e,"Schema",i),!o.existsSync(e))throw new Error(`Schema file not found: ${i}`);const s=await(import(e));if(u=s.default||s.schema||s,!u||"function"!=typeof u.parse)throw new Error("Schema must export a VLD validator with parse() method")}catch(e){return p?console.log(JSON.stringify({success:!1,error:e.message})):console.error(a.red("Schema Error:"),e.message),void(process.exitCode=1)}try{if(l.startsWith("{")||l.startsWith("["))f=JSON.parse(l);else{const e=r.resolve(process.cwd(),l);if(c(e,"Data",l),!o.existsSync(e))throw new Error(`Data file not found: ${l}`);const s=o.readFileSync(e,"utf-8");f=JSON.parse(s)}}catch(e){return p?console.log(JSON.stringify({success:!1,error:e.message})):console.error(a.red("Data Error:"),e.message),void(process.exitCode=1)}const g=u.safeParse(f);if(p)if(g.success)console.log(JSON.stringify({success:!0,data:g.data}));else{const e=g.error,o={success:!1,error:e?.message,issues:e?.issues};console.log(JSON.stringify(o))}else if(g.success)m||(console.log(a.green("Validation passed")),console.log(""),console.log(a.dim("Data:")),console.log(JSON.stringify(g.data,null,2)));else{if(console.error(a.red("Validation failed")),console.error(""),g.error&&"issues"in g.error){const e=d?t(g.error,{colored:!1}):n(g.error);console.error(e)}else console.error(g.error?.message||"Unknown error");process.exitCode=1}}};function m(e,o,s){for(let e=0;e<Math.min(100,s/10);e++)o();const r=performance.now();for(let e=0;e<s;e++)o();const a=performance.now()-r,t=a/s;return{name:e,iterations:s,totalMs:a,avgMs:t,opsPerSec:1e3/t}}function p(e){return e.toLocaleString("en-US",{maximumFractionDigits:2})}function d(e,o){return`${o?a.cyan(e.name.padEnd(30)):e.name.padEnd(30)} ${o?a.green(p(e.opsPerSec).padStart(12)):p(e.opsPerSec).padStart(12)} ops/sec  ${o?a.yellow(e.avgMs.toFixed(6).padStart(12)):e.avgMs.toFixed(6).padStart(12)} ms/op`}const u={name:"benchmark",description:"Run performance benchmarks",aliases:["bench","b"],options:[{name:"iterations",short:"n",description:"Number of iterations",type:"number",default:1e4},{name:"suite",short:"s",description:"Benchmark suite to run (all, primitives, objects, arrays)",type:"string",default:"all"},{name:"json",short:"j",description:"Output as JSON",type:"boolean",default:!1},{name:"no-color",description:"Disable colored output",type:"boolean",default:!1}],action:async(e,o)=>{const s=o.iterations,r=o.suite,t=o.json,n=!o["no-color"],c=[],l=i.string(),u=i.number(),f=i.boolean(),g=i.date(),h=i.object({name:i.string(),email:i.string(),age:i.number(),active:i.boolean()}),b=i.array(i.number()),S=i.object({user:i.object({name:i.string(),email:i.string()}),items:i.array(i.object({id:i.number(),name:i.string(),price:i.number()}))}),y="hello world",v=new Date,j={name:"John",email:"john@example.com",age:30,active:!0},w=[1,2,3,4,5,6,7,8,9,10],O={user:{name:"John",email:"john@example.com"},items:[{id:1,name:"Item 1",price:10.99},{id:2,name:"Item 2",price:20.99},{id:3,name:"Item 3",price:30.99}]};if(t||(console.log(a.bold("VLD Performance Benchmark")),console.log(a.dim(`Running ${p(s)} iterations per test`)),console.log("")),("all"===r||"primitives"===r)&&(t||console.log(a.bold("Primitives:")),c.push(m("string.parse()",()=>l.parse(y),s)),c.push(m("number.parse()",()=>u.parse(42),s)),c.push(m("boolean.parse()",()=>f.parse(true),s)),c.push(m("date.parse()",()=>g.parse(v),s)),c.push(m("string.safeParse()",()=>l.safeParse(y),s)),!t)){for(const e of c.slice(-5))console.log("  "+d(e,n));console.log("")}if(("all"===r||"objects"===r)&&(t||console.log(a.bold("Objects:")),c.push(m("object.parse()",()=>h.parse(j),s)),c.push(m("object.safeParse()",()=>h.safeParse(j),s)),c.push(m("nested.parse()",()=>S.parse(O),s)),!t)){for(const e of c.slice(-3))console.log("  "+d(e,n));console.log("")}if(("all"===r||"arrays"===r)&&(t||console.log(a.bold("Arrays:")),c.push(m("array.parse()",()=>b.parse(w),s)),c.push(m("array.safeParse()",()=>b.safeParse(w),s)),!t)){for(const e of c.slice(-2))console.log("  "+d(e,n));console.log("")}if(t)console.log(JSON.stringify({iterations:s,suite:r,results:c.map(e=>({name:e.name,iterations:e.iterations,totalMs:e.totalMs,avgMs:e.avgMs,opsPerSec:e.opsPerSec}))}));else{const e=c.reduce((e,o)=>e+o.opsPerSec,0)/c.length;console.log(a.bold("Summary:")),console.log(`  Total benchmarks: ${c.length}`),console.log(`  Average ops/sec:  ${p(e)}`)}}},f=JSON.parse(s(new URL("../../package.json",import.meta.url),"utf-8")).version||"0.0.0";e.version=f,e.command(l),e.command(u),e.command({name:"help",description:"Show help information",aliases:["h"],action:()=>{console.log(e.help())}}),e.command({name:"version",description:"Show version information",action:()=>{console.log(`vld v${f}`)}}),e.run(process.argv.slice(2)).catch(e=>{console.error("Fatal error:",e),process.exitCode=1});