fix for scenario where proxies were interfering with names of objects.

Author: ffMathy

README.md

@@ -130,3 +130,27 @@ console.log(fakeCalculator.divide(9, 5)); //prints 1338
 - Doesn't weigh much.
 - Produces very clean and descriptive error messages. Try it out - you'll love it.
 - Doesn't rely on object instances - you can produce a strong-typed fake from nothing, ensuring that everything is mocked.
+
+# Beware
+Let's say we have a class with a method called `received`, `didNotReceive` or `mimick` keyword - how do we mock it? 
+
+Simple! We disable the proxy methods temporarily while invoking the method by using the `disableFor` method which disables these special methods.
+
+```typescript
+class Example {
+  received(someNumber: number) {
+    console.log(someNumber);
+  }
+}
+
+var fake = Substitute.for<Example>();
+
+//BAD: this would have called substitute.js' "received" method.
+//fake.received(2);
+
+//GOOD: we now call the "received" method we have defined in the class above.
+Substitute.disableFor(fake).received(1337);
+
+//now we can assert that we received a call to the "received" method.
+fake.received().received(1337);
+```

dist/spec/index.test.d.ts

@@ -3,5 +3,6 @@ export declare class Example {
     c(arg1: string, arg2: string): string;
     readonly d: number;
     v: string;
+    received(stuff: number | string): void;
     foo(): string;
 }

dist/spec/index.test.js

@@ -41,7 +41,8 @@ export declare class ProxyObjectContext {
     findActualPropertyCalls(propertyName: string): ProxyCallRecord[];
     findActualMethodCalls(propertyName: string, args?: any[]): ProxyCallRecord[];
     getLastCall(): ProxyCallRecord;
-    addActualPropertyCall(): void;
+    removeActualPropertyCall(call: ProxyCallRecord): void;
+    addActualPropertyCall(): ProxyCallRecord;
     fixExistingCallArguments(): void;
 }
 export declare class ProxyCallRecord {

dist/spec/index.test.js.map

@@ -1,5 +1,4 @@
 import { Substitute } from './Substitute';
-export { ObjectSubstitute, PropertySubstitute, FunctionSubstitute } from './Transformations';
 export { Arg } from './Arguments';
 export { Substitute };
 export default Substitute;

dist/src/Context.d.ts

@@ -1,5 +1,6 @@
-import { ObjectSubstitute } from "./Transformations";
+import { ObjectSubstitute, OmitProxyMethods, DisabledSubstituteObject } from "./Transformations";
 export declare class Substitute {
-    static for<T>(): ObjectSubstitute<T>;
+    static disableFor<T extends ObjectSubstitute<OmitProxyMethods<any>>>(substitute: T): DisabledSubstituteObject<T>;
+    static for<T>(): ObjectSubstitute<OmitProxyMethods<T>, T>;
     private static assertCallMatchCount;
 }