bupkis 0.18.1 → 0.18.3

package/dist/snapshot/adapters/node-test.cjs

@@ -1,301 +0,0 @@
-"use strict";
-/**
- * Adapter for node:test's built-in snapshot support.
- *
- * Node.js native test runner includes snapshot testing capabilities as of
- * Node.js v22. This adapter delegates to node:test's native `assert.snapshot()`
- * function while providing the unified BUPKIS snapshot interface.
- *
- * @packageDocumentation
- * @see https://nodejs.org/api/test.html#snapshots
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nodeTestAdapter = exports.NodeTestAdapter = void 0;
-const node_assert_1 = require("node:assert");
-const node_util_1 = require("node:util");
-const guards_js_1 = require("../../guards.cjs");
-const adapter_js_1 = require("../adapter.cjs");
-const node_version_js_1 = require("../node-version.cjs");
-const serializer_js_1 = require("../serializer.cjs");
-/**
- * Adapter for node:test snapshot support.
- *
- * This adapter leverages node:test's native snapshot functionality while
- * providing the unified BUPKIS snapshot interface. It's the preferred adapter
- * when running tests with node:test.
- *
- * **Features:**
- *
- * - Delegates to native `assert.snapshot()`
- * - Supports custom serializers
- * - Automatically detects update mode from CLI flags
- * - Zero configuration required
- *
- * **Detection:** The adapter detects node:test by checking for
- * `context.assert.snapshot`.
- *
- * **Update Mode:** Respects the `--test-update-snapshots` flag.
- *
- * @example
- *
- * ```typescript
- * import test from 'node:test';
- * import { expect } from 'bupkis';
- *
- * test('renders component', (t) => {
- *   const output = render(<MyComponent />);
- *   expect(output, 'to match snapshot', t);
- * });
- * ```
- *
- * @example
- *
- * ```typescript
- * // With custom serializer
- * test('redacts secrets', (t) => {
- *   const data = { public: 'visible', secret: 'password123' };
- *   expect(data, 'to match snapshot', t, {
- *     serializer: (value: any) =>
- *       JSON.stringify({ ...value, secret: '[REDACTED]' }, null, 2),
- *   });
- * });
- * ```
- */
-class NodeTestAdapter {
-    /**
-     * Adapter name for identification and debugging.
-     */
-    name = 'node:test';
-    /**
-     * Check if this adapter can handle the given context.
-     *
-     * Returns `true` if the context has the structure of a node:test context,
-     * specifically checking for `context.assert.snapshot`.
-     *
-     * @param context - Test context to check
-     * @returns `true` if this is a node:test context
-     * @throws {Error} If running on Node.js < 22 with a node:test context
-     */
-    canHandle(context) {
-        if (looksLikeNodeTestContext(context) && !isNodeTestContext(context)) {
-            (0, node_version_js_1.assertNodeVersion)();
-        }
-        return isNodeTestContext(context);
-    }
-    /**
-     * Extract snapshot context from node:test context.
-     *
-     * Extracts:
-     *
-     * - **testPath**: The test name from `context.name`
-     * - **filePath**: Extracted from stack trace
-     * - **isUpdateMode**: Detected from `--test-update-snapshots` flag
-     *
-     * @param context - Node:test context object
-     * @returns Normalized snapshot context
-     * @throws {TypeError} If context is not a valid node:test context
-     */
-    getContext(context) {
-        if (!isNodeTestContext(context)) {
-            throw new TypeError('Invalid node:test context');
-        }
-        return {
-            filePath: getTestFilePathFromStack(),
-            isUpdateMode: isNodeTestUpdateMode(),
-            testPath: context.name,
-        };
-    }
-    /**
-     * Perform snapshot assertion using node:test's native functionality.
-     *
-     * This method delegates to `context.assert.snapshot()`, which handles:
-     *
-     * - Snapshot file creation and management
-     * - Snapshot comparison
-     * - Update mode behavior
-     * - Error messages and diffs
-     *
-     * If a custom serializer is provided in options, it will be passed to
-     * node:test as a serializer function.
-     *
-     * @example
-     *
-     * ```typescript
-     * const adapter = new NodeTestAdapter();
-     * adapter.assertSnapshot({ foo: 'bar' }, testContext);
-     * ```
-     *
-     * @param value - Value to snapshot
-     * @param context - Node:test context object
-     * @param options - Optional serialization options
-     * @throws {TypeError} If context is not a valid node:test context
-     * @throws {AssertionError} If snapshot doesn't match (via node:test)
-     */
-    validateSnapshot(value, context, options) {
-        if (!isNodeTestContext(context)) {
-            throw new TypeError('Invalid node:test context');
-        }
-        // Use custom serializer if provided, otherwise use default serializer
-        // to handle circular references and special types
-        const serializers = options?.serializer
-            ? [options.serializer]
-            : [serializer_js_1.defaultSerializer];
-        try {
-            // Build snapshot options - include hint as name if provided
-            const snapshotOptions = { serializers };
-            if (options?.hint) {
-                snapshotOptions.name = options.hint;
-            }
-            context.assert.snapshot(value, snapshotOptions);
-        }
-        catch (err) {
-            if (isNodeAssertionError(err)) {
-                return {
-                    actual: err.actual,
-                    expected: err.expected,
-                    message: err.message,
-                };
-            }
-            if ((0, guards_js_1.isError)(err)) {
-                return {
-                    message: err.message,
-                };
-            }
-            return {
-                message: (0, node_util_1.inspect)(err),
-            };
-        }
-    }
-}
-exports.NodeTestAdapter = NodeTestAdapter;
-/**
- * Extract the test file path from the stack trace.
- *
- * This is a fallback method used when the test context doesn't provide the file
- * path directly. It searches the stack trace for lines that look like test file
- * paths (containing `.test.` or `.spec.`).
- *
- * @example
- *
- * ```typescript
- * // If called from /path/to/my.test.ts, returns '/path/to/my.test.ts'
- * const filePath = getTestFilePathFromStack();
- * ```
- *
- * @function
- * @returns Absolute file path, or 'unknown' if not found
- */
-const getTestFilePathFromStack = () => {
-    const stack = new Error().stack || '';
-    const lines = stack.split('\n');
-    // Look for first line that looks like a test file
-    for (const line of lines) {
-        const match = line.match(/\((.+\.(?:test|spec)\.[jt]s):\d+:\d+\)/);
-        if (match && match[1]) {
-            return match[1];
-        }
-    }
-    return 'unknown';
-};
-/**
- * Check if a value looks like a node:test context (has `name` and `assert`
- * properties).
- *
- * This is used to detect when someone is passing a node:test context on an
- * older Node.js version that doesn't support `assert.snapshot`.
- *
- * @function
- * @param value - Value to check
- * @returns `true` if value looks like a node:test context
- */
-const looksLikeNodeTestContext = (value) => {
-    return ((0, adapter_js_1.isTestContext)(value) &&
-        'name' in value &&
-        typeof value.name === 'string' &&
-        'assert' in value &&
-        typeof value.assert === 'object' &&
-        value.assert !== null);
-};
-/**
- * Type guard for node:test context.
- *
- * Checks if the given value is a valid node:test test context by verifying the
- * presence of required properties.
- *
- * @example
- *
- * ```typescript
- * if (isNodeTestContext(context)) {
- *   context.assert.snapshot(value);
- * }
- * ```
- *
- * @function
- * @param value - Value to check
- * @returns `true` if value is a node:test context
- */
-const isNodeTestContext = (value) => {
-    return ((0, adapter_js_1.isTestContext)(value) &&
-        'assert' in value &&
-        typeof value.assert === 'object' &&
-        value.assert !== null &&
-        'snapshot' in value.assert &&
-        typeof value.assert.snapshot === 'function');
-};
-/**
- * Check if we're running in node:test update mode.
- *
- * Node:test uses the `--test-update-snapshots` flag to indicate that snapshots
- * should be updated rather than compared. This function also respects the
- * `BUPKIS_UPDATE_SNAPSHOTS` environment variable for consistency with other
- * adapters.
- *
- * This function checks:
- *
- * 1. `process.execArgv` (flags passed to Node.js)
- * 2. `process.argv` (arguments passed to the script)
- * 3. `BUPKIS_UPDATE_SNAPSHOTS` environment variable
- *
- * @example
- *
- * ```sh
- * # These commands will trigger update mode:
- * node --test --test-update-snapshots
- * node --test-update-snapshots=true --test test.js
- * BUPKIS_UPDATE_SNAPSHOTS=1 node --test
- * ```
- *
- * @function
- * @returns `true` if in update mode
- */
-const isNodeTestUpdateMode = () => {
-    // Check for BUPKIS_UPDATE_SNAPSHOTS environment variable
-    if (process.env.BUPKIS_UPDATE_SNAPSHOTS === '1') {
-        return true;
-    }
-    // Check for --test-update-snapshots flag in exec args or argv
-    return (process.execArgv.some((arg) => arg === '--test-update-snapshots' ||
-        arg.startsWith('--test-update-snapshots=')) ||
-        process.argv.some((arg) => arg === '--test-update-snapshots' ||
-            arg.startsWith('--test-update-snapshots=')));
-};
-/**
- * Singleton instance of the node:test adapter.
- *
- * This is the primary export and should be used for adapter registration.
- *
- * @example
- *
- * ```typescript
- * import { nodeTestAdapter } from 'bupkis/snapshot';
- * import { registerAdapter } from 'bupkis/snapshot';
- *
- * registerAdapter(nodeTestAdapter);
- * ```
- */
-exports.nodeTestAdapter = new NodeTestAdapter();
-/**
- * @function
- */
-const isNodeAssertionError = (value) => (0, guards_js_1.isA)(value, node_assert_1.AssertionError);
-//# sourceMappingURL=node-test.js.map

