Add new matcher toHaveReceivedCommandExactlyOnceWith

The new matcher can be used in similar way as
[toHaveBeenCalledExactlyOnceWith][1] of vitest but targeted against
AWS mocks

[1]: vitest-dev/vitest#6894

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- matcher `toHaveReceivedCommandExactlyOnceWith` can be used to verify there are
+  no additional calls
+
 ### Changed
 
 - Update dependencies. This bumps `@vitest/expect` dependency to `^3.0.1`

README.md

@@ -39,7 +39,7 @@ You must register the new matchers explicity (think about putting this to a [set
         },
       });
 
-  to add the custom mat chers before each test run
+  to add the custom matchers before each test run
 */
 import { expect } from "vitest";
 import {
@@ -57,6 +57,8 @@ import {
   toHaveReceivedLastCommandWith,
   toReceiveAnyCommand,
   toHaveReceivedAnyCommand,
+  toReceiveCommandExactlyOnceWith,
+  toHaveReceivedCommandExactlyOnceWith,
 } from "aws-sdk-client-mock-vitest";
 
 expect.extend({
@@ -74,6 +76,8 @@ expect.extend({
   toHaveReceivedLastCommandWith,
   toReceiveAnyCommand,
   toHaveReceivedAnyCommand,
+  toReceiveCommandExactlyOnceWith,
+  toHaveReceivedCommandExactlyOnceWith,
 });
 ```
 

src/index.ts

@@ -2,13 +2,15 @@ export type { CustomMatcher } from './matcher.js';
 export {
   toHaveReceivedAnyCommand,
   toHaveReceivedCommand,
+  toHaveReceivedCommandExactlyOnceWith,
   toHaveReceivedCommandOnce,
   toHaveReceivedCommandTimes,
   toHaveReceivedCommandWith,
   toHaveReceivedLastCommandWith,
   toHaveReceivedNthCommandWith,
   toReceiveAnyCommand,
   toReceiveCommand,
+  toReceiveCommandExactlyOnceWith,
   toReceiveCommandOnce,
   toReceiveCommandTimes,
   toReceiveCommandWith,

src/matcher.ts

@@ -15,6 +15,7 @@ import { notNull, ordinalOf } from './utils.js';
 interface AliasMatcher<R> {
   toReceiveAnyCommand: BaseMatcher<R>['toHaveReceivedAnyCommand'];
   toReceiveCommand: BaseMatcher<R>['toHaveReceivedCommand'];
+  toReceiveCommandExactlyOnceWith: BaseMatcher<R>['toHaveReceivedCommandExactlyOnceWith'];
   toReceiveCommandOnce: BaseMatcher<R>['toHaveReceivedCommandOnce'];
   toReceiveCommandTimes: BaseMatcher<R>['toHaveReceivedCommandTimes'];
   toReceiveCommandWith: BaseMatcher<R>['toHaveReceivedCommandWith'];
@@ -39,6 +40,14 @@ interface BaseMatcher<R> {
     command: AwsCommandConstructur<Input, Output>
   ): R;
 
+  toHaveReceivedCommandExactlyOnceWith<
+    Input extends object,
+    Output extends MetadataBearer,
+  >(
+    command: AwsCommandConstructur<Input, Output>,
+    input: Partial<Input>
+  ): R;
+
   toHaveReceivedCommandOnce<
     Input extends object,
     Output extends MetadataBearer,
@@ -209,9 +218,34 @@ function toHaveReceivedCommandWith(
   };
 };
 const toReceiveCommandWith = toHaveReceivedCommandWith;
-/*
 
-  */
+function toHaveReceivedCommandExactlyOnceWith(
+  this: MatcherState,
+  client: AwsStub<any, any, any>,
+  command: AwsCommandConstructur<any, any>,
+  input: Record<string, any>,
+): ExpectationResult {
+  const { isNot, utils } = this;
+  const calls = client.commandCalls(command);
+
+  const hasCallWithArgs = calls.some(call =>
+    new ObjectContaining(input).asymmetricMatch(call.args[0].input),
+  );
+
+  const pass = calls.length === 1 && hasCallWithArgs;
+
+  return {
+    message: () => {
+      const message = isNot
+        ? `expected "${command.name}" to not be called once with arguments: ${utils.printExpected(input)}`
+        : `expected "${command.name}" to be called once with arguments: ${utils.printExpected(input)}`;
+      return formatCalls(this, client, command, input, message);
+    },
+    pass,
+  };
+};
+const toReceiveCommandExactlyOnceWith = toHaveReceivedCommandExactlyOnceWith;
+
 function toHaveReceivedNthCommandWith(
   this: MatcherState,
   client: AwsStub<any, any, any>,
@@ -289,13 +323,15 @@ export type { CustomMatcher };
 export {
   toHaveReceivedAnyCommand,
   toHaveReceivedCommand,
+  toHaveReceivedCommandExactlyOnceWith,
   toHaveReceivedCommandOnce,
   toHaveReceivedCommandTimes,
   toHaveReceivedCommandWith,
   toHaveReceivedLastCommandWith,
   toHaveReceivedNthCommandWith,
   toReceiveAnyCommand,
   toReceiveCommand,
+  toReceiveCommandExactlyOnceWith,
   toReceiveCommandOnce,
   toReceiveCommandTimes,
   toReceiveCommandWith,

tests/index.test.ts

@@ -5,13 +5,15 @@ import { describe, expect, it } from 'vitest';
 import {
   toHaveReceivedAnyCommand,
   toHaveReceivedCommand,
+  toHaveReceivedCommandExactlyOnceWith,
   toHaveReceivedCommandOnce,
   toHaveReceivedCommandTimes,
   toHaveReceivedCommandWith,
   toHaveReceivedLastCommandWith,
   toHaveReceivedNthCommandWith,
   toReceiveAnyCommand,
   toReceiveCommand,
+  toReceiveCommandExactlyOnceWith,
   toReceiveCommandOnce,
   toReceiveCommandTimes,
   toReceiveCommandWith,
@@ -22,13 +24,15 @@ import {
 expect.extend({
   toHaveReceivedAnyCommand,
   toHaveReceivedCommand,
+  toHaveReceivedCommandExactlyOnceWith,
   toHaveReceivedCommandOnce,
   toHaveReceivedCommandTimes,
   toHaveReceivedCommandWith,
   toHaveReceivedLastCommandWith,
   toHaveReceivedNthCommandWith,
   toReceiveAnyCommand,
   toReceiveCommand,
+  toReceiveCommandExactlyOnceWith,
   toReceiveCommandOnce,
   toReceiveCommandTimes,
   toReceiveCommandWith,
@@ -52,6 +56,8 @@ describe('aws-sdk-client-mock-vitest', () => {
     'toReceiveLastCommandWith',
     'toReceiveNthCommandWith',
     'toReceiveAnyCommand',
+    'toReceiveCommandExactlyOnceWith',
+    'toHaveReceivedCommandExactlyOnceWith',
   ])('extend matcher to extend with %s', (matcher) => {
     expect(expect('something')).toHaveProperty(matcher);
   });