@mockmaster/core 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export { matchPath, parsePathParams } from './match';
+export { matchMethod, findMatchingMock } from './mock';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Core mocking engine
+// This will be the main entry point for the core package
+// Type definitions
+export * from './types';
+// Path matching utilities
+export { matchPath, parsePathParams } from './match';
+// Mock management utilities
+export { matchMethod, findMatchingMock } from './mock';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,yDAAyD;AAEzD,mBAAmB;AACnB,cAAc,SAAS,CAAA;AAEvB,0BAA0B;AAC1B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEpD,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA"}

package/dist/match.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Matches a path against a pattern
+ * @param pattern - The pattern to match against (e.g., '/users', '/users/:id', '/api/*')
+ * @param path - The actual request path
+ * @returns true if the path matches the pattern
+ */
+export declare const matchPath: (pattern: string, path: string) => boolean;
+/**
+ * Extracts path parameters from a path based on a pattern
+ * @param pattern - The pattern with :param placeholders
+ * @param path - The actual request path
+ * @returns Record of parameter names to values
+ */
+export declare const parsePathParams: (pattern: string, path: string) => Record<string, string>;
+//# sourceMappingURL=match.d.ts.map

package/dist/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"AAmCA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,KAAG,OAazD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAcpF,CAAA"}

package/dist/match.js

@@ -0,0 +1,63 @@
+// Pure functions for request matching
+/**
+ * Converts a path pattern to a regular expression
+ * @param pattern - The pattern with potential :params and wildcards
+ * @returns RegExp that matches the pattern
+ */
+const patternToRegex = (pattern) => {
+    // First, replace wildcards with a placeholder to protect them from escaping
+    const withWildcardPlaceholder = pattern.replace(/\*/g, '__WILDCARD__');
+    // Escape special regex characters except for :param
+    const escaped = withWildcardPlaceholder.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+    // Replace :param with named capture group that matches any non-slash characters
+    const withParams = escaped.replace(/:(\w+)/g, '(?<$1>[^/]+)');
+    // Replace wildcard placeholder
+    // Check if wildcard is at the end - if so, match everything
+    // Otherwise, match only non-slash characters (single path segment)
+    const withWildcards = withParams.replace(/__WILDCARD__/g, (match, offset, string) => {
+        // If wildcard is at the end, match everything including slashes
+        if (offset + match.length >= string.length || string[offset + match.length] === '$') {
+            return '.*';
+        }
+        // Otherwise, match only within a single path segment
+        return '[^/]+';
+    });
+    return new RegExp(`^${withWildcards}$`);
+};
+/**
+ * Matches a path against a pattern
+ * @param pattern - The pattern to match against (e.g., '/users', '/users/:id', '/api/*')
+ * @param path - The actual request path
+ * @returns true if the path matches the pattern
+ */
+export const matchPath = (pattern, path) => {
+    // Quick check for exact match (optimization)
+    if (pattern === path) {
+        return true;
+    }
+    // Check if pattern has parameters or wildcards
+    if (pattern.includes(':') || pattern.includes('*')) {
+        const regex = patternToRegex(pattern);
+        return regex.test(path);
+    }
+    return false;
+};
+/**
+ * Extracts path parameters from a path based on a pattern
+ * @param pattern - The pattern with :param placeholders
+ * @param path - The actual request path
+ * @returns Record of parameter names to values
+ */
+export const parsePathParams = (pattern, path) => {
+    // If no parameters in pattern, return empty object
+    if (!pattern.includes(':')) {
+        return {};
+    }
+    const regex = patternToRegex(pattern);
+    const match = path.match(regex);
+    if (!match || !match.groups) {
+        return {};
+    }
+    return match.groups;
+};
+//# sourceMappingURL=match.js.map

package/dist/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,OAAe,EAAU,EAAE;IACjD,4EAA4E;IAC5E,MAAM,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IAEtE,oDAAoD;IACpD,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAA;IAE7E,gFAAgF;IAChF,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;IAE7D,+BAA+B;IAC/B,4DAA4D;IAC5D,mEAAmE;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CACtC,eAAe,EACf,CAAC,KAAa,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;QAChD,gEAAgE;QAChE,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;YACpF,OAAO,IAAI,CAAA;QACb,CAAC;QACD,qDAAqD;QACrD,OAAO,OAAO,CAAA;IAChB,CAAC,CACF,CAAA;IAED,OAAO,IAAI,MAAM,CAAC,IAAI,aAAa,GAAG,CAAC,CAAA;AACzC,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,IAAY,EAAW,EAAE;IAClE,6CAA6C;IAC7C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,IAAY,EAA0B,EAAE;IACvF,mDAAmD;IACnD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAE/B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAA;AACrB,CAAC,CAAA"}

package/dist/mock.d.ts

@@ -0,0 +1,16 @@
+import type { Mock, MockRequest, HttpMethod } from './types';
+/**
+ * Matches an HTTP method (case-insensitive)
+ * @param expected - The expected HTTP method
+ * @param actual - The actual HTTP method from the request
+ * @returns true if methods match
+ */
+export declare const matchMethod: (expected: HttpMethod, actual: HttpMethod) => boolean;
+/**
+ * Finds the first mock that matches the given request
+ * @param mocks - Array of mocks to search through
+ * @param request - The request to match against
+ * @returns The first matching mock, or undefined if none match
+ */
+export declare const findMatchingMock: (mocks: Mock[], request: MockRequest) => Mock | undefined;
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,UAAU,EAAE,QAAQ,UAAU,KAAG,OAEtE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,IAAI,EAAE,EAAE,SAAS,WAAW,KAAG,IAAI,GAAG,SAY7E,CAAA"}

package/dist/mock.js

@@ -0,0 +1,30 @@
+// Pure functions for mock management
+import { matchPath } from './match';
+/**
+ * Matches an HTTP method (case-insensitive)
+ * @param expected - The expected HTTP method
+ * @param actual - The actual HTTP method from the request
+ * @returns true if methods match
+ */
+export const matchMethod = (expected, actual) => {
+    return expected.toUpperCase() === actual.toUpperCase();
+};
+/**
+ * Finds the first mock that matches the given request
+ * @param mocks - Array of mocks to search through
+ * @param request - The request to match against
+ * @returns The first matching mock, or undefined if none match
+ */
+export const findMatchingMock = (mocks, request) => {
+    return mocks.find((mock) => {
+        // Check if method matches
+        const methodMatches = matchMethod(mock.method, request.method);
+        if (!methodMatches) {
+            return false;
+        }
+        // Check if path matches
+        const pathMatches = matchPath(mock.pattern, request.path);
+        return pathMatches;
+    });
+};
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGnC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAoB,EAAE,MAAkB,EAAW,EAAE;IAC/E,OAAO,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAA;AACxD,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,OAAoB,EAAoB,EAAE;IACxF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,0BAA0B;QAC1B,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAC9D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,wBAAwB;QACxB,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QACzD,OAAO,WAAW,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+export interface MockRequest {
+    method: HttpMethod;
+    path: string;
+    query?: Record<string, string>;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export interface MockResponse {
+    status: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+    delay?: number;
+}
+export interface Mock {
+    id: string;
+    pattern: string;
+    method: HttpMethod;
+    response: MockResponse | ((request: MockRequest) => MockResponse);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAEzF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,YAAY,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,YAAY,CAAC,CAAA;CAClE"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Core types for mock-master
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6BAA6B"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mockmaster/core",
+  "version": "1.0.0",
+  "description": "Core mocking engine for mock-master",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mock",
+    "testing",
+    "api"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "fp-ts": "^2.16.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^1.2.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}