package/dist/snapshot/adapters/node-test.cjs.map

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

package/dist/snapshot/adapters/node-test.d.cts

@@ -1,131 +0,0 @@
-/**
- * Adapter for node:test's built-in snapshot support.
- *
- * Node.js native test runner includes snapshot testing capabilities as of
- * Node.js v22. This adapter delegates to node:test's native `assert.snapshot()`
- * function while providing the unified BUPKIS snapshot interface.
- *
- * @packageDocumentation
- * @see https://nodejs.org/api/test.html#snapshots
- */
-import { type TestContext } from 'node:test';
-import type { SnapshotAdapter, SnapshotContext, SnapshotOptions } from "../adapter.cjs";
-import { type AssertionFailure } from "../../types.cjs";
-/**
- * Adapter for node:test snapshot support.
- *
- * This adapter leverages node:test's native snapshot functionality while
- * providing the unified BUPKIS snapshot interface. It's the preferred adapter
- * when running tests with node:test.
- *
- * **Features:**
- *
- * - Delegates to native `assert.snapshot()`
- * - Supports custom serializers
- * - Automatically detects update mode from CLI flags
- * - Zero configuration required
- *
- * **Detection:** The adapter detects node:test by checking for
- * `context.assert.snapshot`.
- *
- * **Update Mode:** Respects the `--test-update-snapshots` flag.
- *
- * @example
- *
- * ```typescript
- * import test from 'node:test';
- * import { expect } from 'bupkis';
- *
- * test('renders component', (t) => {
- *   const output = render(<MyComponent />);
- *   expect(output, 'to match snapshot', t);
- * });
- * ```
- *
- * @example
- *
- * ```typescript
- * // With custom serializer
- * test('redacts secrets', (t) => {
- *   const data = { public: 'visible', secret: 'password123' };
- *   expect(data, 'to match snapshot', t, {
- *     serializer: (value: any) =>
- *       JSON.stringify({ ...value, secret: '[REDACTED]' }, null, 2),
- *   });
- * });
- * ```
- */
-export declare class NodeTestAdapter implements SnapshotAdapter {
-    /**
-     * Adapter name for identification and debugging.
-     */
-    readonly name = "node:test";
-    /**
-     * Check if this adapter can handle the given context.
-     *
-     * Returns `true` if the context has the structure of a node:test context,
-     * specifically checking for `context.assert.snapshot`.
-     *
-     * @param context - Test context to check
-     * @returns `true` if this is a node:test context
-     * @throws {Error} If running on Node.js < 22 with a node:test context
-     */
-    canHandle(context: unknown): boolean;
-    /**
-     * Extract snapshot context from node:test context.
-     *
-     * Extracts:
-     *
-     * - **testPath**: The test name from `context.name`
-     * - **filePath**: Extracted from stack trace
-     * - **isUpdateMode**: Detected from `--test-update-snapshots` flag
-     *
-     * @param context - Node:test context object
-     * @returns Normalized snapshot context
-     * @throws {TypeError} If context is not a valid node:test context
-     */
-    getContext(context: unknown): SnapshotContext;
-    /**
-     * Perform snapshot assertion using node:test's native functionality.
-     *
-     * This method delegates to `context.assert.snapshot()`, which handles:
-     *
-     * - Snapshot file creation and management
-     * - Snapshot comparison
-     * - Update mode behavior
-     * - Error messages and diffs
-     *
-     * If a custom serializer is provided in options, it will be passed to
-     * node:test as a serializer function.
-     *
-     * @example
-     *
-     * ```typescript
-     * const adapter = new NodeTestAdapter();
-     * adapter.assertSnapshot({ foo: 'bar' }, testContext);
-     * ```
-     *
-     * @param value - Value to snapshot
-     * @param context - Node:test context object
-     * @param options - Optional serialization options
-     * @throws {TypeError} If context is not a valid node:test context
-     * @throws {AssertionError} If snapshot doesn't match (via node:test)
-     */
-    validateSnapshot(value: unknown, context: TestContext, options?: SnapshotOptions): AssertionFailure | void;
-}
-/**
- * Singleton instance of the node:test adapter.
- *
- * This is the primary export and should be used for adapter registration.
- *
- * @example
- *
- * ```typescript
- * import { nodeTestAdapter } from 'bupkis/snapshot';
- * import { registerAdapter } from 'bupkis/snapshot';
- *
- * registerAdapter(nodeTestAdapter);
- * ```
- */
-export declare const nodeTestAdapter: NodeTestAdapter;
-//# sourceMappingURL=node-test.d.ts.map

