aws-sdk-vitest-mock 1.0.13 → 1.0.14

package/index.cjs

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

package/index.js

@@ -1,104 +1,110 @@
-import { vi as w } from "vitest";
-import { c as O } from "./matchers-DmTtFk31.js";
+import { vi as $ } from "vitest";
+import { c as W } from "./matchers-DmTtFk31.js";
 import { m as ge } from "./matchers-DmTtFk31.js";
 import { readFileSync as P } from "node:fs";
 import A from "node:path";
 import { Readable as C } from "node:stream";
-class d extends Error {
-  constructor(r, o, c, n) {
-    super(r), this.name = o, this.code = o, this.statusCode = c, this.retryable = n;
+class f extends Error {
+  constructor(r, o, s, n) {
+    super(r), this.name = o, this.code = o, this.statusCode = s, this.retryable = n, this.$metadata = {
+      httpStatusCode: s
+    }, Object.setPrototypeOf(this, f.prototype);
   }
 }
-const T = (e) => new d(
+const T = (e) => new f(
   e ? `The specified key does not exist. Key: ${e}` : "The specified key does not exist.",
   "NoSuchKey",
   404,
   !1
-), I = (e) => new d(
+), I = (e) => new f(
   e ? `The specified bucket does not exist. Bucket: ${e}` : "The specified bucket does not exist.",
   "NoSuchBucket",
   404,
   !1
-), M = (e) => new d(
+), M = (e) => new f(
   e ? `Access Denied for resource: ${e}` : "Access Denied",
   "AccessDenied",
   403,
   !1
-), K = (e) => new d(
+), K = (e) => new f(
   e ? `Requested resource not found: ${e}` : "Requested resource not found",
   "ResourceNotFoundException",
   400,
   !1
-), B = () => new d(
+), B = () => new f(
   "The conditional request failed",
   "ConditionalCheckFailedException",
   400,
   !1
-), J = () => new d("Rate exceeded", "Throttling", 400, !0), q = () => new d(
+), J = () => new f("Rate exceeded", "Throttling", 400, !0), z = () => new f(
   "We encountered an internal error. Please try again.",
   "InternalServerError",
   500,
   !0
-), z = (e) => {
+), q = (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]";
   }
-}, S = (e, r) => {
-  const o = O.magenta("aws-sdk-vitest-mock(debug):");
+}, k = (e, r) => {
+  const o = W.magenta("aws-sdk-vitest-mock(debug):");
   if (r === void 0)
     console.log(`${o} ${e}`);
   else {
-    const c = z(r);
+    const s = q(r);
     console.log(`${o} ${e}
-${c}`);
+${s}`);
   }
 }, E = (e = !1) => ({
   enabled: e,
   explicitlySet: !1,
   log(r, o) {
-    this.enabled && S(r, o);
+    this.enabled && k(r, o);
   },
   logDirect(r, o) {
-    S(r, o);
+    k(r, o);
   }
 }), V = (e) => {
   e.enabled = !0, e.explicitlySet = !0;
-}, _ = (e) => {
-  e.enabled = !1, e.explicitlySet = !0;
 }, U = (e) => {
+  e.enabled = !1, e.explicitlySet = !0;
+}, _ = (e) => {
+  if (!e || typeof e != "string")
+    throw new TypeError("filePath must be a non-empty string");
   const r = A.resolve(e);
   try {
     const o = P(r, "utf8");
     if (e.endsWith(".json"))
       try {
         return JSON.parse(o);
-      } catch (c) {
-        const n = c instanceof Error ? c.message : String(c);
+      } catch (s) {
+        const n = s instanceof Error ? s.message : String(s);
         throw new Error(
           `Failed to parse JSON fixture at ${r}: ${n}`
         );
       }
     return o;
   } catch (o) {
-    const c = o instanceof Error ? o.message : String(o);
-    throw new Error(`Failed to load fixture at ${r}: ${c}`);
+    const s = o instanceof Error ? o.message : String(o);
+    throw new Error(`Failed to load fixture at ${r}: ${s}`);
   }
 }, G = (e, r = {}) => {
-  const { pageSize: o = 10, tokenKey: c = "NextToken", itemsKey: n = "Items" } = r;
+  const { pageSize: o = 10, tokenKey: s = "NextToken", itemsKey: n = "Items" } = r;
+  if (!Number.isInteger(o) || o <= 0)
+    throw new TypeError("pageSize must be a positive integer");
   if (e.length === 0)
     return [{ [n]: [] }];
-  const s = [];
+  const i = [];
   for (let t = 0; t < e.length; t += o) {
-    const i = e.slice(t, t + o), l = t + o < e.length, u = { [n]: i };
+    const c = e.slice(t, t + o), l = t + o < e.length, u = { [n]: c };
     if (l) {
-      const a = u, f = i[i.length - 1];
-      a[c] = f;
+      const a = u, g = c.at(-1);
+      a[s] = g;
     }
-    s.push(u);
+    i.push(u);
   }
-  return s;
+  return i;
 }, H = () => typeof process < "u" && process.versions?.node ? "node" : typeof process < "u" && process.versions?.bun ? "bun" : "browser", Q = (e) => {
   const r = typeof e == "string" ? Buffer.from(e, "utf8") : Buffer.from(e);
   let o = !1;
@@ -114,30 +120,32 @@ ${c}`);
       o.enqueue(r), o.close();
     }
   });
