@typespec/spec-api 0.1.0-dev.0 → 0.1.0-dev.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @typespec/spec-api
 
+## 0.1.0-alpha.14
+
+### Features
+
+- [#10011](https://github.com/microsoft/typespec/pull/10011) Add matcher framework for flexible value comparison in scenarios. `match.dateTime()` enables semantic datetime comparison that handles precision and timezone differences across languages.
+
+### Bug Fixes
+
+- [#9995](https://github.com/microsoft/typespec/pull/9995) Remove prettier used for ValidationError message, in validateXmlBodyEquals.
+
+
+## 0.1.0-alpha.13
+
+### Bump dependencies
+
+- [#9838](https://github.com/microsoft/typespec/pull/9838) Upgrade dependencies
+
+
 ## 0.1.0-alpha.12
 
 ### Bump dependencies

package/dist/expectation.d.ts

@@ -1,4 +1,4 @@
-import { CollectionFormat, RequestExt } from "./types.js";
+import { CollectionFormat, RequestExt, Resolver, ResolverConfig } from "./types.js";
 /**
  * Class containing all the expectations that can be run on the request.
  */
@@ -53,11 +53,14 @@ export declare class RequestExpectation {
      */
     deepEqual(actual: unknown, expected: unknown, message?: string): void;
     /**
-     * Expect the body of the request to be semantically equivalent to the provided XML string.
-     * The XML declaration prefix will automatically be added to expectedBody.
-     * @param expectedBody expected value of request body.
+     * Expect the body of the request to be semantically equivalent to the provided XML.
+     * Accepts a plain string or a Resolver (e.g. from `xml\`...\``).
+     * When a Resolver with matchers is provided, matcher-aware comparison is used.
+     * The XML declaration prefix will automatically be added.
+     * @param expectedBody expected XML body as a string or Resolver.
+     * @param config resolver config (required when expectedBody is a Resolver).
      * @throws {ValidationError} if there is an error.
      */
-    xmlBodyEquals(expectedBody: string): void;
+    xmlBodyEquals(expectedBody: string | Resolver, config?: ResolverConfig): void;
 }
 //# sourceMappingURL=expectation.d.ts.map

package/dist/expectation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expectation.d.ts","sourceRoot":"","sources":["../src/expectation.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D;;GAEG;AACH,qBAAa,kBAAkB;IACV,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,UAAU;IACtD;;;;OAIG;IACI,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI;IAIxE;;;;OAIG;IACI,UAAU,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAI7D;;;;OAIG;IACI,iBAAiB,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAIpE;;;OAGG;IACI,SAAS,IAAI,IAAI;IAIxB;;;OAGG;IACI,YAAY,IAAI,IAAI;IAI3B;;;;;OAKG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAItE;;;;OAIG;IACI,kBAAkB,CACvB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,EAChC,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,IAAI;IAIP;;;;OAIG;IACI,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,SAA0B,GAAG,IAAI;IAM7F;;;;;OAKG;IACI,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;CAGjD"}
+{"version":3,"file":"expectation.d.ts","sourceRoot":"","sources":["../src/expectation.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGpF;;GAEG;AACH,qBAAa,kBAAkB;IACV,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,UAAU;IACtD;;;;OAIG;IACI,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI;IAIxE;;;;OAIG;IACI,UAAU,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAI7D;;;;OAIG;IACI,iBAAiB,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAIpE;;;OAGG;IACI,SAAS,IAAI,IAAI;IAIxB;;;OAGG;IACI,YAAY,IAAI,IAAI;IAI3B;;;;;OAKG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAItE;;;;OAIG;IACI,kBAAkB,CACvB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,EAChC,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,IAAI;IAIP;;;;OAIG;IACI,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,SAA0B,GAAG,IAAI;IAO7F;;;;;;;;OAQG;IACI,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI;CAGrF"}

package/dist/expectation.js

@@ -1,4 +1,4 @@
-import deepEqual from "deep-equal";
+import { matchValues } from "./match-engine.js";
 import { validateBodyEmpty, validateBodyEquals, validateBodyNotEmpty, validateCoercedDateBodyEquals, validateHeader, validateQueryParam, validateRawBodyEquals, validateXmlBodyEquals, } from "./request-validations.js";
 import { ValidationError } from "./validation-error.js";
 /**
@@ -70,18 +70,22 @@ export class RequestExpectation {
      * @param expected Expected value
      */
     deepEqual(actual, expected, message = "Values not deep equal") {
-        if (!deepEqual(actual, expected, { strict: true })) {
-            throw new ValidationError(message, expected, actual);
+        const result = matchValues(actual, expected);
+        if (!result.pass) {
+            throw new ValidationError(`${message}: ${result.message}`, expected, actual);
         }
     }
     /**
-     * Expect the body of the request to be semantically equivalent to the provided XML string.
-     * The XML declaration prefix will automatically be added to expectedBody.
-     * @param expectedBody expected value of request body.
+     * Expect the body of the request to be semantically equivalent to the provided XML.
+     * Accepts a plain string or a Resolver (e.g. from `xml\`...\``).
+     * When a Resolver with matchers is provided, matcher-aware comparison is used.
+     * The XML declaration prefix will automatically be added.
+     * @param expectedBody expected XML body as a string or Resolver.
+     * @param config resolver config (required when expectedBody is a Resolver).
      * @throws {ValidationError} if there is an error.
      */
-    xmlBodyEquals(expectedBody) {
-        validateXmlBodyEquals(this.originalRequest, expectedBody);
+    xmlBodyEquals(expectedBody, config) {
+        validateXmlBodyEquals(this.originalRequest, expectedBody, config);
     }
 }
 //# sourceMappingURL=expectation.js.map

package/dist/expectation.js.map

@@ -1 +1 @@
-{"version":3,"file":"expectation.js","sourceRoot":"","sources":["../src/expectation.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACF;IAA3B,YAA2B,eAA2B;QAA3B,oBAAe,GAAf,eAAe,CAAY;IAAG,CAAC;IAC1D;;;;OAIG;IACI,aAAa,CAAC,eAA4C;QAC/D,qBAAqB,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,eAAoC;QACpD,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACI,iBAAiB,CAAC,eAAoC;QAC3D,6BAA6B,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACI,SAAS;QACd,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,UAAkB,EAAE,aAAqB;QAC7D,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACI,kBAAkB,CACvB,SAAiB,EACjB,aAAgC,EAChC,gBAAmC;QAEnC,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;IACvF,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,MAAe,EAAE,QAAiB,EAAE,OAAO,GAAG,uBAAuB;QACpF,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,YAAoB;QACvC,qBAAqB,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC5D,CAAC;CACF"}
+{"version":3,"file":"expectation.js","sourceRoot":"","sources":["../src/expectation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACF;IAA3B,YAA2B,eAA2B;QAA3B,oBAAe,GAAf,eAAe,CAAY;IAAG,CAAC;IAC1D;;;;OAIG;IACI,aAAa,CAAC,eAA4C;QAC/D,qBAAqB,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,eAAoC;QACpD,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACI,iBAAiB,CAAC,eAAoC;QAC3D,6BAA6B,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACI,SAAS;QACd,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,UAAkB,EAAE,aAAqB;QAC7D,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACI,kBAAkB,CACvB,SAAiB,EACjB,aAAgC,EAChC,gBAAmC;QAEnC,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;IACvF,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,MAAe,EAAE,QAAiB,EAAE,OAAO,GAAG,uBAAuB;QACpF,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,eAAe,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACI,aAAa,CAAC,YAA+B,EAAE,MAAuB;QAC3E,qBAAqB,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { createMatcher, err, isMatcher, match, matchValues, ok, type MatchResult, type MockValueMatcher, } from "./matchers/index.js";
 export { MockRequest } from "./mock-request.js";
 export { BODY_EMPTY_ERROR_MESSAGE, BODY_NOT_EMPTY_ERROR_MESSAGE, BODY_NOT_EQUAL_ERROR_MESSAGE, validateBodyEmpty, validateBodyEquals, validateBodyNotEmpty, validateCoercedDateBodyEquals, validateHeader, validateQueryParam, validateRawBodyEquals, validateValueFormat, validateXmlBodyEquals, } from "./request-validations.js";
 export { dyn, dynItem, expandDyns, json, multipart, xml } from "./response-utils.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACL,sBAAsB,EACtB,UAAU,EACV,aAAa,EACb,QAAQ,EACR,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,GAAG,EACH,SAAS,EACT,KAAK,EACL,WAAW,EACX,EAAE,EACF,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACL,sBAAsB,EACtB,UAAU,EACV,aAAa,EACb,QAAQ,EACR,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { createMatcher, err, isMatcher, match, matchValues, ok, } from "./matchers/index.js";
 export { MockRequest } from "./mock-request.js";
 export { BODY_EMPTY_ERROR_MESSAGE, BODY_NOT_EMPTY_ERROR_MESSAGE, BODY_NOT_EQUAL_ERROR_MESSAGE, validateBodyEmpty, validateBodyEquals, validateBodyNotEmpty, validateCoercedDateBodyEquals, validateHeader, validateQueryParam, validateRawBodyEquals, validateValueFormat, validateXmlBodyEquals, } from "./request-validations.js";
 export { dyn, dynItem, expandDyns, json, multipart, xml } from "./response-utils.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAEL,UAAU,EACV,aAAa,EACb,QAAQ,EACR,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,IAAI,GAmBL,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,GAAG,EACH,SAAS,EACT,KAAK,EACL,WAAW,EACX,EAAE,GAGH,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAEL,UAAU,EACV,aAAa,EACb,QAAQ,EACR,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,IAAI,GAmBL,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/match-engine.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Matcher framework for Spector mock API validation.
+ *
+ * Matchers are special objects that can be placed anywhere in an expected value tree.
+ * The comparison engine recognizes them and delegates to `matcher.check(actual)`
+ * instead of doing strict equality — enabling flexible comparisons for types like
+ * datetime that serialize differently across languages.
+ */
+/** Symbol used to identify matcher objects */
+export declare const MatcherSymbol: unique symbol;
+/** Result of a match operation */
+export type MatchResult = {
+    pass: true;
+} | {
+    pass: false;
+    message: string;
+};
+/** Create a passing match result */
+export declare function ok(): MatchResult;
+/** Create a failing match result with a message */
+export declare function err(message: string): MatchResult;
+/**
+ * Interface for custom value matchers.
+ * Implement this to create new matcher types.
+ */
+export interface MockValueMatcher<T = unknown> {
+    readonly [MatcherSymbol]: true;
+    /** Check whether the actual value matches the expectation */
+    check(actual: unknown, config?: MatcherConfig): MatchResult;
+    /** The raw value to use when serializing */
+    serialize(config?: MatcherConfig): T;
+    /** Human-readable description for debugging */
+    toString(): string;
+}
+/** Configuration available to matchers at runtime */
+export interface MatcherConfig {
+    baseUrl: string;
+}
+interface MatcherImpl<T> {
+    check(actual: unknown): MatchResult;
+    serialize(): T;
+    toString?: () => string;
+}
+/** Create a MockValueMatcher with the MatcherSymbol already set.
+ *  Accepts either a plain implementation object (for matchers that don't need config)
+ *  or a factory function `(config) => impl` (for matchers that do).
+ */
+export declare function createMatcher<T = unknown>(implOrFactory: MatcherImpl<T> | ((config: MatcherConfig) => MatcherImpl<T>)): MockValueMatcher<T>;
+/** Type guard to check if a value is a MockValueMatcher */
+export declare function isMatcher(value: unknown): value is MockValueMatcher;
+/**
+ * Recursively compares actual vs expected values.
+ * When a MockValueMatcher is encountered in the expected tree, delegates to matcher.check().
+ * Otherwise uses strict equality semantics (same as deep-equal with strict: true).
+ */
+export declare function matchValues(actual: unknown, expected: unknown, path?: string, config?: MatcherConfig): MatchResult;
+export {};
+//# sourceMappingURL=match-engine.d.ts.map

package/dist/match-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-engine.d.ts","sourceRoot":"","sources":["../src/match-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,aAAa,EAAE,OAAO,MAAqC,CAAC;AAEzE,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAI5E,oCAAoC;AACpC,wBAAgB,EAAE,IAAI,WAAW,CAEhC;AAED,mDAAmD;AACnD,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAEhD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;IAC/B,6DAA6D;IAC7D,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC;IAC5D,4CAA4C;IAC5C,SAAS,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC;IAGrC,+CAA+C;IAC/C,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,UAAU,WAAW,CAAC,CAAC;IACrB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;IACpC,SAAS,IAAI,CAAC,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,GAC1E,gBAAgB,CAAC,CAAC,CAAC,CAqBrB;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAOnE;AAiBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,OAAO,EACjB,IAAI,GAAE,MAAY,EAClB,MAAM,GAAE,aAA2B,GAClC,WAAW,CAoGb"}

package/dist/match-engine.js

@@ -0,0 +1,156 @@
+/**
+ * Matcher framework for Spector mock API validation.
+ *
+ * Matchers are special objects that can be placed anywhere in an expected value tree.
+ * The comparison engine recognizes them and delegates to `matcher.check(actual)`
+ * instead of doing strict equality — enabling flexible comparisons for types like
+ * datetime that serialize differently across languages.
+ */
+/** Symbol used to identify matcher objects */
+export const MatcherSymbol = Symbol.for("SpectorMatcher");
+const OK = Object.freeze({ pass: true });
+/** Create a passing match result */
+export function ok() {
+    return OK;
+}
+/** Create a failing match result with a message */
+export function err(message) {
+    return { pass: false, message };
+}
+const emptyConfig = { baseUrl: "" };
+/** Create a MockValueMatcher with the MatcherSymbol already set.
+ *  Accepts either a plain implementation object (for matchers that don't need config)
+ *  or a factory function `(config) => impl` (for matchers that do).
+ */
+export function createMatcher(implOrFactory) {
+    const resolve = typeof implOrFactory === "function"
+        ? (config) => implOrFactory(config)
+        : () => implOrFactory;
+    return {
+        [MatcherSymbol]: true,
+        check(actual, config) {
+            return resolve(config ?? emptyConfig).check(actual);
+        },
+        serialize(config) {
+            return resolve(config ?? emptyConfig).serialize();
+        },
+        toJSON() {
+            return resolve(emptyConfig).serialize();
+        },
+        toString() {
+            const impl = resolve(emptyConfig);
+            return impl.toString?.() ?? String(impl.serialize());
+        },
+    };
+}
+/** Type guard to check if a value is a MockValueMatcher */
+export function isMatcher(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        MatcherSymbol in value &&
+        value[MatcherSymbol] === true);
+}
+function formatValue(value) {
+    if (value === null)
+        return "null";
+    if (value === undefined)
+        return "undefined";
+    if (typeof value === "string")
+        return `"${value}"`;
+    if (Buffer.isBuffer(value))
+        return `Buffer(${value.length})`;
+    if (Array.isArray(value))
+        return `Array(${value.length})`;
+    if (typeof value === "object")
+        return JSON.stringify(value);
+    return String(value);
+}
+function pathErr(message, path) {
+    const prefix = path ? `at ${path}: ` : "";
+    return err(`${prefix}${message}`);
+}
+/**
+ * Recursively compares actual vs expected values.
+ * When a MockValueMatcher is encountered in the expected tree, delegates to matcher.check().
+ * Otherwise uses strict equality semantics (same as deep-equal with strict: true).
+ */
+export function matchValues(actual, expected, path = "$", config = emptyConfig) {
+    if (expected === actual) {
+        return ok();
+    }
+    if (isMatcher(expected)) {
+        const result = expected.check(actual, config);
+        if (!result.pass) {
+            return pathErr(result.message, path);
+        }
+        return result;
+    }
+    if (typeof expected !== typeof actual) {
+        return pathErr(`Type mismatch: expected ${typeof expected} but got ${typeof actual} (${formatValue(actual)})`, path);
+    }
+    if (expected === null || actual === null) {
+        return pathErr(`Expected ${formatValue(expected)} but got ${formatValue(actual)}`, path);
+    }
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual)) {
+            return pathErr(`Expected an array but got ${formatValue(actual)}`, path);
+        }
+        if (expected.length !== actual.length) {
+            return pathErr(`Array length mismatch: expected ${expected.length} but got ${actual.length}`, path);
+        }
+        for (let i = 0; i < expected.length; i++) {
+            const result = matchValues(actual[i], expected[i], `${path}[${i}]`, config);
+            if (!result.pass) {
+                return result;
+            }
+        }
+        return ok();
+    }
+    if (Buffer.isBuffer(expected)) {
+        if (!Buffer.isBuffer(actual)) {
+            return pathErr(`Expected a Buffer but got ${typeof actual}`, path);
+        }
+        if (!expected.equals(actual)) {
+            return pathErr(`Buffer contents differ`, path);
+        }
+        return ok();
+    }
+    if (typeof expected === "object") {
+        const expectedObj = expected;
+        const actualObj = actual;
+        // Keys with undefined values in expected mean "must not be present in actual"
+        const expectedPresentKeys = Object.keys(expectedObj).filter((k) => expectedObj[k] !== undefined);
+        const expectedAbsentKeys = Object.keys(expectedObj).filter((k) => expectedObj[k] === undefined);
+        const actualKeys = Object.keys(actualObj);
+        // Verify keys that should be absent are not in actual
+        for (const key of expectedAbsentKeys) {
+            if (key in actualObj && actualObj[key] !== undefined) {
+                return pathErr(`Key "${key}" should not be present but got ${formatValue(actualObj[key])}`, path);
+            }
+        }
+        if (expectedPresentKeys.length !== actualKeys.length) {
+            const missing = expectedPresentKeys.filter((k) => !(k in actualObj));
+            const extra = actualKeys.filter((k) => !expectedPresentKeys.includes(k) && !expectedAbsentKeys.includes(k));
+            const parts = [
+                `Key count mismatch: expected ${expectedPresentKeys.length} but got ${actualKeys.length}`,
+            ];
+            if (missing.length > 0)
+                parts.push(`missing: [${missing.join(", ")}]`);
+            if (extra.length > 0)
+                parts.push(`extra: [${extra.join(", ")}]`);
+            return pathErr(parts.join(". "), path);
+        }
+        for (const key of expectedPresentKeys) {
+            if (!(key in actualObj)) {
+                return pathErr(`Missing key "${key}"`, path);
+            }
+            const result = matchValues(actualObj[key], expectedObj[key], `${path}.${key}`, config);
+            if (!result.pass) {
+                return result;
+            }
+        }
+        return ok();
+    }
+    return pathErr(`Expected ${formatValue(expected)} but got ${formatValue(actual)}`, path);
+}
+//# sourceMappingURL=match-engine.js.map

package/dist/match-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-engine.js","sourceRoot":"","sources":["../src/match-engine.ts"],"names":[],"mappings":"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"}

package/dist/matchers/datetime.d.ts

@@ -0,0 +1,8 @@
+import { type MockValueMatcher } from "../match-engine.js";
+export declare const dateTimeMatcher: {
+    rfc3339(value: string): MockValueMatcher<string>;
+    /** Like rfc3339 but rejects timezone offsets — only Z (UTC) suffix is allowed. */
+    utcRfc3339(value: string): MockValueMatcher<string>;
+    rfc7231(value: string): MockValueMatcher<string>;
+};
+//# sourceMappingURL=datetime.d.ts.map

package/dist/matchers/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/matchers/datetime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,gBAAgB,EAAM,MAAM,oBAAoB,CAAC;AAiDnF,eAAO,MAAM,eAAe;mBACX,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAGhD,kFAAkF;sBAChE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;mBAQpC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAGjD,CAAC"}

package/dist/matchers/datetime.js

@@ -0,0 +1,47 @@
+import { createMatcher, err, ok } from "../match-engine.js";
+const rfc3339Pattern = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/i;
+const utcRfc3339Pattern = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/i;
+const rfc7231Pattern = /^(Mon|Tue|Wed|Thu|Fri|Sat|Sun),\s\d{2}\s(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s\d{4}\s\d{2}:\d{2}:\d{2}\sGMT$/i;
+function createDateTimeMatcher(value, label, formatName, formatPattern) {
+    const expectedMs = Date.parse(value);
+    if (isNaN(expectedMs)) {
+        throw new Error(`${label}: invalid datetime value: ${value}`);
+    }
+    return createMatcher({
+        check(actual) {
+            if (typeof actual !== "string") {
+                return err(`${label}: expected a string but got ${typeof actual} (${JSON.stringify(actual)})`);
+            }
+            if (!formatPattern.test(actual)) {
+                return err(`${label}: expected ${formatName} format but got "${actual}"`);
+            }
+            const actualMs = Date.parse(actual);
+            if (isNaN(actualMs)) {
+                return err(`${label}: value "${actual}" matches ${formatName} format but is not a valid date`);
+            }
+            if (actualMs !== expectedMs) {
+                return err(`${label}: timestamps differ \u2014 expected ${new Date(expectedMs).toISOString()} but got ${new Date(actualMs).toISOString()}`);
+            }
+            return ok();
+        },
+        serialize() {
+            return value;
+        },
+        toString() {
+            return `${label}(${value})`;
+        },
+    });
+}
+export const dateTimeMatcher = {
+    rfc3339(value) {
+        return createDateTimeMatcher(value, "match.dateTime.rfc3339", "rfc3339", rfc3339Pattern);
+    },
+    /** Like rfc3339 but rejects timezone offsets — only Z (UTC) suffix is allowed. */
+    utcRfc3339(value) {
+        return createDateTimeMatcher(value, "match.dateTime.utcRfc3339", "utcRfc3339", utcRfc3339Pattern);
+    },
+    rfc7231(value) {
+        return createDateTimeMatcher(value, "match.dateTime.rfc7231", "rfc7231", rfc7231Pattern);
+    },
+};
+//# sourceMappingURL=datetime.js.map

package/dist/matchers/datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../src/matchers/datetime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,GAAG,EAAyB,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAEnF,MAAM,cAAc,GAAG,oEAAoE,CAAC;AAC5F,MAAM,iBAAiB,GAAG,iDAAiD,CAAC;AAC5E,MAAM,cAAc,GAClB,4HAA4H,CAAC;AAE/H,SAAS,qBAAqB,CAC5B,KAAa,EACb,KAAa,EACb,UAAkB,EAClB,aAAqB;IAErB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,aAAa,CAAC;QACnB,KAAK,CAAC,MAAe;YACnB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,CACR,GAAG,KAAK,+BAA+B,OAAO,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CACnF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,OAAO,GAAG,CAAC,GAAG,KAAK,cAAc,UAAU,oBAAoB,MAAM,GAAG,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpB,OAAO,GAAG,CACR,GAAG,KAAK,YAAY,MAAM,aAAa,UAAU,iCAAiC,CACnF,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC5B,OAAO,GAAG,CACR,GAAG,KAAK,uCAAuC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAChI,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QACD,SAAS;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,QAAQ;YACN,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,CAAC,KAAa;QACnB,OAAO,qBAAqB,CAAC,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAC3F,CAAC;IACD,kFAAkF;IAClF,UAAU,CAAC,KAAa;QACtB,OAAO,qBAAqB,CAC1B,KAAK,EACL,2BAA2B,EAC3B,YAAY,EACZ,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,KAAa;QACnB,OAAO,qBAAqB,CAAC,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAC3F,CAAC;CACF,CAAC"}

package/dist/matchers/index.d.ts

@@ -0,0 +1,39 @@
+import { baseUrlMatcher } from "./local-url.js";
+export { createMatcher, err, isMatcher, MatcherSymbol, matchValues, ok, type MatcherConfig, type MatchResult, type MockValueMatcher, } from "../match-engine.js";
+export { dateTimeMatcher } from "./datetime.js";
+/**
+ * Namespace for built-in matchers.
+ */
+export declare const match: {
+    /**
+     * Matchers for comparing datetime values semantically.
+     * Validates that the actual value is in the correct format and represents
+     * the same point in time as the expected value.
+     *
+     * @example
+     * ```ts
+     * match.dateTime.rfc3339("2022-08-26T18:38:00.000Z")
+     * match.dateTime.utcRfc3339("2022-08-26T18:38:00.000Z") // rejects offsets, only Z
+     * match.dateTime.rfc7231("Fri, 26 Aug 2022 14:38:00 GMT")
+     * ```
+     */
+    dateTime: {
+        rfc3339(value: string): import("../match-engine.js").MockValueMatcher<string>;
+        utcRfc3339(value: string): import("../match-engine.js").MockValueMatcher<string>;
+        rfc7231(value: string): import("../match-engine.js").MockValueMatcher<string>;
+    };
+    /**
+     * Matcher for URL values that include the server's base URL.
+     *
+     * The matcher is created with just the path portion. At runtime, `expandDyns()`
+     * resolves it by injecting the server's actual base URL (e.g. `http://localhost:3000`).
+     * The resolved matcher validates that the actual value equals `baseUrl + path`.
+     *
+     * @example
+     * ```ts
+     * match.localUrl("/payload/pageable/next-page")
+     * ```
+     */
+    localUrl: typeof baseUrlMatcher;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/matchers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/matchers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACL,aAAa,EACb,GAAG,EACH,SAAS,EACT,aAAa,EACb,WAAW,EACX,EAAE,EACF,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;;;;;;;;;;OAWG;;;;;;IAGH;;;;;;;;;;;OAWG;;CAEJ,CAAC"}

package/dist/matchers/index.js

@@ -0,0 +1,36 @@
+import { dateTimeMatcher } from "./datetime.js";
+import { baseUrlMatcher } from "./local-url.js";
+export { createMatcher, err, isMatcher, MatcherSymbol, matchValues, ok, } from "../match-engine.js";
+export { dateTimeMatcher } from "./datetime.js";
+/**
+ * Namespace for built-in matchers.
+ */
+export const match = {
+    /**
+     * Matchers for comparing datetime values semantically.
+     * Validates that the actual value is in the correct format and represents
+     * the same point in time as the expected value.
+     *
+     * @example
+     * ```ts
+     * match.dateTime.rfc3339("2022-08-26T18:38:00.000Z")
+     * match.dateTime.utcRfc3339("2022-08-26T18:38:00.000Z") // rejects offsets, only Z
+     * match.dateTime.rfc7231("Fri, 26 Aug 2022 14:38:00 GMT")
+     * ```
+     */
+    dateTime: dateTimeMatcher,
+    /**
+     * Matcher for URL values that include the server's base URL.
+     *
+     * The matcher is created with just the path portion. At runtime, `expandDyns()`
+     * resolves it by injecting the server's actual base URL (e.g. `http://localhost:3000`).
+     * The resolved matcher validates that the actual value equals `baseUrl + path`.
+     *
+     * @example
+     * ```ts
+     * match.localUrl("/payload/pageable/next-page")
+     * ```
+     */
+    localUrl: baseUrlMatcher,
+};
+//# sourceMappingURL=index.js.map

package/dist/matchers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matchers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACL,aAAa,EACb,GAAG,EACH,SAAS,EACT,aAAa,EACb,WAAW,EACX,EAAE,GAIH,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,eAAe;IAEzB;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,cAAc;CACzB,CAAC"}

package/dist/matchers/local-url.d.ts

@@ -0,0 +1,3 @@
+import { type MockValueMatcher } from "../match-engine.js";
+export declare function baseUrlMatcher(path: string): MockValueMatcher<string>;
+//# sourceMappingURL=local-url.d.ts.map

package/dist/matchers/local-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-url.d.ts","sourceRoot":"","sources":["../../src/matchers/local-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,gBAAgB,EAAM,MAAM,oBAAoB,CAAC;AAEnF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAqBrE"}

package/dist/matchers/local-url.js

@@ -0,0 +1,22 @@
+import { createMatcher, err, ok } from "../match-engine.js";
+export function baseUrlMatcher(path) {
+    return createMatcher((config) => ({
+        check(actual) {
+            if (typeof actual !== "string") {
+                return err(`match.localUrl: expected a string but got ${typeof actual} (${JSON.stringify(actual)})`);
+            }
+            const expected = config.baseUrl + path;
+            if (actual !== expected) {
+                return err(`match.localUrl: expected "${expected}" but got "${actual}"`);
+            }
+            return ok();
+        },
+        serialize() {
+            return config.baseUrl + path;
+        },
+        toString() {
+            return `match.localUrl("${path}")`;
+        },
+    }));
+}
+//# sourceMappingURL=local-url.js.map

package/dist/matchers/local-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-url.js","sourceRoot":"","sources":["../../src/matchers/local-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,GAAG,EAAyB,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAEnF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,aAAa,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,MAAe;YACnB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,CACR,6CAA6C,OAAO,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CACzF,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACvC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,GAAG,CAAC,6BAA6B,QAAQ,cAAc,MAAM,GAAG,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QACD,SAAS;YACP,OAAO,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,CAAC;QACD,QAAQ;YACN,OAAO,mBAAmB,IAAI,IAAI,CAAC;QACrC,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/request-validations.d.ts

@@ -1,10 +1,10 @@
-import { CollectionFormat, RequestExt } from "./types.js";
+import { CollectionFormat, RequestExt, Resolver, ResolverConfig } from "./types.js";
 export declare const BODY_NOT_EQUAL_ERROR_MESSAGE = "Body provided doesn't match expected body";
 export declare const BODY_EMPTY_ERROR_MESSAGE = "Body should exists";
 export declare const BODY_NOT_EMPTY_ERROR_MESSAGE = "Body should be empty";
 export declare const validateRawBodyEquals: (request: RequestExt, expectedRawBody: string | Buffer | undefined) => void;
 export declare const validateBodyEquals: (request: RequestExt, expectedBody: unknown | undefined) => void;
-export declare const validateXmlBodyEquals: (request: RequestExt, expectedBody: string) => void;
+export declare const validateXmlBodyEquals: (request: RequestExt, expectedBody: string | Resolver, config?: ResolverConfig) => void;
 export declare const validateCoercedDateBodyEquals: (request: RequestExt, expectedBody: unknown | undefined) => void;
 export declare const validateBodyEmpty: (request: RequestExt) => void;
 export declare const validateBodyNotEmpty: (request: RequestExt) => void;

package/dist/request-validations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-validations.d.ts","sourceRoot":"","sources":["../src/request-validations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D,eAAO,MAAM,4BAA4B,8CAA8C,CAAC;AACxF,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAC7D,eAAO,MAAM,4BAA4B,yBAAyB,CAAC;AAEnE,eAAO,MAAM,qBAAqB,GAChC,SAAS,UAAU,EACnB,iBAAiB,MAAM,GAAG,MAAM,GAAG,SAAS,KAC3C,IAaF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,SAAS,UAAU,EACnB,cAAc,OAAO,GAAG,SAAS,KAChC,IAWF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,SAAS,UAAU,EAAE,cAAc,MAAM,KAAG,IA8BjF,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,SAAS,UAAU,EACnB,cAAc,OAAO,GAAG,SAAS,KAChC,IAWF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,UAAU,KAAG,IAUvD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,UAAU,KAAG,IAU1D,CAAC;AAUF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,UAAU,EAAE,YAAY,MAAM,EAAE,UAAU,MAAM,KAAG,IAK1F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,UAAU,EACnB,WAAW,MAAM,EACjB,UAAU,MAAM,GAAG,MAAM,EAAE,EAC3B,mBAAmB,gBAAgB,KAClC,IA+BF,CAAC;AAWF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,EACb,QAAQ,MAAM,GAAG,SAAS,GAAG,SAAS,KACrC,IAwBF,CAAC"}
+{"version":3,"file":"request-validations.d.ts","sourceRoot":"","sources":["../src/request-validations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGpF,eAAO,MAAM,4BAA4B,8CAA8C,CAAC;AACxF,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAC7D,eAAO,MAAM,4BAA4B,yBAAyB,CAAC;AAEnE,eAAO,MAAM,qBAAqB,GAChC,SAAS,UAAU,EACnB,iBAAiB,MAAM,GAAG,MAAM,GAAG,SAAS,KAC3C,IAaF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,SAAS,UAAU,EACnB,cAAc,OAAO,GAAG,SAAS,KAChC,IAgBF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,SAAS,UAAU,EACnB,cAAc,MAAM,GAAG,QAAQ,EAC/B,SAAS,cAAc,KACtB,IA2CF,CAAC;AAkBF,eAAO,MAAM,6BAA6B,GACxC,SAAS,UAAU,EACnB,cAAc,OAAO,GAAG,SAAS,KAChC,IAgBF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,UAAU,KAAG,IAUvD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,UAAU,KAAG,IAU1D,CAAC;AAUF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,UAAU,EAAE,YAAY,MAAM,EAAE,UAAU,MAAM,KAAG,IAK1F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,UAAU,EACnB,WAAW,MAAM,EACjB,UAAU,MAAM,GAAG,MAAM,EAAE,EAC3B,mBAAmB,gBAAgB,KAClC,IA+BF,CAAC;AAWF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,EACb,QAAQ,MAAM,GAAG,SAAS,GAAG,SAAS,KACrC,IAwBF,CAAC"}