package/dist/snapshot/adapters/node-test.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-test.d.ts","sourceRoot":"","sources":["../../../src/snapshot/adapters/node-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EAChB,uBAAsB;AAGvB,OAAO,EAAE,KAAK,gBAAgB,EAAE,wBAAuB;AAwBvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD;;OAEG;IACH,QAAQ,CAAC,IAAI,eAAe;IAE5B;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAOpC;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe;IAY7C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gBAAgB,CACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB,GAAG,IAAI;CAyC3B;AAoID;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/snapshot/adapters/node-test.d.ts

@@ -1,131 +0,0 @@
-/**
- * Adapter for node:test's built-in snapshot support.
- *
- * Node.js native test runner includes snapshot testing capabilities as of
- * Node.js v22. This adapter delegates to node:test's native `assert.snapshot()`
- * function while providing the unified BUPKIS snapshot interface.
- *
- * @packageDocumentation
- * @see https://nodejs.org/api/test.html#snapshots
- */
-import { type TestContext } from 'node:test';
-import type { SnapshotAdapter, SnapshotContext, SnapshotOptions } from "../adapter.js";
-import { type AssertionFailure } from "../../types.js";
-/**
- * Adapter for node:test snapshot support.
- *
- * This adapter leverages node:test's native snapshot functionality while
- * providing the unified BUPKIS snapshot interface. It's the preferred adapter
- * when running tests with node:test.
- *
- * **Features:**
- *
- * - Delegates to native `assert.snapshot()`
- * - Supports custom serializers
- * - Automatically detects update mode from CLI flags
- * - Zero configuration required
- *
- * **Detection:** The adapter detects node:test by checking for
- * `context.assert.snapshot`.
- *
- * **Update Mode:** Respects the `--test-update-snapshots` flag.
- *
- * @example
- *
- * ```typescript
- * import test from 'node:test';
- * import { expect } from 'bupkis';
- *
- * test('renders component', (t) => {
- *   const output = render(<MyComponent />);
- *   expect(output, 'to match snapshot', t);
- * });
- * ```
- *
- * @example
- *
- * ```typescript
- * // With custom serializer
- * test('redacts secrets', (t) => {
- *   const data = { public: 'visible', secret: 'password123' };
- *   expect(data, 'to match snapshot', t, {
- *     serializer: (value: any) =>
- *       JSON.stringify({ ...value, secret: '[REDACTED]' }, null, 2),
- *   });
- * });
- * ```
- */
-export declare class NodeTestAdapter implements SnapshotAdapter {
-    /**
-     * Adapter name for identification and debugging.
-     */
-    readonly name = "node:test";
-    /**
-     * Check if this adapter can handle the given context.
-     *
-     * Returns `true` if the context has the structure of a node:test context,
-     * specifically checking for `context.assert.snapshot`.
-     *
-     * @param context - Test context to check
-     * @returns `true` if this is a node:test context
-     * @throws {Error} If running on Node.js < 22 with a node:test context
-     */
-    canHandle(context: unknown): boolean;
-    /**
-     * Extract snapshot context from node:test context.
-     *
-     * Extracts:
-     *
-     * - **testPath**: The test name from `context.name`
-     * - **filePath**: Extracted from stack trace
-     * - **isUpdateMode**: Detected from `--test-update-snapshots` flag
-     *
-     * @param context - Node:test context object
-     * @returns Normalized snapshot context
-     * @throws {TypeError} If context is not a valid node:test context
-     */
-    getContext(context: unknown): SnapshotContext;
-    /**
-     * Perform snapshot assertion using node:test's native functionality.
-     *
-     * This method delegates to `context.assert.snapshot()`, which handles:
-     *
-     * - Snapshot file creation and management
-     * - Snapshot comparison
-     * - Update mode behavior
-     * - Error messages and diffs
-     *
-     * If a custom serializer is provided in options, it will be passed to
-     * node:test as a serializer function.
-     *
-     * @example
-     *
-     * ```typescript
-     * const adapter = new NodeTestAdapter();
-     * adapter.assertSnapshot({ foo: 'bar' }, testContext);
-     * ```
-     *
-     * @param value - Value to snapshot
-     * @param context - Node:test context object
-     * @param options - Optional serialization options
-     * @throws {TypeError} If context is not a valid node:test context
-     * @throws {AssertionError} If snapshot doesn't match (via node:test)
-     */
-    validateSnapshot(value: unknown, context: TestContext, options?: SnapshotOptions): AssertionFailure | void;
-}
-/**
- * Singleton instance of the node:test adapter.
- *
- * This is the primary export and should be used for adapter registration.
- *
- * @example
- *
- * ```typescript
- * import { nodeTestAdapter } from 'bupkis/snapshot';
- * import { registerAdapter } from 'bupkis/snapshot';
- *
- * registerAdapter(nodeTestAdapter);
- * ```
- */
-export declare const nodeTestAdapter: NodeTestAdapter;
-//# sourceMappingURL=node-test.d.ts.map

package/dist/snapshot/adapters/node-test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-test.d.ts","sourceRoot":"","sources":["../../../src/snapshot/adapters/node-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EAChB,sBAAsB;AAGvB,OAAO,EAAE,KAAK,gBAAgB,EAAE,uBAAuB;AAwBvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD;;OAEG;IACH,QAAQ,CAAC,IAAI,eAAe;IAE5B;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAOpC;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe;IAY7C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gBAAgB,CACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB,GAAG,IAAI;CAyC3B;AAoID;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}