@zudojs/testing 1.2.0 → 1.2.2

package/README.md

@@ -206,6 +206,14 @@ own, and `logger: createLogger({ name })` from `@zudojs/logger` prints.
 - `createStub()` hands back the same no-op for a given property every time,
   so `stub.handler === stub.handler` and a register/unregister pair written
   against a stub actually unregisters.
+- The overrides passed to `createStub()` are the stub's own enumerable
+  properties, so `Object.keys(stub)`, `{ ...stub }` and
+  `expect.objectContaining({ send })` see them. The unstubbed no-ops are
+  answered on access only and are not own keys. `asymmetricMatch` is answered
+  with `undefined`, so Vitest's `equals` does not mistake a stub for a matcher.
+- `createSpyMethod(...).restore()` only puts the original method back. The
+  recorded `calls`, `results` and `errors` are kept, so you can assert on them
+  after restoring. Calls made after `restore()` are not recorded.
 - `InMemoryTestStorage.set(key, value, 0)` means "already expired", not "no
   expiry"; only an omitted TTL (or `Infinity`) never expires, and a `NaN` TTL
   throws. `delete()` returns `false` for an entry that has already expired.

package/dist/mocking/spy.core.d.ts

@@ -49,7 +49,11 @@ export interface SpyMethod<TObj, TMethod extends keyof TObj> {
     readonly results: readonly unknown[];
     readonly errors: readonly unknown[];
     readonly callCount: number;
-    /** Reinstates the original method exactly as it was found. */
+    /**
+     * Reinstates the original method exactly as it was found. The recorded
+     * `calls`, `results` and `errors` are kept, so they can be asserted after
+     * restoring; calls made after `restore()` are not recorded.
+     */
     restore: () => void;
 }
 /**
@@ -69,6 +73,7 @@ export interface SpyMethod<TObj, TMethod extends keyof TObj> {
  * expect(spy.calls).toHaveLength(1);
  *
  * spy.restore();
+ * expect(spy.calls).toHaveLength(1); // still recorded after restore
  * ```
  */
 export declare function createSpyMethod<TObj, TMethod extends keyof TObj>(object: TObj, property: TMethod): SpyMethod<TObj, TMethod>;

package/dist/mocking/spy.core.js

@@ -77,6 +77,7 @@ export function createSpyFn(fn) {
  * expect(spy.calls).toHaveLength(1);
  *
  * spy.restore();
+ * expect(spy.calls).toHaveLength(1); // still recorded after restore
  * ```
  */
 export function createSpyMethod(object, property) {
@@ -120,9 +121,6 @@ export function createSpyMethod(object, property) {
                 target[key] = original;
             else
                 delete target[key];
-            calls.length = 0;
-            results.length = 0;
-            errors.length = 0;
         },
     };
 }

package/dist/mocking/stub.core.d.ts

@@ -7,7 +7,9 @@
  * Creates a stub object from an interface.
  *
  * All methods return undefined by default. Override specific methods
- * by passing an overrides object.
+ * by passing an overrides object. The overrides are the stub's own
+ * enumerable properties, so `Object.keys(stub)`, `{ ...stub }` and
+ * `expect.objectContaining` see them; unstubbed no-ops are not own keys.
  *
  * @typeParam T - The interface type to stub.
  * @param overrides - Optional method implementations.

package/dist/mocking/stub.core.js

@@ -8,12 +8,14 @@
  *
  * `then` is the important one: answering it makes the stub a thenable, so
  * `await stub` calls it expecting a promise callback. The fake never resolves,
- * and the test hangs until it times out with no indication why.
+ * and the test hangs until it times out with no indication why. Likewise
+ * `asymmetricMatch` makes Vitest's `equals` treat the stub as a matcher.
  */
 const NON_CALLABLE_KEYS = new Set([
     "then",
     "catch",
     "finally",
+    "asymmetricMatch",
     Symbol.toPrimitive,
     Symbol.iterator,
     Symbol.asyncIterator,
@@ -23,7 +25,9 @@ const NON_CALLABLE_KEYS = new Set([
  * Creates a stub object from an interface.
  *
  * All methods return undefined by default. Override specific methods
- * by passing an overrides object.
+ * by passing an overrides object. The overrides are the stub's own
+ * enumerable properties, so `Object.keys(stub)`, `{ ...stub }` and
+ * `expect.objectContaining` see them; unstubbed no-ops are not own keys.
  *
  * @typeParam T - The interface type to stub.
  * @param overrides - Optional method implementations.
@@ -69,6 +73,15 @@ export function createStub(overrides = {}) {
         has(_target, prop) {
             return !NON_CALLABLE_KEYS.has(prop);
         },
+        ownKeys() {
+            return Reflect.ownKeys(overrides);
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(overrides, prop);
+            return descriptor === undefined
+                ? undefined
+                : { ...descriptor, configurable: true };
+        },
     });
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/testing",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Test helpers, fixtures, mocks, and utilities for testing Zudojs applications.",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,19 +19,19 @@
     "!dist/.tsbuildinfo"
   ],
   "dependencies": {
-    "@zudojs/config": "1.3.0",
+    "@zudojs/config": "1.3.1",
     "@zudojs/constants": "1.1.2",
-    "@zudojs/container": "1.2.0",
+    "@zudojs/container": "1.2.1",
     "@zudojs/errors": "1.3.0",
-    "@zudojs/events": "1.3.0",
-    "@zudojs/http": "1.4.0",
-    "@zudojs/logger": "1.4.0",
-    "@zudojs/messaging": "1.2.0",
+    "@zudojs/events": "1.3.1",
+    "@zudojs/http": "1.4.2",
+    "@zudojs/logger": "1.4.1",
+    "@zudojs/messaging": "1.2.1",
     "@zudojs/middleware": "1.1.0",
-    "@zudojs/queue": "1.4.0",
-    "@zudojs/security": "1.3.0",
-    "@zudojs/serialization": "1.2.0",
-    "@zudojs/storage": "1.2.0",
+    "@zudojs/queue": "1.4.1",
+    "@zudojs/security": "1.3.1",
+    "@zudojs/serialization": "1.2.1",
+    "@zudojs/storage": "1.2.1",
     "@zudojs/types": "1.2.0"
   },
   "devDependencies": {