@fgv/ts-utils-jest 5.0.0-22 → 5.0.0-24

package/CHANGELOG.json

@@ -1,21 +1,6 @@
 {
   "name": "@fgv/ts-utils-jest",
   "entries": [
-    {
-      "version": "5.0.0",
-      "tag": "@fgv/ts-utils-jest_v5.0.0",
-      "date": "Thu, 17 Jul 2025 00:13:24 GMT",
-      "comments": {
-        "none": [
-          {
-            "comment": "minor fixes"
-          },
-          {
-            "comment": "bump version"
-          }
-        ]
-      }
-    },
     {
       "version": "4.6.0",
       "tag": "@fgv/ts-utils-jest_v4.6.0",

package/lib/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.52.10"
+      "packageVersion": "7.52.11"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-utils-jest",
-  "version": "5.0.0-22",
+  "version": "5.0.0-24",
   "description": "Custom matchers for ts-utils result class",
   "main": "lib/index.js",
   "keywords": [
@@ -34,18 +34,18 @@
     "rimraf": "^5.0.7",
     "ts-jest": "^29.4.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.3",
-    "@rushstack/heft": "~0.74.2",
-    "@rushstack/eslint-config": "~4.4.0",
-    "@rushstack/heft-jest-plugin": "~0.16.11",
-    "@rushstack/heft-node-rig": "~2.9.3",
+    "typescript": "5.8.3",
+    "@rushstack/heft": "0.74.3",
+    "@rushstack/eslint-config": "4.4.0",
+    "@rushstack/heft-jest-plugin": "0.16.12",
+    "@rushstack/heft-node-rig": "2.9.4",
     "@types/heft-jest": "1.0.6",
     "eslint-plugin-n": "^16.6.2",
     "eslint-plugin-tsdoc": "~0.4.0",
-    "@fgv/ts-utils": "5.0.0-22"
+    "@fgv/ts-utils": "5.0.0-24"
   },
   "peerDependencies": {
-    "@fgv/ts-utils": "5.0.0-22"
+    "@fgv/ts-utils": "5.0.0-24"
   },
   "scripts": {
     "build": "heft build --clean",

package/.vscode/launch.json

@@ -1,16 +0,0 @@
-{
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Launch Program",
-      "skipFiles": ["<node_internals>/**"],
-      "program": "${workspaceFolder}/src/matchers/toHaveBeenCalledWithArgumentsMatching/index.test.ts",
-      "outFiles": ["${workspaceFolder}/**/*.js"]
-    }
-  ]
-}

package/dist/ts-utils-jest.d.ts

@@ -1,66 +0,0 @@
-/**
- * @public
- */
-declare interface IMockFileConfig {
-    path: string;
-    backingFile?: string;
-    payload?: string;
-    writable?: boolean;
-}
-
-/**
- * @public
- */
-declare interface IMockFileSystemOptions {
-    mockWriteOnly?: boolean;
-    allowUnknownMockWrite?: boolean;
-}
-
-/**
- * @public
- */
-declare class MockFileSystem {
-    protected readonly _options?: IMockFileSystemOptions;
-    protected readonly _config: Map<string, IMockFileConfig>;
-    protected readonly _data: Map<string, string>;
-    protected readonly _realReadFileSync: ReadFunc;
-    protected readonly _extraWrites: string[];
-    constructor(configs: Iterable<IMockFileConfig>, options?: IMockFileSystemOptions);
-    readMockFileSync(wanted: string): string;
-    writeMockFileSync(wanted: string, body: string): void;
-    getExtraFilesWritten(): string[];
-    tryGetPayload(want: string): string | undefined;
-    reset(): void;
-    startSpies(): ReadWriteSpies;
-}
-
-declare namespace MockFs {
-    export {
-        IMockFileConfig,
-        ReadWriteSpies,
-        IMockFileSystemOptions,
-        MockFileSystem
-    }
-}
-export { MockFs }
-
-/**
- * @public
- */
-declare type ReadFunc = (path: string | number | Buffer | URL, options?: {
-    encoding?: null;
-    flag?: string;
-} | null) => Buffer;
-
-/**
- * @public
- */
-declare class ReadWriteSpies {
-    readonly read: jest.SpyInstance;
-    readonly write: jest.SpyInstance;
-    constructor(read: jest.SpyInstance, write: jest.SpyInstance);
-    clear(): void;
-    restore(): void;
-}
-
-export { }

package/lib/helpers/fsHelpers.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=fsHelpers.test.d.ts.map

package/lib/index.test.d.ts

@@ -1,2 +0,0 @@
-import './index';
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toFail/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toFail/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toFailTest/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toFailTest/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toFailTestAndMatchSnapshot/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toFailTestAndMatchSnapshot/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toFailTestWith/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toFailTestWith/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toFailWith/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toFailWith/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toFailWithDetail/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toFailWithDetail/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toHaveBeenCalledWithArgumentsMatching/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toHaveBeenCalledWithArgumentsMatching/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toSucceed/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toSucceed/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toSucceedAndMatchInlineSnapshot/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toSucceedAndMatchSnapshot/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toSucceedAndSatisfy/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toSucceedAndSatisfy/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toSucceedWith/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toSucceedWith/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/matchers/toSucceedWithDetail/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/lib/matchers/toSucceedWithDetail/predicate.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=predicate.test.d.ts.map

package/lib/resolvers/resolvers.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=resolvers.test.d.ts.map

package/src/__snapshots__/index.test.ts.snap

@@ -1,24 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`verify matchers accessibility toFailTestAndMatchSnapshot exists and works: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toBe(expected) // Object.is equality
-
-Expected: false
-Received: true"
-`;
-
-exports[`verify matchers accessibility toSucceedAndMatchSnapshot exists and works: toSucceedAndMatchSnapshot 1`] = `
-Object {
-  "child": Object {
-    "values": Array [
-      Object {
-        "number": 1,
-      },
-      Object {
-        "number": 2,
-      },
-    ],
-  },
-  "field": "field",
-}
-`;

package/src/helpers/fsHelpers.ts

@@ -1,184 +0,0 @@
-/*
- * Copyright (c) 2020 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import fs from 'fs';
-import * as path from 'path';
-
-/**
- * @public
- */
-export interface IMockFileConfig {
-  path: string;
-  backingFile?: string;
-  payload?: string;
-  writable?: boolean;
-}
-
-/**
- * @public
- */
-export class ReadWriteSpies {
-  public readonly read: jest.SpyInstance;
-  public readonly write: jest.SpyInstance;
-
-  public constructor(read: jest.SpyInstance, write: jest.SpyInstance) {
-    this.read = read;
-    this.write = write;
-  }
-
-  public clear(): void {
-    this.read.mockClear();
-    this.write.mockClear();
-  }
-
-  public restore(): void {
-    this.read.mockRestore();
-    this.write.mockRestore();
-  }
-}
-
-/**
- * @public
- */
-export interface IMockFileSystemOptions {
-  mockWriteOnly?: boolean;
-  allowUnknownMockWrite?: boolean;
-}
-
-/**
- * @public
- */
-// eslint-disable-next-line @rushstack/no-new-null
-type ReadFunc = (
-  path: string | number | Buffer | URL,
-  // eslint-disable-next-line @rushstack/no-new-null
-  options?: { encoding?: null; flag?: string } | null
-) => Buffer;
-
-/**
- * @public
- */
-export class MockFileSystem {
-  protected readonly _options?: IMockFileSystemOptions;
-  protected readonly _config: Map<string, IMockFileConfig>;
-  protected readonly _data: Map<string, string>;
-  protected readonly _realReadFileSync: ReadFunc;
-  protected readonly _extraWrites: string[] = [];
-
-  public constructor(configs: Iterable<IMockFileConfig>, options?: IMockFileSystemOptions) {
-    this._config = new Map<string, IMockFileConfig>();
-    this._data = new Map<string, string>();
-    this._options = options;
-    this._realReadFileSync = fs.readFileSync;
-
-    for (const config of configs) {
-      const fullPath = path.resolve(config.path);
-      this._config.set(fullPath, config);
-      if (config.backingFile) {
-        this.readMockFileSync(fullPath);
-      } else if (config.payload) {
-        this._data.set(fullPath, config.payload);
-      }
-    }
-  }
-
-  public readMockFileSync(wanted: string): string {
-    const fullPathWanted = path.resolve(wanted);
-    if (!this._data.has(fullPathWanted)) {
-      const config = this._config.get(fullPathWanted);
-      if (config?.backingFile === undefined) {
-        if (this._options?.mockWriteOnly !== true) {
-          throw new Error(`Mock file not found: ${wanted}`);
-        }
-        const body = this._realReadFileSync(fullPathWanted).toString();
-        this._data.set(fullPathWanted, body);
-      } else {
-        const fullBackingPath = path.resolve(config.backingFile);
-        const body = this._realReadFileSync(fullBackingPath).toString();
-        this._data.set(fullPathWanted, body);
-      }
-    }
-
-    const payload = this._data.get(fullPathWanted);
-    // not actually reproducible right now
-    /* c8 ignore next 3 */
-    if (payload === undefined) {
-      throw new Error(`Mock file ${wanted} payload is undefined.`);
-    }
-    return payload;
-  }
-
-  public writeMockFileSync(wanted: string, body: string): void {
-    const fullPathWanted = path.resolve(wanted);
-    const config = this._config.get(fullPathWanted);
-    if (config === undefined) {
-      if (this._options?.allowUnknownMockWrite !== true) {
-        throw new Error(`Mock path not found: ${wanted}`);
-      }
-      this._extraWrites.push(fullPathWanted);
-    } else if (config.writable !== true) {
-      throw new Error(`Mock permission denied: ${wanted}`);
-    }
-    this._data.set(fullPathWanted, body);
-  }
-
-  public getExtraFilesWritten(): string[] {
-    return Array.from(this._extraWrites);
-  }
-  public tryGetPayload(want: string): string | undefined {
-    return this._data.get(path.resolve(want));
-  }
-
-  public reset(): void {
-    const writable = Array.from(this._config.values()).filter((c) => c.writable === true);
-    for (const config of writable) {
-      this._data.delete(path.resolve(config.path));
-      if (config.backingFile) {
-        this.readMockFileSync(path.resolve(config.path));
-      } else if (config.payload) {
-        this._data.set(path.resolve(config.path), config.payload);
-      }
-    }
-
-    for (const path of this._extraWrites) {
-      this._data.delete(path);
-    }
-    this._extraWrites.splice(0, this._extraWrites.length);
-  }
-
-  public startSpies(): ReadWriteSpies {
-    return new ReadWriteSpies(
-      jest.spyOn(fs, 'readFileSync').mockImplementation((wanted: unknown) => {
-        if (typeof wanted !== 'string') {
-          throw new Error('readFileSync mock supports only string parameters');
-        }
-        return this.readMockFileSync(wanted);
-      }),
-      jest.spyOn(fs, 'writeFileSync').mockImplementation((wanted: unknown, payload: unknown) => {
-        if (typeof wanted !== 'string' || typeof payload !== 'string') {
-          throw new Error('writeFileSync mock supports only string parameters');
-        }
-        return this.writeMockFileSync(wanted, payload);
-      })
-    );
-  }
-}

package/src/helpers/index.ts

@@ -1 +0,0 @@
-export * from './fsHelpers';

package/src/index.ts

@@ -1,27 +0,0 @@
-import matchers from './matchers';
-import './types';
-
-import * as MockFs from './helpers/fsHelpers';
-export { MockFs };
-
-// eslint-disable-next-line no-undef
-type JestGlobal = typeof global & { expect: jest.Expect };
-
-// eslint-disable-next-line no-undef
-function isJestGlobal(g: typeof global): g is JestGlobal {
-  return g.hasOwnProperty('expect');
-}
-
-/* c8 ignore else */
-if (isJestGlobal(global)) {
-  global.expect.extend(matchers);
-} else {
-  /* eslint-disable no-console */
-  console.error(
-    [
-      "Unable to find Jest's global expect",
-      'Please check that you have added ts-utils-jest correctly to your jest configuration.'
-    ].join('\n')
-  );
-  /* eslint-enable no-console */
-}

package/src/matchers/index.ts

@@ -1,29 +0,0 @@
-import ToFail from './toFail';
-import ToFailTest from './toFailTest';
-import ToFailTestAndMatchSnapshot from './toFailTestAndMatchSnapshot';
-import ToFailTestWith from './toFailTestWith';
-import ToFailWith from './toFailWith';
-import ToFailWithDetail from './toFailWithDetail';
-import ToHaveBeenCalledWithArgumentsMatching from './toHaveBeenCalledWithArgumentsMatching';
-import ToSucceed from './toSucceed';
-import ToSucceedAndMatchInlineSnapshot from './toSucceedAndMatchInlineSnapshot';
-import ToSucceedAndMatchSnapshot from './toSucceedAndMatchSnapshot';
-import ToSucceedAndSatisfy from './toSucceedAndSatisfy';
-import ToSucceedWith from './toSucceedWith';
-import toSucceedWithDetail from './toSucceedWithDetail';
-
-export default {
-  ...ToFail,
-  ...ToFailTest,
-  ...ToFailTestAndMatchSnapshot,
-  ...ToFailTestWith,
-  ...ToFailWith,
-  ...ToFailWithDetail,
-  ...ToHaveBeenCalledWithArgumentsMatching,
-  ...ToSucceed,
-  ...ToSucceedAndMatchInlineSnapshot,
-  ...ToSucceedAndMatchSnapshot,
-  ...ToSucceedAndSatisfy,
-  ...ToSucceedWith,
-  ...toSucceedWithDetail
-};

package/src/matchers/toFail/__snapshots__/index.test.ts.snap

@@ -1,17 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`.toFail reports details for a failed test with .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).not.toFail(expected)
-Expected:
-  Not failure
-Received:
-  Failure with \\"oops\\""
-`;
-
-exports[`.toFail reports details for a failed test: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toFail(expected)
-Expected:
-  Failure
-Received:
-  Success with \\"hello\\""
-`;

package/src/matchers/toFail/index.ts

@@ -1,45 +0,0 @@
-import { printExpectedResult, printReceivedResult } from '../../utils/matcherHelpers';
-import { matcherName, predicate } from './predicate';
-
-import { Result } from '@fgv/ts-utils';
-import { matcherHint } from 'jest-matcher-utils';
-
-declare global {
-  // eslint-disable-next-line @typescript-eslint/no-namespace
-  namespace jest {
-    // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars,  @typescript-eslint/naming-convention
-    interface Matchers<R, T> {
-      /**
-       * Use .toFail to verify that a Result<T> is a failure
-       */
-      toFail(): R;
-    }
-  }
-}
-
-function passMessage<T extends Result<unknown>>(received: T): () => string {
-  return () =>
-    [
-      matcherHint(`.not.${matcherName}`),
-      printExpectedResult('failure', false),
-      printReceivedResult(received)
-    ].join('\n');
-}
-
-function failMessage<T extends Result<unknown>>(received: T): () => string {
-  return () =>
-    [matcherHint(`${matcherName}`), printExpectedResult('failure', true), printReceivedResult(received)].join(
-      '\n'
-    );
-}
-
-export default {
-  toFail: function <T extends Result<unknown>>(received: T): jest.CustomMatcherResult {
-    const pass = predicate(received);
-    if (pass) {
-      return { pass: true, message: passMessage(received) };
-    }
-
-    return { pass: false, message: failMessage(received) };
-  }
-};

package/src/matchers/toFail/predicate.ts

@@ -1,7 +0,0 @@
-import { Result } from '../../ts-utils';
-
-export const matcherName: string = 'toFail';
-
-export function predicate<T>(received: Result<T>): boolean {
-  return received.isFailure();
-}

package/src/matchers/toFailTest/__snapshots__/index.test.ts.snap

@@ -1,15 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`.toFailTest logs details correctly for a failed .not result: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).not.toFailTest(expected)
-Expected:
-  Not failure
-  Received: Test failed"
-`;
-
-exports[`.toFailTest logs details correctly for a failed result: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).toFailTest(expected)
-Expected:
-  Failure
-  Received: Test passed"
-`;