-}, $ = (e) => {
+}, w = (e) => {
+  if (e == null)
+    throw new TypeError("data must be a string, Buffer, or Uint8Array");
   const r = H();
   return r === "node" || r === "bun" ? Q(e) : X(e);
 };
 let N = !1;
-function ie(e) {
+function ce(e) {
   N = e;
 }
-function y(e) {
+function h(e) {
   return e.explicitlySet ? e.enabled : N;
 }
 function m(e, r) {
   return Object.keys(r).every((o) => {
-    const c = r[o], n = e[o];
-    return Array.isArray(c) ? !Array.isArray(n) || c.length > n.length ? !1 : c.every((s, t) => {
-      const i = n[t];
-      return s && typeof s == "object" && typeof i == "object" && i !== null ? m(
-        i,
-        s
-      ) : i === s;
-    }) : c && typeof c == "object" && !Array.isArray(c) ? typeof n != "object" || n === null ? !1 : m(
+    const s = r[o], n = e[o];
+    return Array.isArray(s) ? !Array.isArray(n) || s.length > n.length ? !1 : s.every((i, t) => {
+      const c = n[t];
+      return i && typeof i == "object" && typeof c == "object" && c !== null ? m(
+        c,
+        i
+      ) : c === i;
+    }) : s && typeof s == "object" && !Array.isArray(s) ? typeof n != "object" || n === null ? !1 : m(
       n,
-      c
-    ) : n === c;
+      s
+    ) : n === s;
   });
 }
 function v(e, r) {
@@ -145,23 +153,23 @@ function v(e, r) {
   if (typeof e != "object" || e === null || typeof r != "object" || r === null)
     return e === r;
   if (Array.isArray(e) && Array.isArray(r))
-    return e.length !== r.length ? !1 : e.every((n, s) => {
-      const t = r[s];
+    return e.length !== r.length ? !1 : e.every((n, i) => {
+      const t = r[i];
       return typeof n == "object" && n !== null && typeof t == "object" && t !== null ? v(n, t) : n === t;
     });
   if (Array.isArray(e) !== Array.isArray(r))
     return !1;
-  const o = Object.keys(e), c = Object.keys(r);
-  return o.length !== c.length ? !1 : c.every((n) => {
+  const o = Object.keys(e), s = Object.keys(r);
+  return o.length !== s.length ? !1 : s.every((n) => {
     if (!Object.prototype.hasOwnProperty.call(e, n)) return !1;
-    const s = e, t = r, i = s[n], l = t[n];
-    return typeof i == "object" && i !== null && typeof l == "object" && l !== null ? v(i, l) : i === l;
+    const i = e, t = r, c = i[n], l = t[n];
+    return typeof c == "object" && c !== null && typeof l == "object" && l !== null ? v(c, l) : c === l;
   });
 }
 function Y(e, r, o) {
-  const c = r.map((s, t) => {
-    const i = s.matcher ? JSON.stringify(s.matcher, void 0, 2) : "any input", l = s.strict ? " (strict mode)" : "";
-    return `  Mock #${t + 1}: ${i}${l}`;
+  const s = r.map((i, t) => {
+    const c = i.matcher ? JSON.stringify(i.matcher, void 0, 2) : "any input", l = i.strict ? " (strict mode)" : "";
+    return `  Mock #${t + 1}: ${c}${l}`;
   }).join(`
 `), n = JSON.stringify(o, void 0, 2);
   return new Error(
@@ -170,7 +178,7 @@ function Y(e, r, o) {
 Found ${r.length} mock(s) but none matched the input.
 
 Configured mocks:
-${c}
+${s}
 
 Received input:
 ${n}
@@ -194,46 +202,46 @@ function ee(e, r) {
 }
 function x(e) {
   return async function(r) {
-    const o = () => this, c = y(e.debugLogger), n = r.constructor.name;
-    c && e.debugLogger.logDirect(
+    const o = () => this, s = h(e.debugLogger), n = r.constructor.name;
+    s && e.debugLogger.logDirect(
       `Received command: ${n}`,
       r.input
     );
-    const s = e.map.get(
+    const i = e.map.get(
       r.constructor
     );
-    if (!s)
-      throw c && e.debugLogger.logDirect(
+    if (!i)
+      throw s && e.debugLogger.logDirect(
         `No mocks configured for ${n}`
       ), Z(n, r.input);
-    c && e.debugLogger.logDirect(
-      `Found ${s.length} mock(s) for ${n}`
+    s && e.debugLogger.logDirect(
+      `Found ${i.length} mock(s) for ${n}`
     );
-    const t = ee(s, r.input);
+    const t = ee(i, r.input);
     if (t === -1)
-      throw c && e.debugLogger.logDirect(
+      throw s && e.debugLogger.logDirect(
         `No matching mock found for ${n}`,
         r.input
-      ), Y(n, s, r.input);
-    const i = s[t];
-    if (!i)
+      ), Y(n, i, r.input);
+    const c = i[t];
+    if (!c)
       throw new Error(`Mock at index ${t} not found`);
-    return c && e.debugLogger.logDirect(
+    return s && e.debugLogger.logDirect(
       `Using mock at index ${t} for ${n}`
-    ), i.once && (s.splice(t, 1), c && e.debugLogger.logDirect(
+    ), c.once && (i.splice(t, 1), s && e.debugLogger.logDirect(
       `Removed one-time mock for ${n}`
-    )), i.handler(r.input, o());
+    )), c.handler(r.input, o());
   };
 }
 const D = (e, r, o) => ({
   reset() {
-    y(e.debugLogger) && e.debugLogger.logDirect(o.reset), r.mockClear();
+    h(e.debugLogger) && e.debugLogger.logDirect(o.reset), r.mockClear();
   },
   restore() {
-    y(e.debugLogger) && e.debugLogger.logDirect(o.restore), r.mockRestore(), e.map = /* @__PURE__ */ new WeakMap();
+    h(e.debugLogger) && e.debugLogger.logDirect(o.restore), r.mockRestore(), e.map = /* @__PURE__ */ new WeakMap();
   },
   calls() {
-    return r.mock.calls.map((c) => c[0]);
+    return r.mock.calls.map((s) => s[0]);
   },
   __rawCalls() {
     return r.mock.calls;
@@ -242,171 +250,171 @@ const D = (e, r, o) => ({
     V(e.debugLogger);
   },
   disableDebug() {
-    _(e.debugLogger);
+    U(e.debugLogger);
   }
 });
-function L(e, r, o, c = {}) {
-  const n = (t, i, l) => {
+function L(e, r, o, s = {}) {
+  const n = (t, c, l) => {
     const u = {
       matcher: o,
       handler: t,
-      once: i,
-      strict: !!c.strict
-    }, a = e.map.get(r) ?? [], f = y(e.debugLogger);
-    if (i) {
-      const g = a.findIndex((h) => !h.once);
-      g === -1 ? a.push(u) : a.splice(g, 0, u), e.map.set(
+      once: c,
+      strict: !!s.strict
+    }, a = e.map.get(r) ?? [], g = h(e.debugLogger);
+    if (c) {
+      const d = a.findIndex((p) => !p.once);
+      d === -1 ? a.push(u) : a.splice(d, 0, u), e.map.set(
         r,
         a
-      ), f && e.debugLogger.logDirect(
+      ), g && e.debugLogger.logDirect(
         `Configured ${l}Once for ${r.name}`,
-        o ? { matcher: o, strict: !!c.strict } : void 0
+        o ? { matcher: o, strict: !!s.strict } : void 0
       );
     } else {
-      const g = a.filter(
-        (h) => h.once || JSON.stringify(h.matcher) !== JSON.stringify(o)
+      const d = a.filter(
+        (p) => p.once || JSON.stringify(p.matcher) !== JSON.stringify(o)
       );
-      g.push(u), e.map.set(
+      d.push(u), e.map.set(
         r,
-        g
-      ), f && e.debugLogger.logDirect(
+        d
+      ), g && e.debugLogger.logDirect(
         `Configured ${l} for ${r.name}`,
-        o ? { matcher: o, strict: !!c.strict } : void 0
+        o ? { matcher: o, strict: !!s.strict } : void 0
       );
     }
-  }, s = {
+  }, i = {
     resolves(t) {
-      return n(() => Promise.resolve(t), !1, "resolves"), s;
+      return n(() => Promise.resolve(t), !1, "resolves"), i;
     },
     rejects(t) {
       return n(
         () => {
-          const i = typeof t == "string" ? new Error(t) : t;
-          return Promise.reject(i);
+          const c = typeof t == "string" ? new Error(t) : t;
+          return Promise.reject(c);
         },
         !1,
         "rejects"
-      ), s;
+      ), i;
     },
     callsFake(t) {
-      return n(t, !1, "callsFake"), s;
+      return n(t, !1, "callsFake"), i;
     },
     resolvesOnce(t) {
-      return n(() => Promise.resolve(t), !0, "resolves"), s;
+      return n(() => Promise.resolve(t), !0, "resolves"), i;
     },
     rejectsOnce(t) {
       return n(
         () => {
-          const i = typeof t == "string" ? new Error(t) : t;
-          return Promise.reject(i);
+          const c = typeof t == "string" ? new Error(t) : t;
+          return Promise.reject(c);
         },
         !0,
         "rejects"
-      ), s;
+      ), i;
     },
     callsFakeOnce(t) {
-      return n(t, !0, "callsFake"), s;
+      return n(t, !0, "callsFake"), i;
     },
     resolvesStream(t) {
       return n(
         () => Promise.resolve({
-          Body: $(t)
+          Body: w(t)
         }),
         !1,
         "resolvesStream"
-      ), s;
+      ), i;
     },
     resolvesStreamOnce(t) {
       return n(
         () => Promise.resolve({
-          Body: $(t)
+          Body: w(t)
         }),
         !0,
         "resolvesStream"
-      ), s;
+      ), i;
     },
-    resolvesWithDelay(t, i) {
+    resolvesWithDelay(t, c) {
       const l = (u) => {
-        setTimeout(() => u(t), i);
+        setTimeout(() => u(t), c);
       };
       return n(
         () => new Promise(l),
         !1,
         "resolvesWithDelay"
-      ), s;
+      ), i;
     },
-    rejectsWithDelay(t, i) {
-      const l = typeof t == "string" ? new Error(t) : t, u = (a, f) => {
-        setTimeout(() => f(l), i);
+    rejectsWithDelay(t, c) {
+      const l = typeof t == "string" ? new Error(t) : t, u = (a, g) => {
+        setTimeout(() => g(l), c);
       };
-      return n(() => new Promise(u), !1, "rejectsWithDelay"), s;
+      return n(() => new Promise(u), !1, "rejectsWithDelay"), i;
     },
     rejectsWithNoSuchKey(t) {
       return n(
         () => Promise.reject(T(t)),
         !1,
         "rejectsWithNoSuchKey"
-      ), s;
+      ), i;
     },
     rejectsWithNoSuchBucket(t) {
       return n(
         () => Promise.reject(I(t)),
         !1,
         "rejectsWithNoSuchBucket"
-      ), s;
+      ), i;
     },
     rejectsWithAccessDenied(t) {
       return n(
         () => Promise.reject(M(t)),
         !1,
         "rejectsWithAccessDenied"
-      ), s;
+      ), i;
     },
     rejectsWithResourceNotFound(t) {
       return n(
         () => Promise.reject(K(t)),
         !1,
         "rejectsWithResourceNotFound"
-      ), s;
+      ), i;
     },
     rejectsWithConditionalCheckFailed() {
       return n(
         () => Promise.reject(B()),
         !1,
         "rejectsWithConditionalCheckFailed"
-      ), s;
+      ), i;
     },
     rejectsWithThrottling() {
       return n(
         () => Promise.reject(J()),
         !1,
         "rejectsWithThrottling"
-      ), s;
+      ), i;
     },
     rejectsWithInternalServerError() {
       return n(
-        () => Promise.reject(q()),
+        () => Promise.reject(z()),
         !1,
         "rejectsWithInternalServerError"
-      ), s;
+      ), i;
     },
-    resolvesPaginated(t, i = {}) {
-      const l = G(t, i);
+    resolvesPaginated(t, c = {}) {
+      const l = G(t, c);
       let u = 0;
       return e.debugLogger.log(
         `Configured resolvesPaginated for ${r.name}`,
-        { pageSize: i.pageSize, itemsCount: t.length }
+        { pageSize: c.pageSize, itemsCount: t.length }
       ), n(
         (a) => {
-          const f = i.tokenKey || "NextToken", g = i.inputTokenKey || f, b = a[g];
-          if (b != null) {
-            const R = i.itemsKey || "Items";
+          const g = c.tokenKey || "NextToken", d = c.inputTokenKey || g, y = a[d];
+          if (y != null) {
+            const R = c.itemsKey || "Items";
             let j = 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(b)) {
+            for (const O of l) {
+              const b = O[R];
+              if (b && b.length > 0) {
+                const F = b.at(-1);
+                if (JSON.stringify(F) === JSON.stringify(y)) {
                   u = j + 1;
                   break;
                 }
@@ -415,18 +423,17 @@ function L(e, r, o, c = {}) {
             }
           } else
             u = 0;
-          const k = (
+          const S = (
             // 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]
+            l[u] || l.at(-1) || l[0]
           );
-          if (!k)
+          if (!S)
             throw new Error("No paginated responses available");
-          return u = Math.min(u + 1, l.length - 1), Promise.resolve(k);
+          return u = Math.min(u + 1, l.length - 1), Promise.resolve(S);
         },
         !1,
         "resolvesPaginated"
-      ), s;
+      ), i;
     },
     resolvesFromFile(t) {
       return e.debugLogger.log(
@@ -434,30 +441,30 @@ function L(e, r, o, c = {}) {
         { filePath: t }
       ), n(
         () => {
-          const i = U(t);
-          return Promise.resolve(i);
+          const c = _(t);
+          return Promise.resolve(c);
         },
         !1,
         "resolvesFromFile"
-      ), s;
+      ), i;
     }
   };
-  return s;
+  return i;
 }
 const le = (e) => {
   const r = {
     map: /* @__PURE__ */ new WeakMap(),
     debugLogger: E()
-  }, o = e.prototype, c = w.spyOn(o, "send").mockImplementation(x(r)), n = D(r, c, {
+  }, o = e.prototype, s = $.spyOn(o, "send").mockImplementation(x(r)), n = D(r, s, {
     reset: "Clearing call history (mocks preserved)",
     restore: "Restoring original client behavior and clearing all mocks"
   });
   return {
     client: void 0,
-    on: (t, i, l) => L(
+    on: (t, c, l) => L(
       r,
       t,
-      i,
+      c,
       l
     ),
     ...n
@@ -466,24 +473,24 @@ const le = (e) => {
   const r = {
     map: /* @__PURE__ */ new WeakMap(),
     debugLogger: E()
-  }, o = w.spyOn(e, "send").mockImplementation(x(r)), c = D(r, o, {
+  }, o = $.spyOn(e, "send").mockImplementation(x(r)), s = D(r, 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: (s, t, i) => L(
+    on: (i, t, c) => L(
       r,
-      s,
+      i,
       t,
-      i
+      c
     ),
-    ...c
+    ...s
   };
 };
 export {
   ge as matchers,
   le as mockClient,
   ue as mockClientInstance,
-  ie as setGlobalDebug
+  ce as setGlobalDebug
 };

package/lib/utils/aws-errors.d.ts

@@ -6,6 +6,14 @@ export declare class AwsError extends Error {
     readonly code: string;
     readonly statusCode?: number;
     readonly retryable?: boolean;
+    readonly $metadata?: {
+        httpStatusCode?: number;
+        requestId?: string;
+        extendedRequestId?: string;
+        cfId?: string;
+        attempts?: number;
+        totalRetryDelay?: number;
+    };
     constructor(message: string, code: string, statusCode?: number, retryable?: boolean);
 }
 export declare const createNoSuchKeyError: (key?: string) => AwsError;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-sdk-vitest-mock",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -59,7 +59,7 @@
     "@types/eslint-plugin-security": "3.0.1",
     "@types/node": "24.10.9",
     "@typescript-eslint/parser": "8.53.1",
-    "@vitest/coverage-v8": "4.0.17",
+    "@vitest/coverage-v8": "4.0.18",
     "@vitest/eslint-plugin": "1.6.6",
     "eslint": "9.39.2",
     "eslint-config-prettier": "10.1.8",