bupkis 0.18.2 → 1.0.0

package/dist/diff.cjs

@@ -0,0 +1,340 @@
+"use strict";
+/**
+ * Diff utilities for generating rich assertion failure output.
+ *
+ * This module provides utilities for extracting meaningful actual/expected
+ * values from Zod validation errors and generating high-quality diff output
+ * using `jest-diff` for assertion failures.
+ *
+ * @packageDocumentation
+ * @see {@link https://npm.im/jest-diff | jest-diff}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldGenerateDiff = exports.generateDiff = exports.extractDiffValues = void 0;
+const jest_diff_1 = require("jest-diff");
+const { isArray } = Array;
+const { max } = Math;
+const { stringify } = JSON;
+const { entries, getOwnPropertyNames } = Object;
+/**
+ * Extracts actual and expected values from a `ZodError` for meaningful diffs.
+ *
+ * @function
+ * @param zodError The `ZodError` to extract values from
+ * @param subject The original subject that failed validation
+ * @returns Object with actual and expected values for diff
+ */
+const extractDiffValues = (zodError, subject) => {
+    try {
+        const actual = subject;
+        let expected = subject != null ? deepClone(subject) : subject;
+        for (const issue of zodError.issues) {
+            try {
+                const filteredPath = issue.path.filter((key) => typeof key === 'string' || typeof key === 'number');
+                switch (issue.code) {
+                    case 'custom': {
+                        const params = issue.params;
+                        if (params?.bupkisType === 'missing_key' &&
+                            filteredPath.length > 0) {
+                            const missingKey = filteredPath[0];
+                            if (typeof expected === 'object' && expected !== null) {
+                                expected = {
+                                    ...expected,
+                                    [missingKey]: undefined,
+                                };
+                            }
+                        }
+                        else if (filteredPath.length > 0) {
+                            const actualValue = getValueAtPath(actual, filteredPath);
+                            if (actualValue === undefined) {
+                                expected = setValueAtPath(expected, filteredPath, undefined);
+                            }
+                        }
+                        break;
+                    }
+                    case 'invalid_format': {
+                        const actualValue = getValueAtPath(actual, filteredPath);
+                        let correctedValue = actualValue;
+                        const regexMatch = issue.message.match(/pattern (.+)/);
+                        if (regexMatch) {
+                            correctedValue = `<string matching ${regexMatch[1]}>`;
+                        }
+                        else {
+                            correctedValue = '<string in valid format>';
+                        }
+                        expected = setValueAtPath(expected, filteredPath, correctedValue);
+                        break;
+                    }
+                    case 'invalid_type': {
+                        const correctedValue = createCorrectValueForType(issue.expected, getValueAtPath(actual, filteredPath));
+                        expected = setValueAtPath(expected, filteredPath, correctedValue);
+                        break;
+                    }
+                    case 'invalid_union': {
+                        // Union errors contain multiple sub-errors for each branch.
+                        // We can't determine a single "expected" value, so bail out
+                        // and let Zod's error message show all the union branch errors.
+                        return { actual: undefined, expected: undefined };
+                    }
+                    case 'invalid_value': {
+                        // Only use the corrected value if we have a concrete value from the schema
+                        if (issue.values && issue.values.length > 0) {
+                            const correctedValue = issue.values[0];
+                            expected = setValueAtPath(expected, filteredPath, correctedValue);
+                        }
+                        else {
+                            // No concrete value available, bail out to Zod's error message
+                            return { actual: undefined, expected: undefined };
+                        }
+                        break;
+                    }
+                    case 'too_big': {
+                        const actualValue = getValueAtPath(actual, filteredPath);
+                        let correctedValue;
+                        if (issue.origin === 'string' && typeof actualValue === 'string') {
+                            correctedValue = actualValue.slice(0, Number(issue.maximum));
+                        }
+                        else if (issue.origin === 'array' && isArray(actualValue)) {
+                            correctedValue = actualValue.slice(0, Number(issue.maximum));
+                        }
+                        else {
+                            correctedValue = issue.maximum;
+                        }
+                        expected = setValueAtPath(expected, filteredPath, correctedValue);
+                        break;
+                    }
+                    case 'too_small': {
+                        const actualValue = getValueAtPath(actual, filteredPath);
+                        let correctedValue;
+                        if (issue.origin === 'string' && typeof actualValue === 'string') {
+                            const needed = Number(issue.minimum) - actualValue.length;
+                            correctedValue = actualValue + 'x'.repeat(max(0, needed));
+                        }
+                        else if (issue.origin === 'array' && isArray(actualValue)) {
+                            const needed = Number(issue.minimum) - actualValue.length;
+                            correctedValue = actualValue.concat(new Array(max(0, needed)).fill(null));
+                        }
+                        else {
+                            correctedValue = issue.minimum;
+                        }
+                        expected = setValueAtPath(expected, filteredPath, correctedValue);
+                        break;
+                    }
+                    case 'unrecognized_keys': {
+                        if (filteredPath.length === 0 &&
+                            typeof expected === 'object' &&
+                            expected !== null) {
+                            const expectedCopy = {
+                                ...expected,
+                            };
+                            for (const key of issue.keys) {
+                                delete expectedCopy[key];
+                            }
+                            expected = expectedCopy;
+                        }
+                        break;
+                    }
+                    default: {
+                        break;
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return { actual, expected };
+    }
+    catch {
+        return { actual: undefined, expected: undefined };
+    }
+};
+exports.extractDiffValues = extractDiffValues;
+/**
+ * Generates a rich diff string using jest-diff for assertion failures.
+ *
+ * @function
+ * @param expected The expected value
+ * @param actual The actual value
+ * @param options Configuration options for diff generation
+ * @returns A formatted diff string, or null if values are identical
+ */
+const generateDiff = (expected, actual, options = {}) => {
+    if (!(0, exports.shouldGenerateDiff)(actual, expected)) {
+        return null;
+    }
+    return (0, jest_diff_1.diff)(expected, actual, {
+        aAnnotation: 'expected',
+        bAnnotation: 'actual',
+        expand: false,
+        includeChangeCounts: true,
+        ...options,
+    });
+};
+exports.generateDiff = generateDiff;
+/**
+ * Checks if two values should generate a meaningful diff.
+ *
+ * @function
+ * @param actual The actual value
+ * @param expected The expected value
+ * @returns True if a diff should be generated, false otherwise
+ */
+const shouldGenerateDiff = (actual, expected) => actual !== undefined && expected !== undefined && actual !== expected;
+exports.shouldGenerateDiff = shouldGenerateDiff;
+/**
+ * Creates a corrected value for a given type
+ *
+ * @function
+ */
+const createCorrectValueForType = (expectedType, actualValue) => {
+    switch (expectedType) {
+        case 'array':
+            return isArray(actualValue) ? actualValue : [];
+        case 'boolean':
+            return typeof actualValue === 'boolean'
+                ? actualValue
+                : Boolean(actualValue);
+        case 'null':
+            return null;
+        case 'number':
+            return typeof actualValue === 'number'
+                ? actualValue
+                : Number(actualValue) || 0;
+        case 'object':
+            return typeof actualValue === 'object' && actualValue !== null
+                ? actualValue
+                : {};
+        case 'string':
+            if (typeof actualValue === 'string') {
+                return actualValue;
+            }
+            if (actualValue == null) {
+                return '';
+            }
+            if (typeof actualValue === 'object') {
+                return stringify(actualValue);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-base-to-string
+            return `${actualValue}`;
+        case 'undefined':
+            return undefined;
+        default:
+            return `<${expectedType}>`;
+    }
+};
+/**
+ * Custom deep clone implementation for values that structuredClone can't
+ * handle. Used as fallback when structuredClone fails.
+ *
+ * @function
+ */
+const customDeepClone = (value) => {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (isArray(value)) {
+        return value.map(customDeepClone);
+    }
+    if (value instanceof Error) {
+        const cloned = {};
+        for (const [key, val] of entries(value)) {
+            cloned[key] = customDeepClone(val);
+        }
+        for (const prop of getOwnPropertyNames(value)) {
+            if (!(prop in cloned)) {
+                try {
+                    cloned[prop] = value[prop];
+                }
+                catch {
+                    // Skip properties that can't be accessed
+                }
+            }
+        }
+        return cloned;
+    }
+    const cloned = {};
+    for (const [key, val] of entries(value)) {
+        cloned[key] = customDeepClone(val);
+    }
+    return cloned;
+};
+/**
+ * Deep clone a value to avoid mutating the original. Uses the native
+ * structuredClone API which handles more types and circular references better
+ * than a custom implementation. Falls back to custom implementation for values
+ * containing functions.
+ *
+ * @function
+ */
+const deepClone = (value) => {
+    try {
+        return structuredClone(value);
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'DataCloneError') {
+            return customDeepClone(value);
+        }
+        throw error;
+    }
+};
+/**
+ * Gets a value at a specific path in an object
+ *
+ * @function
+ */
+const getValueAtPath = (obj, path) => {
+    if (path.length === 0) {
+        return obj;
+    }
+    let current = obj;
+    for (const key of path) {
+        if (current == null) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+};
+/**
+ * Returns a new object with the value at the specified path set to the given
+ * value.
+ *
+ * @function
+ */
+const setValueAtPath = (obj, path, value) => {
+    if (path.length === 0) {
+        return value;
+    }
+    if (obj == null) {
+        obj = typeof path[0] === 'number' ? [] : {};
+    }
+    const [head, ...tail] = path;
+    if (head === undefined) {
+        return obj;
+    }
+    const newValue = tail.length === 0
+        ? value
+        : setValueAtPath(obj[head], tail, value);
+    if (isArray(obj)) {
+        const result = [...obj];
+        result[head] = newValue;
+        return result;
+    }
+    let result;
+    if (obj instanceof Error) {
+        result = {};
+        for (const prop of getOwnPropertyNames(obj)) {
+            if (prop !== 'stack') {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+                result[prop] = obj[prop];
+            }
+        }
+    }
+    else {
+        result = { ...obj };
+    }
+    result[head] = newValue;
+    return result;
+};
+//# sourceMappingURL=diff.js.map

package/dist/diff.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"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"}

package/dist/diff.d.cts

@@ -0,0 +1,51 @@
+/**
+ * Diff utilities for generating rich assertion failure output.
+ *
+ * This module provides utilities for extracting meaningful actual/expected
+ * values from Zod validation errors and generating high-quality diff output
+ * using `jest-diff` for assertion failures.
+ *
+ * @packageDocumentation
+ * @see {@link https://npm.im/jest-diff | jest-diff}
+ */
+import type { DiffOptions } from 'jest-diff';
+import type { z } from 'zod';
+export type { DiffOptions };
+/**
+ * Result of extracting diff values from a `ZodError`
+ */
+export interface DiffValues {
+    /** The actual value that was validated */
+    actual: unknown;
+    /** The expected value (corrected version) */
+    expected: unknown;
+}
+/**
+ * Extracts actual and expected values from a `ZodError` for meaningful diffs.
+ *
+ * @function
+ * @param zodError The `ZodError` to extract values from
+ * @param subject The original subject that failed validation
+ * @returns Object with actual and expected values for diff
+ */
+export declare const extractDiffValues: (zodError: z.ZodError, subject: unknown) => DiffValues;
+/**
+ * Generates a rich diff string using jest-diff for assertion failures.
+ *
+ * @function
+ * @param expected The expected value
+ * @param actual The actual value
+ * @param options Configuration options for diff generation
+ * @returns A formatted diff string, or null if values are identical
+ */
+export declare const generateDiff: (expected: unknown, actual: unknown, options?: DiffOptions) => null | string;
+/**
+ * Checks if two values should generate a meaningful diff.
+ *
+ * @function
+ * @param actual The actual value
+ * @param expected The expected value
+ * @returns True if a diff should be generated, false otherwise
+ */
+export declare const shouldGenerateDiff: (actual: unknown, expected: unknown) => boolean;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,YAAY,EAAE,WAAW,EAAE,CAAC;AAO5B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,CAAC,CAAC,QAAQ,EACpB,SAAS,OAAO,KACf,UAkJF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,OAAO,EACjB,QAAQ,OAAO,EACf,UAAS,WAAgB,KACxB,IAAI,GAAG,MAYT,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,OAAO,EACf,UAAU,OAAO,KAChB,OACoE,CAAC"}

package/dist/diff.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Diff utilities for generating rich assertion failure output.
+ *
+ * This module provides utilities for extracting meaningful actual/expected
+ * values from Zod validation errors and generating high-quality diff output
+ * using `jest-diff` for assertion failures.
+ *
+ * @packageDocumentation
+ * @see {@link https://npm.im/jest-diff | jest-diff}
+ */
+import type { DiffOptions } from 'jest-diff';
+import type { z } from 'zod';
+export type { DiffOptions };
+/**
+ * Result of extracting diff values from a `ZodError`
+ */
+export interface DiffValues {
+    /** The actual value that was validated */
+    actual: unknown;
+    /** The expected value (corrected version) */
+    expected: unknown;
+}
+/**
+ * Extracts actual and expected values from a `ZodError` for meaningful diffs.
+ *
+ * @function
+ * @param zodError The `ZodError` to extract values from
+ * @param subject The original subject that failed validation
+ * @returns Object with actual and expected values for diff
+ */
+export declare const extractDiffValues: (zodError: z.ZodError, subject: unknown) => DiffValues;
+/**
+ * Generates a rich diff string using jest-diff for assertion failures.
+ *
+ * @function
+ * @param expected The expected value
+ * @param actual The actual value
+ * @param options Configuration options for diff generation
+ * @returns A formatted diff string, or null if values are identical
+ */
+export declare const generateDiff: (expected: unknown, actual: unknown, options?: DiffOptions) => null | string;
+/**
+ * Checks if two values should generate a meaningful diff.
+ *
+ * @function
+ * @param actual The actual value
+ * @param expected The expected value
+ * @returns True if a diff should be generated, false otherwise
+ */
+export declare const shouldGenerateDiff: (actual: unknown, expected: unknown) => boolean;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,YAAY,EAAE,WAAW,EAAE,CAAC;AAO5B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,CAAC,CAAC,QAAQ,EACpB,SAAS,OAAO,KACf,UAkJF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,OAAO,EACjB,QAAQ,OAAO,EACf,UAAS,WAAgB,KACxB,IAAI,GAAG,MAYT,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,OAAO,EACf,UAAU,OAAO,KAChB,OACoE,CAAC"}