aws-sdk-vitest-mock 0.5.0 → 0.7.0

package/README.md

@@ -12,10 +12,12 @@
   <a href="https://www.npmjs.com/package/aws-sdk-vitest-mock">
     <img src="https://img.shields.io/npm/v/aws-sdk-vitest-mock?color=cb3837&logo=npm" alt="npm version" />
   </a>
+  <img alt="NPM Downloads" src="https://img.shields.io/npm/dm/aws-sdk-vitest-mock">
+  <img alt="GitHub Issues or Pull Requests" src="https://img.shields.io/github/issues/sudokar/aws-sdk-vitest-mock">
   <a href="https://github.com/sudokar/aws-sdk-vitest-mock/actions">
       <img src="https://github.com/sudokar/aws-sdk-vitest-mock/actions/workflows/ci.yml/badge.svg" alt="CI Status" />
   </a>
-  <img src="https://img.shields.io/badge/ESM%20Support-yes-4B32C3?logo=javascript" alt="ESM Support" />
+  <img src="https://img.shields.io/badge/ESM%20Support-yes-4B32C3?logo=typescript" alt="ESM Support" />
   <img src="https://img.shields.io/badge/Zero%20Dependencies-yes-brightgreen" alt="Zero Dependencies" />
   <a href="https://eslint.org/">
     <img src="https://img.shields.io/badge/code%20style-eslint-4B32C3?logo=eslint" alt="ESLint" />
