docs: getting calls of a specified command readme and jsdoc

README.md

@@ -34,6 +34,7 @@ In action:
     - [DynamoDB DocumentClient](#dynamodb-documentclient)
     - [Lib Storage Upload](#lib-storage-upload)
     - [Paginated operations](#paginated-operations)
+  - [Inspect](#inspect)
 - [API Reference](#api-reference)
 - [AWS Lambda example](#aws-lambda-example)
 - [Caveats](#caveats)
@@ -212,20 +213,6 @@ snsMock
     });
 ```
 
-Inspect received calls:
-
-```typescript
-snsMock.calls(); // all received calls
-snsMock.call(0); // first received call
-```
-
-Under the hood, the library uses [Sinon.js](https://sinonjs.org/) `stub`.
-You can get the stub instance to configure and use it directly:
-
-```typescript
-const snsSendStub = snsMock.send;
-```
-
 #### DynamoDB DocumentClient
 
 You can mock the `DynamoDBDocumentClient` just like any other Client:
@@ -299,6 +286,35 @@ for await (const page of paginator) {
 }
 ```
 
+### Inspect
+
+Inspect received calls:
+
+```typescript
+snsMock.calls(); // all received calls
+snsMock.call(0); // first received call
+```
+
+Get calls of a specified command:
+
+```typescript
+snsMock.commandCalls(PublishCommand)
+```
+
+Get calls of a specified command with given payload
+(you can force strict matching by passing third param `strict: true`):
+
+```typescript
+snsMock.commandCalls(PublishCommand, {Message: 'My message'})
+```
+
+Under the hood, the library uses [Sinon.js](https://sinonjs.org/) `stub`.
+You can get the stub instance to configure and use it directly:
+
+```typescript
+const snsSendStub = snsMock.send;
+```
+
 ## API Reference
 
 See the [full API Reference](https://m-radzikowski.github.io/aws-sdk-client-mock/).

src/awsClientStub.ts

@@ -89,6 +89,12 @@ export class AwsStub<TInput extends object, TOutput extends MetadataBearer> impl
         return this.send.getCall(n);
     }
 
+    /**
+     * Returns recorded calls of given Command only.
+     * @param commandType Command type to match
+     * @param input Command payload to match
+     * @param strict Should the payload match strictly (default false, will match if all defined payload properties match)
+     */
     commandCalls<TCmd extends AwsCommand<any, any>,
         TCmdInput extends TCmd extends AwsCommand<infer TIn, any> ? TIn : never,
         TCmdOutput extends TCmd extends AwsCommand<any, infer TOut> ? TOut : never,