@@ -564,6 +566,46 @@ s3Mock.restore();
 s3Mock.disableDebug();
 ```
 
+#### Global Debug Configuration
+
+Enable debug logging for all mocks globally, with the ability to override at the individual mock level:
+
+```typescript
+import { setGlobalDebug, mockClient } from "aws-sdk-vitest-mock";
+import { S3Client, GetObjectCommand } from "@aws-sdk/client-s3";
+import { DynamoDBClient, GetItemCommand } from "@aws-sdk/client-dynamodb";
+
+// Enable debug for all mocks
+setGlobalDebug(true);
+
+// All mocks will inherit the global debug setting
+const s3Mock = mockClient(S3Client);
+const dynamoMock = mockClient(DynamoDBClient);
+
+// Both mocks will log debug information
+s3Mock.on(GetObjectCommand).resolves({ Body: "data" });
+dynamoMock.on(GetItemCommand).resolves({ Item: { id: { S: "1" } } });
+
+// Override global setting for a specific mock
+s3Mock.disableDebug(); // This mock won't log, but dynamoMock still will
+
+// Disable global debug
+setGlobalDebug(false);
+```
+
+**Debug Priority (highest to lowest):**
+
+1. Individual mock's `enableDebug()` or `disableDebug()` call (explicit override)
+2. Global debug setting via `setGlobalDebug()`
+3. Default: disabled
+
+**Key behaviors:**
+
+- When global debug is enabled, all new and existing mocks will log unless explicitly disabled
+- Individual mock settings always take priority over global settings
+- `reset()` preserves individual debug settings
+- Global debug can be changed at any time and affects all mocks without explicit settings
+
 Debug mode provides comprehensive logging for:
 
 **Mock Configuration:**
@@ -650,6 +692,8 @@ test("should call DynamoDB", async () => {
 
 ## 📚 API Reference
 
+> TypeScript documentation for this library can be found at [here](https://sudokar.github.io/aws-sdk-vitest-mock/)
+
 ### `mockClient<TClient>(ClientConstructor)`
 
 Creates a mock for an AWS SDK client constructor.
@@ -662,14 +706,18 @@ Mocks an existing AWS SDK client instance.
 
 **Returns:** `AwsClientStub<TClient>`
 
+### Global Debug Functions
+
+- `setGlobalDebug(enabled: boolean)` - Enable or disable debug logging globally for all mocks
+
 ### `AwsClientStub` Methods
 
 - `on(Command, matcher?, options?)` - Configure mock for a command
 - `reset()` - Clear call history while preserving mock configurations
 - `restore()` - Restore original client behavior
 - `calls()` - Get call history
-- `enableDebug()` - Enable debug logging for troubleshooting
-- `disableDebug()` - Disable debug logging
+- `enableDebug()` - Enable debug logging for troubleshooting (overrides global setting)
+- `disableDebug()` - Disable debug logging (overrides global setting)
 
 ### `AwsCommandStub` Methods (Chainable)
 

package/index.cjs

@@ -1,18 +1,18 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("vitest"),m=require("./matchers-Dkkl4vtx.cjs"),x=require("node:fs"),O=require("node:path"),F=require("node:stream");class f extends Error{constructor(t,o,i,n){super(t),this.name="AwsError",this.code=o,this.statusCode=i,this.retryable=n}}const L=e=>{const t=e?`The specified key does not exist. Key: ${e}`:"The specified key does not exist.";return new f(t,"NoSuchKey",404,!1)},D=e=>{const t=e?`The specified bucket does not exist. Bucket: ${e}`:"The specified bucket does not exist.";return new f(t,"NoSuchBucket",404,!1)},I=e=>{const t=e?`Access Denied for resource: ${e}`:"Access Denied";return new f(t,"AccessDenied",403,!1)},T=e=>{const t=e?`Requested resource not found: ${e}`:"Requested resource not found";return new f(t,"ResourceNotFoundException",400,!1)},K=()=>new f("The conditional request failed","ConditionalCheckFailedException",400,!1),M=()=>new f("Rate exceeded","Throttling",400,!0),A=()=>new f("We encountered an internal error. Please try again.","InternalServerError",500,!0);function B(e){try{return JSON.stringify(e,void 0,2)}catch{return typeof e=="object"&&e!==null?"[Complex Object]":typeof e=="string"?e:typeof e=="number"||typeof e=="boolean"?String(e):"[Non-serializable value]"}}function j(){return{enabled:!1,log(e,t){if(this.enabled)if(t===void 0)console.log(`${m.colors.magenta("aws-sdk-vitest-mock(debug):")} ${e}`);else{const o=B(t);console.log(`${m.colors.magenta("aws-sdk-vitest-mock(debug):")} ${e}
-${o}`)}}}}function S(e){e.enabled=!0}function w(e){e.enabled=!1}function q(e){const t=O.resolve(e),o=x.readFileSync(t,"utf8");return e.endsWith(".json")?JSON.parse(o):o}function J(e,t={}){const{pageSize:o=10,tokenKey:i="NextToken",itemsKey:n="Items"}=t;if(e.length===0)return[{[n]:[]}];const s=[];for(let r=0;r<e.length;r+=o){const c=e.slice(r,r+o),u=r+o<e.length,l={[n]:c};if(u){const g=l,a=c[c.length-1];g[i]=a}s.push(l)}return s}function _(){return typeof process<"u"&&process.versions?.node?"node":typeof process<"u"&&process.versions?.bun?"bun":"browser"}function z(e){const t=typeof e=="string"?Buffer.from(e,"utf8"):Buffer.from(e);let o=!1;return new F.Readable({read(){o||(this.push(t),this.push(null),o=!0)}})}function V(e){let t;return typeof e=="string"?t=new TextEncoder().encode(e):e instanceof Buffer?t=new Uint8Array(e):t=e,new ReadableStream({start(o){o.enqueue(t),o.close()}})}function k(e){const t=_();return t==="node"||t==="bun"?z(e):V(e)}function $(e,t){return Object.keys(t).every(o=>{const i=t[o],n=e[o];return i&&typeof i=="object"&&!Array.isArray(i)?typeof n!="object"||n===null?!1:$(n,i):n===i})}function C(e,t){if(e===t)return!0;if(typeof e!="object"||e===null||typeof t!="object"||t===null)return e===t;const o=Object.keys(e),i=Object.keys(t);return o.length!==i.length?!1:i.every(n=>{if(!Object.prototype.hasOwnProperty.call(e,n))return!1;const s=e,r=t,c=s[n],u=r[n];return typeof c=="object"&&c!==null&&typeof u=="object"&&u!==null?C(c,u):c===u})}function N(e){return async function(t){const o=()=>this;e.debugLogger.log(`Received command: ${t.constructor.name}`,t.input);const i=e.map.get(t.constructor);if(i){e.debugLogger.log(`Found ${i.length} mock(s) for ${t.constructor.name}`);const s=i.findIndex(r=>r.strict?r.matcher&&C(t.input,r.matcher):!r.matcher||$(t.input,r.matcher));if(s===-1){e.debugLogger.log(`No matching mock found for ${t.constructor.name}`,t.input);const r=i.map((u,l)=>{const g=u.matcher?JSON.stringify(u.matcher,void 0,2):"any input",a=u.strict?" (strict mode)":"";return`  Mock #${l+1}: ${g}${a}`}).join(`
-`),c=JSON.stringify(t.input,void 0,2);throw new Error(`No matching mock found for ${t.constructor.name}.
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const j=require("vitest"),$=require("./matchers-CNhdB_9q.cjs"),W=require("node:fs"),C=require("node:path"),I=require("node:stream");class d extends Error{constructor(t,o,s,n){super(t),this.name=o,this.code=o,this.statusCode=s,this.retryable=n}}const T=e=>new d(e?`The specified key does not exist. Key: ${e}`:"The specified key does not exist.","NoSuchKey",404,!1),M=e=>new d(e?`The specified bucket does not exist. Bucket: ${e}`:"The specified bucket does not exist.","NoSuchBucket",404,!1),K=e=>new d(e?`Access Denied for resource: ${e}`:"Access Denied","AccessDenied",403,!1),A=e=>new d(e?`Requested resource not found: ${e}`:"Requested resource not found","ResourceNotFoundException",400,!1),B=()=>new d("The conditional request failed","ConditionalCheckFailedException",400,!1),J=()=>new d("Rate exceeded","Throttling",400,!0),q=()=>new d("We encountered an internal error. Please try again.","InternalServerError",500,!0),_=e=>{try{return JSON.stringify(e,void 0,2)}catch{return typeof e=="object"&&e!==null?"[Complex Object]":typeof e=="string"?e:typeof e=="number"||typeof e=="boolean"?String(e):"[Non-serializable value]"}},k=(e,t)=>{const o=$.colors.magenta("aws-sdk-vitest-mock(debug):");if(t===void 0)console.log(`${o} ${e}`);else{const s=_(t);console.log(`${o} ${e}
+${s}`)}},w=(e=!1)=>({enabled:e,explicitlySet:!1,log(t,o){this.enabled&&k(t,o)},logDirect(t,o){k(t,o)}}),z=e=>{e.enabled=!0,e.explicitlySet=!0},V=e=>{e.enabled=!1,e.explicitlySet=!0},G=e=>{const t=C.resolve(e);try{const o=W.readFileSync(t,"utf8");if(e.endsWith(".json"))try{return JSON.parse(o)}catch(s){const n=s instanceof Error?s.message:String(s);throw new Error(`Failed to parse JSON fixture at ${t}: ${n}`)}return o}catch(o){const s=o instanceof Error?o.message:String(o);throw new Error(`Failed to load fixture at ${t}: ${s}`)}},U=(e,t={})=>{const{pageSize:o=10,tokenKey:s="NextToken",itemsKey:n="Items"}=t;if(e.length===0)return[{[n]:[]}];const c=[];for(let r=0;r<e.length;r+=o){const i=e.slice(r,r+o),l=r+o<e.length,u={[n]:i};if(l){const a=u,f=i[i.length-1];a[s]=f}c.push(u)}return c},H=()=>typeof process<"u"&&process.versions?.node?"node":typeof process<"u"&&process.versions?.bun?"bun":"browser",Q=e=>{const t=typeof e=="string"?Buffer.from(e,"utf8"):Buffer.from(e);let o=!1;return new I.Readable({read(){o||(this.push(t),this.push(null),o=!0)}})},X=e=>{let t;return typeof e=="string"?t=new TextEncoder().encode(e):e instanceof Buffer?t=new Uint8Array(e):t=e,new ReadableStream({start(o){o.enqueue(t),o.close()}})},S=e=>{const t=H();return t==="node"||t==="bun"?Q(e):X(e)};let D=!1;function Y(e){D=e}function b(e){return e.explicitlySet?e.enabled:D}function E(e,t){return Object.keys(t).every(o=>{const s=t[o],n=e[o];return s&&typeof s=="object"&&!Array.isArray(s)?typeof n!="object"||n===null?!1:E(n,s):n===s})}function N(e,t){if(e===t)return!0;if(typeof e!="object"||e===null||typeof t!="object"||t===null)return e===t;const o=Object.keys(e),s=Object.keys(t);return o.length!==s.length?!1:s.every(n=>{if(!Object.prototype.hasOwnProperty.call(e,n))return!1;const c=e,r=t,i=c[n],l=r[n];return typeof i=="object"&&i!==null&&typeof l=="object"&&l!==null?N(i,l):i===l})}function Z(e,t,o){const s=t.map((c,r)=>{const i=c.matcher?JSON.stringify(c.matcher,void 0,2):"any input",l=c.strict?" (strict mode)":"";return`  Mock #${r+1}: ${i}${l}`}).join(`
+`),n=JSON.stringify(o,void 0,2);return new Error(`No matching mock found for ${e}.
 
-Found ${i.length} mock(s) but none matched the input.
+Found ${t.length} mock(s) but none matched the input.
 
 Configured mocks:
-${r}
+${s}
 
 Received input:
-${c}
+${n}
 
-Tip: Enable debug mode with enableDebug() for detailed matching information.`)}else{const r=i[s];if(!r)throw new Error(`Mock at index ${s} not found`);return e.debugLogger.log(`Using mock at index ${s} for ${t.constructor.name}`),r.once&&(i.splice(s,1),e.debugLogger.log(`Removed one-time mock for ${t.constructor.name}`)),r.handler(t.input,o())}}else e.debugLogger.log(`No mocks configured for ${t.constructor.name}`);const n=JSON.stringify(t.input,void 0,2);throw new Error(`No mock configured for command: ${t.constructor.name}.
+Tip: Enable debug mode with enableDebug() for detailed matching information.`)}function ee(e,t){const o=JSON.stringify(t,void 0,2);return new Error(`No mock configured for command: ${e}.
 
 Received input:
-${n}
+${o}
 
-Did you forget to call mockClient.on(${t.constructor.name})?`)}}function R(e,t,o,i={}){const n=(r,c,u)=>{const l={matcher:o,handler:r,once:c,strict:!!i.strict},g=e.map.get(t)??[];if(c){const a=g.findIndex(d=>!d.once);a===-1?g.push(l):g.splice(a,0,l),e.map.set(t,g),e.debugLogger.log(`Configured ${u}Once for ${t.name}`,o?{matcher:o,strict:!!i.strict}:void 0)}else{const a=g.filter(d=>d.once||JSON.stringify(d.matcher)!==JSON.stringify(o));a.push(l),e.map.set(t,a),e.debugLogger.log(`Configured ${u} for ${t.name}`,o?{matcher:o,strict:!!i.strict}:void 0)}},s={resolves(r){return n(()=>Promise.resolve(r),!1,"resolves"),s},rejects(r){return n(()=>{const c=typeof r=="string"?new Error(r):r;return Promise.reject(c)},!1,"rejects"),s},callsFake(r){return n(r,!1,"callsFake"),s},resolvesOnce(r){return n(()=>Promise.resolve(r),!0,"resolves"),s},rejectsOnce(r){return n(()=>{const c=typeof r=="string"?new Error(r):r;return Promise.reject(c)},!0,"rejects"),s},callsFakeOnce(r){return n(r,!0,"callsFake"),s},resolvesStream(r){return n(()=>Promise.resolve({Body:k(r)}),!1,"resolvesStream"),s},resolvesStreamOnce(r){return n(()=>Promise.resolve({Body:k(r)}),!0,"resolvesStream"),s},resolvesWithDelay(r,c){const u=l=>{setTimeout(()=>l(r),c)};return n(()=>new Promise(u),!1,"resolvesWithDelay"),s},rejectsWithDelay(r,c){const u=typeof r=="string"?new Error(r):r,l=(g,a)=>{setTimeout(()=>a(u),c)};return n(()=>new Promise(l),!1,"rejectsWithDelay"),s},rejectsWithNoSuchKey(r){return n(()=>Promise.reject(L(r)),!1,"rejectsWithNoSuchKey"),s},rejectsWithNoSuchBucket(r){return n(()=>Promise.reject(D(r)),!1,"rejectsWithNoSuchBucket"),s},rejectsWithAccessDenied(r){return n(()=>Promise.reject(I(r)),!1,"rejectsWithAccessDenied"),s},rejectsWithResourceNotFound(r){return n(()=>Promise.reject(T(r)),!1,"rejectsWithResourceNotFound"),s},rejectsWithConditionalCheckFailed(){return n(()=>Promise.reject(K()),!1,"rejectsWithConditionalCheckFailed"),s},rejectsWithThrottling(){return n(()=>Promise.reject(M()),!1,"rejectsWithThrottling"),s},rejectsWithInternalServerError(){return n(()=>Promise.reject(A()),!1,"rejectsWithInternalServerError"),s},resolvesPaginated(r,c={}){const u=J(r,c);let l=0;return e.debugLogger.log(`Configured resolvesPaginated for ${t.name}`,{pageSize:c.pageSize,itemsCount:r.length}),n(g=>{const a=c.tokenKey||"NextToken",d=c.inputTokenKey||a,h=g[d];if(h!=null){const E=c.itemsKey||"Items";let y=0;for(const W of u){const p=W[E];if(p&&p.length>0){const P=p[p.length-1];if(JSON.stringify(P)===JSON.stringify(h)){l=y+1;break}}y++}}else l=0;const b=u[l]||u[u.length-1]||u[0];if(!b)throw new Error("No paginated responses available");return l=Math.min(l+1,u.length-1),Promise.resolve(b)},!1,"resolvesPaginated"),s},resolvesFromFile(r){return e.debugLogger.log(`Configured resolvesFromFile for ${t.name}`,{filePath:r}),n(()=>{const c=q(r);return Promise.resolve(c)},!1,"resolvesFromFile"),s}};return s}const U=e=>{const t={map:new WeakMap,debugLogger:j()},o=e.prototype,i=v.vi.spyOn(o,"send").mockImplementation(N(t));return{client:void 0,on:(s,r,c)=>R(t,s,r,c),reset:()=>{t.debugLogger.log("Clearing call history (mocks preserved)"),i.mockClear()},restore:()=>{t.debugLogger.log("Restoring original client behavior and clearing all mocks"),i.mockRestore(),t.map=new WeakMap},calls:()=>i.mock.calls.map(s=>s[0]),__rawCalls:()=>i.mock.calls,enableDebug:()=>{S(t.debugLogger)},disableDebug:()=>{w(t.debugLogger)}}},G=e=>{const t={map:new WeakMap,debugLogger:j()},o=v.vi.spyOn(e,"send").mockImplementation(N(t));return{client:e,on:(n,s,r)=>R(t,n,s,r),reset:()=>{t.debugLogger.log("Clearing call history (mocks preserved) for client instance"),o.mockClear()},restore:()=>{t.debugLogger.log("Restoring original client behavior and clearing all mocks for client instance"),o.mockRestore(),t.map=new WeakMap},calls:()=>o.mock.calls.map(n=>n[0]),__rawCalls:()=>o.mock.calls,enableDebug:()=>{S(t.debugLogger)},disableDebug:()=>{w(t.debugLogger)}}};exports.matchers=m.matchers;exports.mockClient=U;exports.mockClientInstance=G;
+Did you forget to call mockClient.on(${e})?`)}function te(e,t){return e.findIndex(o=>o.strict?o.matcher&&N(t,o.matcher):!o.matcher||E(t,o.matcher))}function x(e){return async function(t){const o=()=>this,s=b(e.debugLogger),n=t.constructor.name;s&&e.debugLogger.logDirect(`Received command: ${n}`,t.input);const c=e.map.get(t.constructor);if(!c)throw s&&e.debugLogger.logDirect(`No mocks configured for ${n}`),ee(n,t.input);s&&e.debugLogger.logDirect(`Found ${c.length} mock(s) for ${n}`);const r=te(c,t.input);if(r===-1)throw s&&e.debugLogger.logDirect(`No matching mock found for ${n}`,t.input),Z(n,c,t.input);const i=c[r];if(!i)throw new Error(`Mock at index ${r} not found`);return s&&e.debugLogger.logDirect(`Using mock at index ${r} for ${n}`),i.once&&(c.splice(r,1),s&&e.debugLogger.logDirect(`Removed one-time mock for ${n}`)),i.handler(t.input,o())}}const L=(e,t,o)=>({reset(){b(e.debugLogger)&&e.debugLogger.logDirect(o.reset),t.mockClear()},restore(){b(e.debugLogger)&&e.debugLogger.logDirect(o.restore),t.mockRestore(),e.map=new WeakMap},calls(){return t.mock.calls.map(s=>s[0])},__rawCalls(){return t.mock.calls},enableDebug(){z(e.debugLogger)},disableDebug(){V(e.debugLogger)}});function R(e,t,o,s={}){const n=(r,i,l)=>{const u={matcher:o,handler:r,once:i,strict:!!s.strict},a=e.map.get(t)??[],f=b(e.debugLogger);if(i){const g=a.findIndex(h=>!h.once);g===-1?a.push(u):a.splice(g,0,u),e.map.set(t,a),f&&e.debugLogger.logDirect(`Configured ${l}Once for ${t.name}`,o?{matcher:o,strict:!!s.strict}:void 0)}else{const g=a.filter(h=>h.once||JSON.stringify(h.matcher)!==JSON.stringify(o));g.push(u),e.map.set(t,g),f&&e.debugLogger.logDirect(`Configured ${l} for ${t.name}`,o?{matcher:o,strict:!!s.strict}:void 0)}},c={resolves(r){return n(()=>Promise.resolve(r),!1,"resolves"),c},rejects(r){return n(()=>{const i=typeof r=="string"?new Error(r):r;return Promise.reject(i)},!1,"rejects"),c},callsFake(r){return n(r,!1,"callsFake"),c},resolvesOnce(r){return n(()=>Promise.resolve(r),!0,"resolves"),c},rejectsOnce(r){return n(()=>{const i=typeof r=="string"?new Error(r):r;return Promise.reject(i)},!0,"rejects"),c},callsFakeOnce(r){return n(r,!0,"callsFake"),c},resolvesStream(r){return n(()=>Promise.resolve({Body:S(r)}),!1,"resolvesStream"),c},resolvesStreamOnce(r){return n(()=>Promise.resolve({Body:S(r)}),!0,"resolvesStream"),c},resolvesWithDelay(r,i){const l=u=>{setTimeout(()=>u(r),i)};return n(()=>new Promise(l),!1,"resolvesWithDelay"),c},rejectsWithDelay(r,i){const l=typeof r=="string"?new Error(r):r,u=(a,f)=>{setTimeout(()=>f(l),i)};return n(()=>new Promise(u),!1,"rejectsWithDelay"),c},rejectsWithNoSuchKey(r){return n(()=>Promise.reject(T(r)),!1,"rejectsWithNoSuchKey"),c},rejectsWithNoSuchBucket(r){return n(()=>Promise.reject(M(r)),!1,"rejectsWithNoSuchBucket"),c},rejectsWithAccessDenied(r){return n(()=>Promise.reject(K(r)),!1,"rejectsWithAccessDenied"),c},rejectsWithResourceNotFound(r){return n(()=>Promise.reject(A(r)),!1,"rejectsWithResourceNotFound"),c},rejectsWithConditionalCheckFailed(){return n(()=>Promise.reject(B()),!1,"rejectsWithConditionalCheckFailed"),c},rejectsWithThrottling(){return n(()=>Promise.reject(J()),!1,"rejectsWithThrottling"),c},rejectsWithInternalServerError(){return n(()=>Promise.reject(q()),!1,"rejectsWithInternalServerError"),c},resolvesPaginated(r,i={}){const l=U(r,i);let u=0;return e.debugLogger.log(`Configured resolvesPaginated for ${t.name}`,{pageSize:i.pageSize,itemsCount:r.length}),n(a=>{const f=i.tokenKey||"NextToken",g=i.inputTokenKey||f,m=a[g];if(m!=null){const F=i.itemsKey||"Items";let v=0;for(const O of l){const p=O[F];if(p&&p.length>0){const P=p[p.length-1];if(JSON.stringify(P)===JSON.stringify(m)){u=v+1;break}}v++}}else u=0;const y=l[u]||l[l.length-1]||l[0];if(!y)throw new Error("No paginated responses available");return u=Math.min(u+1,l.length-1),Promise.resolve(y)},!1,"resolvesPaginated"),c},resolvesFromFile(r){return e.debugLogger.log(`Configured resolvesFromFile for ${t.name}`,{filePath:r}),n(()=>{const i=G(r);return Promise.resolve(i)},!1,"resolvesFromFile"),c}};return c}const re=e=>{const t={map:new WeakMap,debugLogger:w()},o=e.prototype,s=j.vi.spyOn(o,"send").mockImplementation(x(t)),n=L(t,s,{reset:"Clearing call history (mocks preserved)",restore:"Restoring original client behavior and clearing all mocks"});return{client:void 0,on:(r,i,l)=>R(t,r,i,l),...n}},oe=e=>{const t={map:new WeakMap,debugLogger:w()},o=j.vi.spyOn(e,"send").mockImplementation(x(t)),s=L(t,o,{reset:"Clearing call history (mocks preserved) for client instance",restore:"Restoring original client behavior and clearing all mocks for client instance"});return{client:e,on:(c,r,i)=>R(t,c,r,i),...s}};exports.matchers=$.matchers;exports.mockClient=re;exports.mockClientInstance=oe;exports.setGlobalDebug=Y;

package/index.d.ts

@@ -29,7 +29,7 @@
  * Core Functions for mocking AWS SDK clients
  * @category Core Functions
  */
-export { mockClient, mockClientInstance } from './lib/mock-client.js';
+export { mockClient, mockClientInstance, setGlobalDebug, } from './lib/mock-client.js';
 /**
  * Command stub interface for configuring mock behaviors
  * @category Command Stub

package/index.js

@@ -1,454 +1,476 @@
-import { vi as v } from "vitest";
-import { c as y } from "./matchers-ClGOsQx8.js";
-import { m as ne } from "./matchers-ClGOsQx8.js";
+import { vi as j } from "vitest";
+import { c as O } from "./matchers-DmTtFk31.js";
+import { m as ge } from "./matchers-DmTtFk31.js";
 import { readFileSync as P } from "node:fs";
-import F from "node:path";
-import { Readable as O } from "node:stream";
-class f extends Error {
-  constructor(t, n, i, o) {
-    super(t), this.name = "AwsError", this.code = n, this.statusCode = i, this.retryable = o;
+import C from "node:path";
+import { Readable as I } from "node:stream";
+class d extends Error {
+  constructor(t, o, s, n) {
+    super(t), this.name = o, this.code = o, this.statusCode = s, this.retryable = n;
   }
 }
-const L = (e) => {
-  const t = e ? `The specified key does not exist. Key: ${e}` : "The specified key does not exist.";
-  return new f(t, "NoSuchKey", 404, !1);
-}, D = (e) => {
-  const t = e ? `The specified bucket does not exist. Bucket: ${e}` : "The specified bucket does not exist.";
-  return new f(t, "NoSuchBucket", 404, !1);
-}, I = (e) => {
-  const t = e ? `Access Denied for resource: ${e}` : "Access Denied";
-  return new f(t, "AccessDenied", 403, !1);
-}, T = (e) => {
-  const t = e ? `Requested resource not found: ${e}` : "Requested resource not found";
-  return new f(t, "ResourceNotFoundException", 400, !1);
-}, K = () => new f(
+const T = (e) => new d(
+  e ? `The specified key does not exist. Key: ${e}` : "The specified key does not exist.",
+  "NoSuchKey",
+  404,
+  !1
+), M = (e) => new d(
+  e ? `The specified bucket does not exist. Bucket: ${e}` : "The specified bucket does not exist.",
+  "NoSuchBucket",
+  404,
+  !1
+), K = (e) => new d(
+  e ? `Access Denied for resource: ${e}` : "Access Denied",
+  "AccessDenied",
+  403,
+  !1
+), A = (e) => new d(
+  e ? `Requested resource not found: ${e}` : "Requested resource not found",
+  "ResourceNotFoundException",
+  400,
+  !1
+), B = () => new d(
   "The conditional request failed",
   "ConditionalCheckFailedException",
   400,
   !1
-), M = () => new f("Rate exceeded", "Throttling", 400, !0), A = () => new f(
+), J = () => new d("Rate exceeded", "Throttling", 400, !0), q = () => new d(
   "We encountered an internal error. Please try again.",
   "InternalServerError",
   500,
   !0
-);
-function B(e) {
+), z = (e) => {
   try {
     return JSON.stringify(e, void 0, 2);
   } catch {
     return typeof e == "object" && e !== null ? "[Complex Object]" : typeof e == "string" ? e : typeof e == "number" || typeof e == "boolean" ? String(e) : "[Non-serializable value]";
   }
-}
-function j() {
-  return {
-    enabled: !1,
-    log(e, t) {
-      if (this.enabled)
-        if (t === void 0)
-          console.log(
-            `${y.magenta("aws-sdk-vitest-mock(debug):")} ${e}`
-          );
-        else {
-          const n = B(t);
-          console.log(
-            `${y.magenta("aws-sdk-vitest-mock(debug):")} ${e}
-${n}`
-          );
-        }
-    }
-  };
-}
-function S(e) {
-  e.enabled = !0;
-}
-function w(e) {
-  e.enabled = !1;
-}
-function J(e) {
-  const t = F.resolve(e), n = P(t, "utf8");
-  return e.endsWith(".json") ? JSON.parse(n) : n;
-}
-function _(e, t = {}) {
-  const { pageSize: n = 10, tokenKey: i = "NextToken", itemsKey: o = "Items" } = t;
+}, k = (e, t) => {
+  const o = O.magenta("aws-sdk-vitest-mock(debug):");
+  if (t === void 0)
+    console.log(`${o} ${e}`);
+  else {
+    const s = z(t);
+    console.log(`${o} ${e}
+${s}`);
+  }
+}, $ = (e = !1) => ({
+  enabled: e,
+  explicitlySet: !1,
+  log(t, o) {
+    this.enabled && k(t, o);
+  },
+  logDirect(t, o) {
+    k(t, o);
+  }
+}), V = (e) => {
+  e.enabled = !0, e.explicitlySet = !0;
+}, _ = (e) => {
+  e.enabled = !1, e.explicitlySet = !0;
+}, U = (e) => {
+  const t = C.resolve(e);
+  try {
+    const o = P(t, "utf8");
+    if (e.endsWith(".json"))
+      try {
+        return JSON.parse(o);
+      } catch (s) {
+        const n = s instanceof Error ? s.message : String(s);
+        throw new Error(
+          `Failed to parse JSON fixture at ${t}: ${n}`
+        );
+      }
+    return o;
+  } catch (o) {
+    const s = o instanceof Error ? o.message : String(o);
+    throw new Error(`Failed to load fixture at ${t}: ${s}`);
+  }
+}, G = (e, t = {}) => {
+  const { pageSize: o = 10, tokenKey: s = "NextToken", itemsKey: n = "Items" } = t;
   if (e.length === 0)
-    return [{ [o]: [] }];
-  const s = [];
-  for (let r = 0; r < e.length; r += n) {
-    const c = e.slice(r, r + n), l = r + n < e.length, u = { [o]: c };
+    return [{ [n]: [] }];
+  const c = [];
+  for (let r = 0; r < e.length; r += o) {
+    const i = e.slice(r, r + o), l = r + o < e.length, u = { [n]: i };
     if (l) {
-      const g = u, a = c[c.length - 1];
-      g[i] = a;
+      const a = u, f = i[i.length - 1];
+      a[s] = f;
     }
-    s.push(u);
+    c.push(u);
   }
-  return s;
-}
-function q() {
-  return typeof process < "u" && process.versions?.node ? "node" : typeof process < "u" && process.versions?.bun ? "bun" : "browser";
-}
-function z(e) {
+  return c;
+}, H = () => typeof process < "u" && process.versions?.node ? "node" : typeof process < "u" && process.versions?.bun ? "bun" : "browser", Q = (e) => {
   const t = typeof e == "string" ? Buffer.from(e, "utf8") : Buffer.from(e);
-  let n = !1;
-  return new O({
+  let o = !1;
+  return new I({
     read() {
-      n || (this.push(t), this.push(null), n = !0);
+      o || (this.push(t), this.push(null), o = !0);
     }
   });
-}
-function V(e) {
+}, X = (e) => {
   let t;
   return typeof e == "string" ? t = new TextEncoder().encode(e) : e instanceof Buffer ? t = new Uint8Array(e) : t = e, new ReadableStream({
-    start(n) {
-      n.enqueue(t), n.close();
+    start(o) {
+      o.enqueue(t), o.close();
     }
   });
+}, S = (e) => {
+  const t = H();
+  return t === "node" || t === "bun" ? Q(e) : X(e);
+};
+let w = !1;
+function ie(e) {
+  w = e;
 }
-function k(e) {
-  const t = q();
-  return t === "node" || t === "bun" ? z(e) : V(e);
+function m(e) {
+  return e.explicitlySet ? e.enabled : w;
 }
-function $(e, t) {
-  return Object.keys(t).every((n) => {
-    const i = t[n], o = e[n];
-    return i && typeof i == "object" && !Array.isArray(i) ? typeof o != "object" || o === null ? !1 : $(
-      o,
-      i
-    ) : o === i;
+function E(e, t) {
+  return Object.keys(t).every((o) => {
+    const s = t[o], n = e[o];
+    return s && typeof s == "object" && !Array.isArray(s) ? typeof n != "object" || n === null ? !1 : E(
+      n,
+      s
+    ) : n === s;
   });
 }
 function N(e, t) {
   if (e === t) return !0;
   if (typeof e != "object" || e === null || typeof t != "object" || t === null)
     return e === t;
-  const n = Object.keys(e), i = Object.keys(t);
-  return n.length !== i.length ? !1 : i.every((o) => {
-    if (!Object.prototype.hasOwnProperty.call(e, o)) return !1;
-    const s = e, r = t, c = s[o], l = r[o];
-    return typeof c == "object" && c !== null && typeof l == "object" && l !== null ? N(c, l) : c === l;
+  const o = Object.keys(e), s = Object.keys(t);
+  return o.length !== s.length ? !1 : s.every((n) => {
+    if (!Object.prototype.hasOwnProperty.call(e, n)) return !1;
+    const c = e, r = t, i = c[n], l = r[n];
+    return typeof i == "object" && i !== null && typeof l == "object" && l !== null ? N(i, l) : i === l;
   });
 }
-function C(e) {
-  return async function(t) {
-    const n = () => this;
-    e.debugLogger.log(
-      `Received command: ${t.constructor.name}`,
-      t.input
-    );
-    const i = e.map.get(
-      t.constructor
-    );
-    if (i) {
-      e.debugLogger.log(
-        `Found ${i.length} mock(s) for ${t.constructor.name}`
-      );
-      const s = i.findIndex((r) => r.strict ? r.matcher && N(t.input, r.matcher) : !r.matcher || $(t.input, r.matcher));
-      if (s === -1) {
-        e.debugLogger.log(
-          `No matching mock found for ${t.constructor.name}`,
-          t.input
-        );
-        const r = i.map((l, u) => {
-          const g = l.matcher ? JSON.stringify(l.matcher, void 0, 2) : "any input", a = l.strict ? " (strict mode)" : "";
-          return `  Mock #${u + 1}: ${g}${a}`;
-        }).join(`
-`), c = JSON.stringify(t.input, void 0, 2);
-        throw new Error(
-          `No matching mock found for ${t.constructor.name}.
+function Y(e, t, o) {
+  const s = t.map((c, r) => {
+    const i = c.matcher ? JSON.stringify(c.matcher, void 0, 2) : "any input", l = c.strict ? " (strict mode)" : "";
+    return `  Mock #${r + 1}: ${i}${l}`;
+  }).join(`
+`), n = JSON.stringify(o, void 0, 2);
+  return new Error(
+    `No matching mock found for ${e}.
 
-Found ${i.length} mock(s) but none matched the input.
+Found ${t.length} mock(s) but none matched the input.
 
 Configured mocks:
-${r}
+${s}
 
 Received input:
-${c}
+${n}
 
 Tip: Enable debug mode with enableDebug() for detailed matching information.`
-        );
-      } else {
-        const r = i[s];
-        if (!r)
-          throw new Error(`Mock at index ${s} not found`);
-        return e.debugLogger.log(
-          `Using mock at index ${s} for ${t.constructor.name}`
-        ), r.once && (i.splice(s, 1), e.debugLogger.log(
-          `Removed one-time mock for ${t.constructor.name}`
-        )), r.handler(
-          t.input,
-          n()
-        );
-      }
-    } else
-      e.debugLogger.log(
-        `No mocks configured for ${t.constructor.name}`
-      );
-    const o = JSON.stringify(t.input, void 0, 2);
-    throw new Error(
-      `No mock configured for command: ${t.constructor.name}.
+  );
+}
+function Z(e, t) {
+  const o = JSON.stringify(t, void 0, 2);
+  return new Error(
+    `No mock configured for command: ${e}.
 
 Received input:
 ${o}
 
-Did you forget to call mockClient.on(${t.constructor.name})?`
+Did you forget to call mockClient.on(${e})?`
+  );
+}
+function ee(e, t) {
+  return e.findIndex((o) => o.strict ? o.matcher && N(t, o.matcher) : !o.matcher || E(t, o.matcher));
+}
+function x(e) {
+  return async function(t) {
+    const o = () => this, s = m(e.debugLogger), n = t.constructor.name;
+    s && e.debugLogger.logDirect(
+      `Received command: ${n}`,
+      t.input
+    );
+    const c = e.map.get(
+      t.constructor
+    );
+    if (!c)
+      throw s && e.debugLogger.logDirect(
+        `No mocks configured for ${n}`
+      ), Z(n, t.input);
+    s && e.debugLogger.logDirect(
+      `Found ${c.length} mock(s) for ${n}`
     );
+    const r = ee(c, t.input);
+    if (r === -1)
+      throw s && e.debugLogger.logDirect(
+        `No matching mock found for ${n}`,
+        t.input
+      ), Y(n, c, t.input);
+    const i = c[r];
+    if (!i)
+      throw new Error(`Mock at index ${r} not found`);
+    return s && e.debugLogger.logDirect(
+      `Using mock at index ${r} for ${n}`
+    ), i.once && (c.splice(r, 1), s && e.debugLogger.logDirect(
+      `Removed one-time mock for ${n}`
+    )), i.handler(t.input, o());
   };
 }
-function R(e, t, n, i = {}) {
-  const o = (r, c, l) => {
+const D = (e, t, o) => ({
+  reset() {
+    m(e.debugLogger) && e.debugLogger.logDirect(o.reset), t.mockClear();
+  },
+  restore() {
+    m(e.debugLogger) && e.debugLogger.logDirect(o.restore), t.mockRestore(), e.map = /* @__PURE__ */ new WeakMap();
+  },
+  calls() {
+    return t.mock.calls.map((s) => s[0]);
+  },
+  __rawCalls() {
+    return t.mock.calls;
+  },
+  enableDebug() {
+    V(e.debugLogger);
+  },
+  disableDebug() {
+    _(e.debugLogger);
+  }
+});
+function L(e, t, o, s = {}) {
+  const n = (r, i, l) => {
     const u = {
-      matcher: n,
+      matcher: o,
       handler: r,
-      once: c,
-      strict: !!i.strict
-    }, g = e.map.get(t) ?? [];
-    if (c) {
-      const a = g.findIndex((d) => !d.once);
-      a === -1 ? g.push(u) : g.splice(a, 0, u), e.map.set(
+      once: i,
+      strict: !!s.strict
+    }, a = e.map.get(t) ?? [], f = m(e.debugLogger);
+    if (i) {
+      const g = a.findIndex((h) => !h.once);
+      g === -1 ? a.push(u) : a.splice(g, 0, u), e.map.set(
         t,
-        g
-      ), e.debugLogger.log(
+        a
+      ), f && e.debugLogger.logDirect(
         `Configured ${l}Once for ${t.name}`,
-        n ? { matcher: n, strict: !!i.strict } : void 0
+        o ? { matcher: o, strict: !!s.strict } : void 0
       );
     } else {
-      const a = g.filter(
-        (d) => d.once || JSON.stringify(d.matcher) !== JSON.stringify(n)
+      const g = a.filter(
+        (h) => h.once || JSON.stringify(h.matcher) !== JSON.stringify(o)
       );
-      a.push(u), e.map.set(
+      g.push(u), e.map.set(
         t,
-        a
-      ), e.debugLogger.log(
+        g
+      ), f && e.debugLogger.logDirect(
         `Configured ${l} for ${t.name}`,
-        n ? { matcher: n, strict: !!i.strict } : void 0
+        o ? { matcher: o, strict: !!s.strict } : void 0
       );
     }
-  }, s = {
+  }, c = {
     resolves(r) {
-      return o(() => Promise.resolve(r), !1, "resolves"), s;
+      return n(() => Promise.resolve(r), !1, "resolves"), c;
     },
     rejects(r) {
-      return o(
+      return n(
         () => {
-          const c = typeof r == "string" ? new Error(r) : r;
-          return Promise.reject(c);
+          const i = typeof r == "string" ? new Error(r) : r;
+          return Promise.reject(i);
         },
         !1,
         "rejects"
-      ), s;
+      ), c;
     },
     callsFake(r) {
-      return o(r, !1, "callsFake"), s;
+      return n(r, !1, "callsFake"), c;
     },
     resolvesOnce(r) {
-      return o(() => Promise.resolve(r), !0, "resolves"), s;
+      return n(() => Promise.resolve(r), !0, "resolves"), c;
     },
     rejectsOnce(r) {
-      return o(
+      return n(
         () => {
-          const c = typeof r == "string" ? new Error(r) : r;
-          return Promise.reject(c);
+          const i = typeof r == "string" ? new Error(r) : r;
+          return Promise.reject(i);
         },
         !0,
         "rejects"
-      ), s;
+      ), c;
     },
     callsFakeOnce(r) {
-      return o(r, !0, "callsFake"), s;
+      return n(r, !0, "callsFake"), c;
     },
     resolvesStream(r) {
-      return o(
-        () => Promise.resolve({ Body: k(r) }),
+      return n(
+        () => Promise.resolve({
+          Body: S(r)
+        }),
         !1,
         "resolvesStream"
-      ), s;
+      ), c;
     },
     resolvesStreamOnce(r) {
-      return o(
-        () => Promise.resolve({ Body: k(r) }),
+      return n(
+        () => Promise.resolve({
+          Body: S(r)
+        }),
         !0,
         "resolvesStream"
-      ), s;
+      ), c;
     },
-    resolvesWithDelay(r, c) {
+    resolvesWithDelay(r, i) {
       const l = (u) => {
-        setTimeout(() => u(r), c);
+        setTimeout(() => u(r), i);
       };
-      return o(() => new Promise(l), !1, "resolvesWithDelay"), s;
+      return n(
+        () => new Promise(l),
+        !1,
+        "resolvesWithDelay"
+      ), c;
     },
-    rejectsWithDelay(r, c) {
-      const l = typeof r == "string" ? new Error(r) : r, u = (g, a) => {
-        setTimeout(() => a(l), c);
+    rejectsWithDelay(r, i) {
+      const l = typeof r == "string" ? new Error(r) : r, u = (a, f) => {
+        setTimeout(() => f(l), i);
       };
-      return o(() => new Promise(u), !1, "rejectsWithDelay"), s;
+      return n(() => new Promise(u), !1, "rejectsWithDelay"), c;
     },
     rejectsWithNoSuchKey(r) {
-      return o(
-        () => Promise.reject(L(r)),
+      return n(
+        () => Promise.reject(T(r)),
         !1,
         "rejectsWithNoSuchKey"
-      ), s;
+      ), c;
     },
     rejectsWithNoSuchBucket(r) {
-      return o(
-        () => Promise.reject(D(r)),
+      return n(
+        () => Promise.reject(M(r)),
         !1,
         "rejectsWithNoSuchBucket"
-      ), s;
+      ), c;
     },
     rejectsWithAccessDenied(r) {
-      return o(
-        () => Promise.reject(I(r)),
+      return n(
+        () => Promise.reject(K(r)),
         !1,
         "rejectsWithAccessDenied"
-      ), s;
+      ), c;
     },
     rejectsWithResourceNotFound(r) {
-      return o(
-        () => Promise.reject(T(r)),
+      return n(
+        () => Promise.reject(A(r)),
         !1,
         "rejectsWithResourceNotFound"
-      ), s;
+      ), c;
     },
     rejectsWithConditionalCheckFailed() {
-      return o(
-        () => Promise.reject(K()),
+      return n(
+        () => Promise.reject(B()),
         !1,
         "rejectsWithConditionalCheckFailed"
-      ), s;
+      ), c;
     },
     rejectsWithThrottling() {
-      return o(
-        () => Promise.reject(M()),
+      return n(
+        () => Promise.reject(J()),
         !1,
         "rejectsWithThrottling"
-      ), s;
+      ), c;
     },
     rejectsWithInternalServerError() {
-      return o(
-        () => Promise.reject(A()),
+      return n(
+        () => Promise.reject(q()),
         !1,
         "rejectsWithInternalServerError"
-      ), s;
+      ), c;
     },
-    resolvesPaginated(r, c = {}) {
-      const l = _(r, c);
+    resolvesPaginated(r, i = {}) {
+      const l = G(r, i);
       let u = 0;
       return e.debugLogger.log(
         `Configured resolvesPaginated for ${t.name}`,
-        { pageSize: c.pageSize, itemsCount: r.length }
-      ), o(
-        (g) => {
-          const a = c.tokenKey || "NextToken", d = c.inputTokenKey || a, m = g[d];
-          if (m != null) {
-            const E = c.itemsKey || "Items";
-            let b = 0;
-            for (const x of l) {
-              const p = x[E];
+        { pageSize: i.pageSize, itemsCount: r.length }
+      ), n(
+        (a) => {
+          const f = i.tokenKey || "NextToken", g = i.inputTokenKey || f, b = a[g];
+          if (b != null) {
+            const R = i.itemsKey || "Items";
+            let v = 0;
+            for (const F of l) {
+              const p = F[R];
               if (p && p.length > 0) {
                 const W = p[p.length - 1];
-                if (JSON.stringify(W) === JSON.stringify(m)) {
-                  u = b + 1;
+                if (JSON.stringify(W) === JSON.stringify(b)) {
+                  u = v + 1;
                   break;
                 }
               }
-              b++;
+              v++;
             }
           } else
             u = 0;
-          const h = (
+          const y = (
             // eslint-disable-next-line security/detect-object-injection
             l[u] || // eslint-disable-next-line unicorn/prefer-at -- TypeScript target doesn't support Array.at() method
             l[l.length - 1] || l[0]
           );
-          if (!h)
+          if (!y)
             throw new Error("No paginated responses available");
-          return u = Math.min(u + 1, l.length - 1), Promise.resolve(h);
+          return u = Math.min(u + 1, l.length - 1), Promise.resolve(y);
         },
         !1,
         "resolvesPaginated"
-      ), s;
+      ), c;
     },
     resolvesFromFile(r) {
       return e.debugLogger.log(
         `Configured resolvesFromFile for ${t.name}`,
         { filePath: r }
-      ), o(
+      ), n(
         () => {
-          const c = J(r);
-          return Promise.resolve(c);
+          const i = U(r);
+          return Promise.resolve(i);
         },
         !1,
         "resolvesFromFile"
-      ), s;
+      ), c;
     }
   };
-  return s;
+  return c;
 }
-const ee = (e) => {
+const le = (e) => {
   const t = {
     map: /* @__PURE__ */ new WeakMap(),
-    debugLogger: j()
-  }, n = e.prototype, i = v.spyOn(n, "send").mockImplementation(C(t));
+    debugLogger: $()
+  }, o = e.prototype, s = j.spyOn(o, "send").mockImplementation(x(t)), n = D(t, s, {
+    reset: "Clearing call history (mocks preserved)",
+    restore: "Restoring original client behavior and clearing all mocks"
+  });
   return {
     client: void 0,
-    on: (s, r, c) => R(
+    on: (r, i, l) => L(
       t,
-      s,
       r,
-      c
+      i,
+      l
     ),
-    reset: () => {
-      t.debugLogger.log("Clearing call history (mocks preserved)"), i.mockClear();
-    },
-    restore: () => {
-      t.debugLogger.log(
-        "Restoring original client behavior and clearing all mocks"
-      ), i.mockRestore(), t.map = /* @__PURE__ */ new WeakMap();
-    },
-    calls: () => i.mock.calls.map((s) => s[0]),
-    __rawCalls: () => i.mock.calls,
-    enableDebug: () => {
-      S(t.debugLogger);
-    },
-    disableDebug: () => {
-      w(t.debugLogger);
-    }
+    ...n
   };
-}, te = (e) => {
+}, ue = (e) => {
   const t = {
     map: /* @__PURE__ */ new WeakMap(),
-    debugLogger: j()
-  }, n = v.spyOn(e, "send").mockImplementation(C(t));
+    debugLogger: $()
+  }, o = j.spyOn(e, "send").mockImplementation(x(t)), s = D(t, o, {
+    reset: "Clearing call history (mocks preserved) for client instance",
+    restore: "Restoring original client behavior and clearing all mocks for client instance"
+  });
   return {
     client: e,
-    on: (o, s, r) => R(
+    on: (c, r, i) => L(
       t,
-      o,
-      s,
-      r
+      c,
+      r,
+      i
     ),
-    reset: () => {
-      t.debugLogger.log(
-        "Clearing call history (mocks preserved) for client instance"
-      ), n.mockClear();
-    },
-    restore: () => {
-      t.debugLogger.log(
-        "Restoring original client behavior and clearing all mocks for client instance"
-      ), n.mockRestore(), t.map = /* @__PURE__ */ new WeakMap();
-    },
-    calls: () => n.mock.calls.map((o) => o[0]),
-    __rawCalls: () => n.mock.calls,
-    enableDebug: () => {
-      S(t.debugLogger);
-    },
-    disableDebug: () => {
-      w(t.debugLogger);
-    }
+    ...s
   };
 };
 export {
-  ne as matchers,
-  ee as mockClient,
-  te as mockClientInstance
+  ge as matchers,
+  le as mockClient,
+  ue as mockClientInstance,
+  ie as setGlobalDebug
 };

package/lib/mock-client.d.ts

@@ -3,6 +3,30 @@ import { HttpHandlerOptions, MetadataBearer } from '@smithy/types';
 import { Mock } from 'vitest';
 import { PaginatorOptions } from './utils/paginator-helpers.js';
 import { StreamInput } from './utils/stream-helpers.js';
+type DeepPartial<T> = T extends (...args: unknown[]) => unknown ? T : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * Set global debug mode for all mocks.
+ * When enabled, all mocks will log debug information unless explicitly disabled at the mock level.
+ *
+ * @param enabled - Whether to enable debug logging globally
+ *
+ * @example
+ * ```typescript
+ * import { setGlobalDebug, mockClient } from 'aws-sdk-vitest-mock';
+ * import { S3Client } from '@aws-sdk/client-s3';
+ *
+ * // Enable debug for all mocks
+ * setGlobalDebug(true);
+ *
+ * const s3Mock = mockClient(S3Client); // Automatically has debug enabled
+ *
+ * // Disable debug for a specific mock
+ * s3Mock.disableDebug(); // This mock won't log, but others will
+ * ```
+ */
+export declare function setGlobalDebug(enabled: boolean): void;
 export type StructuralCommand<TInput extends object, TOutput extends MetadataBearer> = SmithyCommand<TInput, TOutput, any, any, any> | {
     readonly input: TInput;
     readonly __awsSdkVitestMockOutput?: TOutput;
@@ -19,7 +43,7 @@ export type AwsSdkCommand = StructuralCommand<object, MetadataBearer>;
 export type ClientConstructor<TClient extends AnyClient> = (abstract new (...args: unknown[]) => TClient) | {
     prototype: TClient;
 };
-type CommandHandler<TInput extends object = object, TOutput extends MetadataBearer = MetadataBearer, TClient extends AnyClient = AnyClient> = (input: TInput, clientInstance: TClient | undefined) => Promise<Partial<TOutput>>;
+type CommandHandler<TInput extends object = object, TOutput extends MetadataBearer = MetadataBearer, TClient extends AnyClient = AnyClient> = (input: TInput, clientInstance: TClient | undefined) => Promise<DeepPartial<TOutput>>;
 interface MockOptions {
     strict?: boolean;
 }
@@ -177,7 +201,7 @@ export interface AwsCommandStub<TInput extends object, TOutput extends MetadataB
      * s3Mock.on(GetObjectCommand).resolves({ Body: 'file contents' });
      * ```
      */
-    resolves: (output: Partial<TOutput>) => AwsCommandStub<TInput, TOutput, TClient>;
+    resolves: (output: DeepPartial<TOutput>) => AwsCommandStub<TInput, TOutput, TClient>;
     /**
      * Set a permanent mock rejection that will be used after all one-time handlers are consumed.
      *
@@ -217,7 +241,7 @@ export interface AwsCommandStub<TInput extends object, TOutput extends MetadataB
      *   .resolvesOnce({ Body: 'second call' });
      * ```
      */
-    resolvesOnce: (output: Partial<TOutput>) => AwsCommandStub<TInput, TOutput, TClient>;
+    resolvesOnce: (output: DeepPartial<TOutput>) => AwsCommandStub<TInput, TOutput, TClient>;
     /**
      * Add a one-time mock rejection that will be consumed in order.
      *
@@ -284,7 +308,7 @@ export interface AwsCommandStub<TInput extends object, TOutput extends MetadataB
      * s3Mock.on(GetObjectCommand).resolvesWithDelay({ Body: 'data' }, 1000);
      * ```
      */
-    resolvesWithDelay: (output: Partial<TOutput>, delayMs: number) => AwsCommandStub<TInput, TOutput, TClient>;
+    resolvesWithDelay: (output: DeepPartial<TOutput>, delayMs: number) => AwsCommandStub<TInput, TOutput, TClient>;
     /**
      * Set a permanent mock rejection with a delay in milliseconds.
      *

package/lib/utils/debug-logger.d.ts

@@ -1,7 +1,9 @@
 export interface DebugLogger {
     enabled: boolean;
+    explicitlySet: boolean;
     log: (message: string, data?: unknown) => void;
+    logDirect: (message: string, data?: unknown) => void;
 }
-export declare function createDebugLogger(): DebugLogger;
-export declare function enableDebug(logger: DebugLogger): void;
-export declare function disableDebug(logger: DebugLogger): void;
+export declare const createDebugLogger: (initialEnabled?: boolean) => DebugLogger;
+export declare const enableDebug: (logger: DebugLogger) => void;
+export declare const disableDebug: (logger: DebugLogger) => void;

package/lib/utils/file-helpers.d.ts

@@ -1 +1 @@
-export declare function loadFixture(filePath: string): unknown;
+export declare const loadFixture: (filePath: string) => unknown;

package/lib/utils/paginator-helpers.d.ts

@@ -95,4 +95,4 @@ export interface PaginatedResponse<T = unknown> {
  * // ]
  * ```
  */
-export declare function createPaginatedResponses<T>(items: T[], options?: PaginatorOptions): PaginatedResponse<T>[];
+export declare const createPaginatedResponses: <T>(items: T[], options?: PaginatorOptions) => PaginatedResponse<T>[];

package/lib/utils/stream-helpers.d.ts

@@ -3,4 +3,4 @@ export type StreamInput = string | Buffer | Uint8Array;
 /**
  * Creates an appropriate stream for the current environment
  */
-export declare function createStream(data: StreamInput): Readable | ReadableStream<Uint8Array>;
+export declare const createStream: (data: StreamInput) => Readable | ReadableStream<Uint8Array>;

package/{matchers-Dkkl4vtx.cjs → matchers-CNhdB_9q.cjs}

@@ -1,4 +1,4 @@
-"use strict";const e={red:t=>`\x1B[31m${t}\x1B[39m`,green:t=>`\x1B[32m${t}\x1B[39m`,yellow:t=>`\x1B[33m${t}\x1B[39m`,blue:t=>`\x1B[34m${t}\x1B[39m`,magenta:t=>`\x1B[35m${t}\x1B[39m`,cyan:t=>`\x1B[36m${t}\x1B[39m`,gray:t=>`\x1B[90m${t}\x1B[39m`,bold:t=>`\x1B[1m${t}\x1B[22m`},$=t=>{const c=t.__rawCalls();return Array.isArray(c)?c.filter(a=>Array.isArray(a)&&a.length>0):[]},f={toHaveReceivedCommand(t,c){const a=$(t),r=a.some(o=>o[0]instanceof c),m=c.name;return{pass:r,message:()=>{if(r)return`Expected AWS SDK mock not to have received command ${e.red(m)}`;const o=a.map(n=>n[0].constructor?.name??"Unknown");return o.length===0?`Expected AWS SDK mock to have received command ${e.red(m)}, but ${e.gray("no commands were received")}`:`Expected AWS SDK mock to have received command ${e.red(m)}, but received: ${e.yellow(o.join(", "))}`}}},toHaveReceivedCommandTimes(t,c,a){const r=$(t).filter(n=>n[0]instanceof c),m=r.length===a,o=c.name;return{pass:m,message:()=>m?`Expected AWS SDK mock not to have received command ${o} ${a} times`:`Expected AWS SDK mock to have received command ${o} ${a} times, but received ${r.length} times`}},toHaveReceivedCommandWith(t,c,a){const r=$(t).filter(n=>n[0]instanceof c),m=r.some(n=>this.equals(n[0].input,a)),o=c.name;return{pass:m,message:()=>{if(m){const s=e.red(o),u=e.cyan(JSON.stringify(a,void 0,2));return`Expected AWS SDK mock not to have received command ${s} with input:
+"use strict";const e={red:t=>`\x1B[31m${t}\x1B[39m`,green:t=>`\x1B[32m${t}\x1B[39m`,yellow:t=>`\x1B[33m${t}\x1B[39m`,blue:t=>`\x1B[34m${t}\x1B[39m`,magenta:t=>`\x1B[35m${t}\x1B[39m`,cyan:t=>`\x1B[36m${t}\x1B[39m`,gray:t=>`\x1B[90m${t}\x1B[39m`,bold:t=>`\x1B[1m${t}\x1B[22m`},$=t=>{const c=t.__rawCalls();return Array.isArray(c)?c.filter(a=>Array.isArray(a)&&a.length>0):[]},f={toHaveReceivedCommand(t,c){const a=$(t),r=a.some(([o])=>o instanceof c),m=c.name;return{pass:r,message:()=>{if(r)return`Expected AWS SDK mock not to have received command ${e.red(m)}`;const o=a.map(([n])=>n.constructor?.name??"Unknown");return o.length===0?`Expected AWS SDK mock to have received command ${e.red(m)}, but ${e.gray("no commands were received")}`:`Expected AWS SDK mock to have received command ${e.red(m)}, but received: ${e.yellow(o.join(", "))}`}}},toHaveReceivedCommandTimes(t,c,a){const r=$(t).filter(n=>n[0]instanceof c),m=r.length===a,o=c.name;return{pass:m,message:()=>m?`Expected AWS SDK mock not to have received command ${o} ${a} times`:`Expected AWS SDK mock to have received command ${o} ${a} times, but received ${r.length} times`}},toHaveReceivedCommandWith(t,c,a){const r=$(t).filter(n=>n[0]instanceof c),m=r.some(n=>this.equals(n[0].input,a)),o=c.name;return{pass:m,message:()=>{if(m){const s=e.red(o),u=e.cyan(JSON.stringify(a,void 0,2));return`Expected AWS SDK mock not to have received command ${s} with input:
 ${u}`}if(r.length===0){const s=e.red(o),u=e.cyan(JSON.stringify(a,void 0,2)),i=e.gray(`${o} was never called`);return`Expected AWS SDK mock to have received command ${s} with input:
 ${u}
 

package/{matchers-ClGOsQx8.js → matchers-DmTtFk31.js}

@@ -31,13 +31,13 @@ const e = {
    * ```
    */
   toHaveReceivedCommand(t, c) {
-    const a = $(t), r = a.some((o) => o[0] instanceof c), m = c.name;
+    const a = $(t), r = a.some(([o]) => o instanceof c), m = c.name;
     return {
       pass: r,
       message: () => {
         if (r)
           return `Expected AWS SDK mock not to have received command ${e.red(m)}`;
-        const o = a.map((n) => n[0].constructor?.name ?? "Unknown");
+        const o = a.map(([n]) => n.constructor?.name ?? "Unknown");
         return o.length === 0 ? `Expected AWS SDK mock to have received command ${e.red(m)}, but ${e.gray("no commands were received")}` : `Expected AWS SDK mock to have received command ${e.red(m)}, but received: ${e.yellow(o.join(", "))}`;
       }
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-sdk-vitest-mock",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -55,6 +55,7 @@
     "@swc-node/register": "1.11.1",
     "@swc/core": "1.15.3",
     "@swc/helpers": "0.5.17",
+    "@types/eslint-plugin-security": "3.0.0",
     "@types/node": "24.10.3",
     "@typescript-eslint/parser": "8.49.0",
     "@vitest/coverage-v8": "4.0.15",
@@ -66,6 +67,7 @@
     "eslint-plugin-sonarjs": "3.0.5",
     "eslint-plugin-unicorn": "62.0.0",
     "husky": "9.1.7",
+    "jiti": "2.6.1",
     "lint-staged": "16.2.7",
     "nx": "22.2.2",
     "prettier": "3.7.4",

package/vitest-setup.cjs

@@ -1 +1 @@
-"use strict";const e=require("vitest"),t=require("./matchers-Dkkl4vtx.cjs");e.expect.extend(t.matchers);
+"use strict";const e=require("vitest"),t=require("./matchers-CNhdB_9q.cjs");e.expect.extend(t.matchers);

package/vitest-setup.js

@@ -1,3 +1,3 @@
 import { expect as m } from "vitest";
-import { m as e } from "./matchers-ClGOsQx8.js";
+import { m as e } from "./matchers-DmTtFk31.js";
 m.extend(e);