@craft-ts/core 0.7.0-beta.13

package/src/lib/mock-http-request-for-route.d.ts

@@ -0,0 +1,173 @@
+import type { CraftHttpRequest, ExtractCraftHttpClientExceptionBodyType, ExtractCraftHttpClientExceptionDependencies } from './craft-http-client';
+import type { AnyCraftException } from './craft-exception';
+import type { MergeObjectUnion, Simplify } from './craft-service.shared';
+type AnyTrackedCraftHttpRequest = CraftHttpRequest<string, string, unknown, unknown, unknown, AnyCraftException>;
+type HttpMockHeaders = Record<string, string | undefined>;
+type RouteMetaDataHttpDeps<RouteMetaData> = RouteMetaData extends {
+    httpDeps: infer HttpDeps extends object;
+} ? HttpDeps : {};
+type CraftRouteHttpDepsRegistryKey = Extract<keyof CraftRouteHttpDepsRegistry, string>;
+type RegisteredRouteHttpDeps<AppKey extends CraftRouteHttpDepsRegistryKey> = CraftRouteHttpDepsRegistry[AppKey] extends infer RouteHttpDeps extends object ? RouteHttpDeps : never;
+type RegisteredRoutePath<AppKey extends CraftRouteHttpDepsRegistryKey> = Extract<keyof RegisteredRouteHttpDeps<AppKey>, string>;
+type RegisteredRouteEndpointDeps<AppKey extends CraftRouteHttpDepsRegistryKey, RoutePath extends RegisteredRoutePath<AppKey>> = RegisteredRouteHttpDeps<AppKey>[RoutePath] extends infer EndpointDeps extends object ? EndpointDeps : never;
+type RegisteredRouteEndpointKey<AppKey extends CraftRouteHttpDepsRegistryKey, RoutePath extends RegisteredRoutePath<AppKey>> = Extract<keyof RegisteredRouteEndpointDeps<AppKey, RoutePath>, string>;
+type RegisteredRouteHttpRequest<AppKey extends CraftRouteHttpDepsRegistryKey, RoutePath extends RegisteredRoutePath<AppKey>, Endpoint extends RegisteredRouteEndpointKey<AppKey, RoutePath>> = RegisteredRouteEndpointDeps<AppKey, RoutePath>[Endpoint] extends infer Request ? Request extends AnyTrackedCraftHttpRequest ? Request : never : never;
+type EndpointMethod<Endpoint extends string> = string extends Endpoint ? string : Endpoint extends `${infer Method} ${string}` ? Method : never;
+type EndpointUrl<Endpoint extends string> = string extends Endpoint ? string : Endpoint extends `${string} ${infer Url}` ? Url : never;
+type ExceptionDependencies<Exception extends AnyCraftException> = ExtractCraftHttpClientExceptionDependencies<Exception>;
+type StatusDependency<Exception extends AnyCraftException> = Extract<ExceptionDependencies<Exception>, {
+    source: 'status';
+}>;
+type CodeDependency<Exception extends AnyCraftException> = Extract<ExceptionDependencies<Exception>, {
+    source: 'code';
+}>;
+type ContentDependency<Exception extends AnyCraftException> = Extract<ExceptionDependencies<Exception>, {
+    source: 'content';
+}>;
+type HeaderDependency<Exception extends AnyCraftException> = Extract<ExceptionDependencies<Exception>, {
+    source: 'header';
+}>;
+type MatchedStatusValue<Exception extends AnyCraftException> = Extract<StatusDependency<Exception>, {
+    mode: 'match';
+}> extends infer Dependency ? Dependency extends {
+    expected: infer Expected extends number;
+} ? Expected : never : never;
+type MatchedCodeValue<Exception extends AnyCraftException> = Extract<CodeDependency<Exception>, {
+    mode: 'match';
+}> extends infer Dependency ? Dependency extends {
+    expected: infer Expected;
+} ? Expected : never : never;
+type MatchedContentValue<Exception extends AnyCraftException> = Extract<ContentDependency<Exception>, {
+    mode: 'match';
+}> extends infer Dependency ? Dependency extends {
+    expected: infer Expected extends string;
+} ? Expected : never : never;
+type ExceptionStatusValue<Exception extends AnyCraftException> = [
+    MatchedStatusValue<Exception>
+] extends [never] ? number : MatchedStatusValue<Exception>;
+type ExceptionCodeBody<Exception extends AnyCraftException> = [
+    CodeDependency<Exception>
+] extends [never] ? {} : {
+    code: [MatchedCodeValue<Exception>] extends [never] ? unknown : MatchedCodeValue<Exception>;
+};
+type ExceptionContentBody<Exception extends AnyCraftException> = [
+    ContentDependency<Exception>
+] extends [never] ? {} : {
+    message: [MatchedContentValue<Exception>] extends [never] ? string | undefined : MatchedContentValue<Exception>;
+};
+type ExceptionBaseBody<Exception extends AnyCraftException> = [
+    ExtractCraftHttpClientExceptionBodyType<Exception>
+] extends [never] ? Record<string, unknown> : ExtractCraftHttpClientExceptionBodyType<Exception>;
+type HeaderMapFromDependency<Dependency> = Dependency extends {
+    name: infer HeaderName extends string;
+} ? {
+    [Key in HeaderName]: Dependency extends {
+        mode: 'match';
+        expected: infer Expected extends string;
+    } ? Expected : string | undefined;
+} : never;
+type ExceptionHeaderRequirements<Exception extends AnyCraftException> = MergeObjectUnion<HeaderMapFromDependency<HeaderDependency<Exception>>>;
+type ExceptionHeadersField<Exception extends AnyCraftException> = [
+    HeaderDependency<Exception>
+] extends [never] ? {
+    headers?: HttpMockHeaders;
+} : {
+    headers: Simplify<HttpMockHeaders & ExceptionHeaderRequirements<Exception>>;
+};
+export interface CraftRouteHttpDepsRegistry {
+}
+export type RouteHttpDepsByPath<Routes extends readonly unknown[]> = Simplify<MergeObjectUnion<Routes[number] extends infer RouteMetaData ? RouteMetaData extends {
+    path: infer Path extends string;
+} ? {
+    [Key in Path]: RouteMetaDataHttpDeps<RouteMetaData>;
+} : never : never>>;
+export type ExtractCraftHttpRequestSuccess<Request> = Request extends CraftHttpRequest<any, any, infer Success, any, any, any> ? Success : never;
+export type ExtractCraftHttpRequestCustomException<Request> = Request extends CraftHttpRequest<any, any, any, any, any, infer Exception> ? Extract<Exception, AnyCraftException> : never;
+export type MockHttpRequestSuccessResponse<Request extends AnyTrackedCraftHttpRequest> = {
+    kind: 'success';
+    body: ExtractCraftHttpRequestSuccess<Request>;
+    status?: number;
+    headers?: HttpMockHeaders;
+};
+export type MockHttpRequestErrorResponse = {
+    kind: 'error';
+    status: number;
+    body?: unknown;
+    headers?: HttpMockHeaders;
+};
+export type MockHttpRequestCustomExceptionResponse<Exception extends AnyCraftException> = {
+    kind: 'exception';
+    _tag: Exception['_tag'];
+    status: ExceptionStatusValue<Exception>;
+    body: ExceptionBaseBody<Exception> & ExceptionCodeBody<Exception> & ExceptionContentBody<Exception>;
+} & ExceptionHeadersField<Exception>;
+export type MockHttpRequestResponse<Request extends AnyTrackedCraftHttpRequest> = ExtractCraftHttpRequestSuccess<Request> | MockHttpRequestSuccessResponse<Request> | MockHttpRequestErrorResponse | (ExtractCraftHttpRequestCustomException<Request> extends infer Exception ? Exception extends AnyCraftException ? MockHttpRequestCustomExceptionResponse<Exception> : never : never);
+export type MockHttpRequestForRouteMockInput<Request extends AnyTrackedCraftHttpRequest> = {
+    kind: 'mock';
+    response: MockHttpRequestResponse<Request>;
+};
+export type MockHttpRequestForRouteEndpointInput<Request extends AnyTrackedCraftHttpRequest> = 'ignore' | 'unusedOrThrow' | MockHttpRequestForRouteMockInput<Request>;
+export type MockHttpRequestForRouteInput<AppKey extends CraftRouteHttpDepsRegistryKey, RoutePath extends RegisteredRoutePath<AppKey>> = {
+    [Endpoint in RegisteredRouteEndpointKey<AppKey, RoutePath>]: MockHttpRequestForRouteEndpointInput<RegisteredRouteHttpRequest<AppKey, RoutePath, Endpoint>>;
+};
+export type MockHttpRequestNormalizedResponse<Request extends AnyTrackedCraftHttpRequest> = MockHttpRequestSuccessResponse<Request> | MockHttpRequestErrorResponse | (ExtractCraftHttpRequestCustomException<Request> extends infer Exception ? Exception extends AnyCraftException ? MockHttpRequestCustomExceptionResponse<Exception> : never : never);
+export type MockHttpRequestForRouteIgnoreEndpoint<Endpoint extends string = string> = {
+    endpoint: Endpoint;
+    method: EndpointMethod<Endpoint>;
+    url: EndpointUrl<Endpoint>;
+    mode: 'ignore';
+};
+export type MockHttpRequestForRouteUnusedEndpoint<Endpoint extends string = string> = {
+    endpoint: Endpoint;
+    method: EndpointMethod<Endpoint>;
+    url: EndpointUrl<Endpoint>;
+    mode: 'unusedOrThrow';
+    message: string;
+};
+export type MockHttpRequestForRouteMockEndpoint<Endpoint extends string = string, Response = MockHttpRequestNormalizedResponse<AnyTrackedCraftHttpRequest>> = {
+    endpoint: Endpoint;
+    method: EndpointMethod<Endpoint>;
+    url: EndpointUrl<Endpoint>;
+    mode: 'mock';
+    response: Response;
+};
+export type MockHttpRequestForRouteEndpoint<Endpoint extends string = string, Response = MockHttpRequestNormalizedResponse<AnyTrackedCraftHttpRequest>> = MockHttpRequestForRouteIgnoreEndpoint<Endpoint> | MockHttpRequestForRouteUnusedEndpoint<Endpoint> | MockHttpRequestForRouteMockEndpoint<Endpoint, Response>;
+type MockHttpRequestForRouteNormalizedEndpoint<Endpoint extends string, Request extends AnyTrackedCraftHttpRequest, Input extends MockHttpRequestForRouteEndpointInput<Request>> = Input extends 'ignore' ? MockHttpRequestForRouteIgnoreEndpoint<Endpoint> : Input extends 'unusedOrThrow' ? MockHttpRequestForRouteUnusedEndpoint<Endpoint> : Input extends MockHttpRequestForRouteMockInput<Request> ? MockHttpRequestForRouteMockEndpoint<Endpoint, MockHttpRequestNormalizedResponse<Request>> : never;
+type RejectExtraKeys<Value extends object, AllowedKeys extends PropertyKey> = Exclude<keyof Value, AllowedKeys> extends never ? Value : never;
+export type MockHttpRequestForRouteResult<AppKey extends CraftRouteHttpDepsRegistryKey, RoutePath extends RegisteredRoutePath<AppKey>, Mocks extends MockHttpRequestForRouteInput<AppKey, RoutePath>> = {
+    app: AppKey;
+    route: RoutePath;
+    endpoints: Array<{
+        [Endpoint in RegisteredRouteEndpointKey<AppKey, RoutePath>]: MockHttpRequestForRouteNormalizedEndpoint<Endpoint, RegisteredRouteHttpRequest<AppKey, RoutePath, Endpoint>, Mocks[Endpoint]>;
+    }[RegisteredRouteEndpointKey<AppKey, RoutePath>]>;
+};
+export type MatchMockHttpRequestForRouteRequest = {
+    method: string;
+    url: string;
+};
+export type MatchMockHttpRequestForRouteOptions = {
+    ignoreUnregisteredRequests?: boolean;
+};
+export type MatchMockHttpRequestForRouteDecision<Response = never> = {
+    kind: 'ignore';
+} | {
+    kind: 'unusedOrThrow';
+    message: string;
+} | {
+    kind: 'mock';
+    response: Response;
+};
+export type MatchMockHttpRequestForRouteSource<Response = unknown> = {
+    app: string;
+    route: string;
+    endpoints: ReadonlyArray<MockHttpRequestForRouteEndpoint<string, Response>>;
+};
+type MatchMockHttpRequestForRouteResponse<RouteMock> = RouteMock extends MatchMockHttpRequestForRouteSource<infer Response> ? Response : never;
+export declare function mockHttpRequestForRoute<const AppKey extends CraftRouteHttpDepsRegistryKey, const RoutePath extends RegisteredRoutePath<AppKey>, const Mocks extends MockHttpRequestForRouteInput<AppKey, RoutePath>>(app: AppKey, route: RoutePath, mocks: RejectExtraKeys<Mocks, RegisteredRouteEndpointKey<AppKey, RoutePath>>): MockHttpRequestForRouteResult<AppKey, RoutePath, Mocks>;
+/**
+ * Resolve a route-level HTTP mock decision from a request shape that can come
+ * from Playwright (`page.route`) or any other test runtime.
+ */
+export declare function matchMockHttpRequestForRoute<const RouteMock extends MatchMockHttpRequestForRouteSource>(mockedRoute: RouteMock, request: MatchMockHttpRequestForRouteRequest, options?: MatchMockHttpRequestForRouteOptions): MatchMockHttpRequestForRouteDecision<MatchMockHttpRequestForRouteResponse<RouteMock>>;
+export {};
+//# sourceMappingURL=mock-http-request-for-route.d.ts.map

package/src/lib/mock-http-request-for-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-http-request-for-route.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/mock-http-request-for-route.ts"],"names":[],"mappings":"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"}

package/src/lib/mock-http-request-for-route.js

@@ -0,0 +1,127 @@
+export function mockHttpRequestForRoute(app, route, mocks) {
+    const endpoints = Object.entries(mocks).map(([endpoint, input]) => normalizeMockHttpRequestForRouteEndpoint(app, route, endpoint, input));
+    return {
+        app,
+        route,
+        endpoints,
+    };
+}
+/**
+ * Resolve a route-level HTTP mock decision from a request shape that can come
+ * from Playwright (`page.route`) or any other test runtime.
+ */
+export function matchMockHttpRequestForRoute(mockedRoute, request, options = {}) {
+    const normalizedRequest = normalizeMatchedRouteHttpRequest(request);
+    const matchedEndpoint = mockedRoute.endpoints.find((endpoint) => isMatchedRouteHttpRequestEndpoint(endpoint, normalizedRequest));
+    if (!matchedEndpoint) {
+        return options.ignoreUnregisteredRequests
+            ? {
+                kind: 'ignore',
+            }
+            : {
+                kind: 'unusedOrThrow',
+                message: createUnregisteredRouteHttpRequestMessage(mockedRoute, request, normalizedRequest.method),
+            };
+    }
+    switch (matchedEndpoint.mode) {
+        case 'ignore':
+            return {
+                kind: 'ignore',
+            };
+        case 'unusedOrThrow':
+            return {
+                kind: 'unusedOrThrow',
+                message: createMatchedUnusedRouteHttpRequestMessage(mockedRoute, matchedEndpoint, request, normalizedRequest.method),
+            };
+        case 'mock':
+            return {
+                kind: 'mock',
+                response: matchedEndpoint.response,
+            };
+    }
+}
+function parseEndpointKey(endpoint) {
+    const separatorIndex = endpoint.indexOf(' ');
+    if (separatorIndex <= 0 || separatorIndex === endpoint.length - 1) {
+        throw new Error(`Invalid route httpDeps endpoint key "${endpoint}". Expected "METHOD URL".`);
+    }
+    return {
+        method: endpoint.slice(0, separatorIndex),
+        url: endpoint.slice(separatorIndex + 1),
+    };
+}
+function normalizeMockHttpRequestForRouteEndpoint(app, route, endpoint, input) {
+    const { method, url } = parseEndpointKey(endpoint);
+    if (input === 'ignore') {
+        return {
+            endpoint,
+            method: method,
+            url: url,
+            mode: 'ignore',
+        };
+    }
+    if (input === 'unusedOrThrow') {
+        return {
+            endpoint,
+            method: method,
+            url: url,
+            mode: 'unusedOrThrow',
+            message: createUnusedRouteHttpEndpointMessage(app, route, endpoint),
+        };
+    }
+    return {
+        endpoint,
+        method: method,
+        url: url,
+        mode: 'mock',
+        response: normalizeMockHttpRequestResponse(input.response),
+    };
+}
+function normalizeMockHttpRequestResponse(response) {
+    if (isExplicitMockHttpRequestResponse(response)) {
+        return response;
+    }
+    return {
+        kind: 'success',
+        body: response,
+    };
+}
+function normalizeMatchedRouteHttpRequest(request) {
+    const normalizedUrl = normalizeComparableRouteHttpUrl(request.url);
+    return {
+        method: request.method.toUpperCase(),
+        pathname: normalizedUrl.pathname,
+        pathnameWithSearch: `${normalizedUrl.pathname}${normalizedUrl.search}`,
+    };
+}
+function isMatchedRouteHttpRequestEndpoint(endpoint, request) {
+    if (endpoint.method.toUpperCase() !== request.method) {
+        return false;
+    }
+    const normalizedEndpointUrl = normalizeComparableRouteHttpUrl(endpoint.url);
+    const endpointPathname = normalizedEndpointUrl.pathname;
+    const endpointPathnameWithSearch = `${endpointPathname}${normalizedEndpointUrl.search}`;
+    return normalizedEndpointUrl.search
+        ? request.pathnameWithSearch === endpointPathnameWithSearch
+        : request.pathname === endpointPathname;
+}
+function normalizeComparableRouteHttpUrl(url) {
+    return new URL(url, 'http://craft-ts.local');
+}
+function createUnusedRouteHttpEndpointMessage(app, route, endpoint) {
+    return `Route HTTP endpoint "${endpoint}" for app "${app}" route "${route}" is marked as unusedOrThrow.`;
+}
+function createMatchedUnusedRouteHttpRequestMessage(mockedRoute, endpoint, request, method) {
+    return `Route HTTP request "${method} ${request.url}" matched endpoint "${endpoint.endpoint}" for app "${mockedRoute.app}" route "${mockedRoute.route}", but that endpoint is marked as unusedOrThrow.`;
+}
+function createUnregisteredRouteHttpRequestMessage(mockedRoute, request, method) {
+    return `Received unregistered route HTTP request "${method} ${request.url}" for app "${mockedRoute.app}" route "${mockedRoute.route}".`;
+}
+function isExplicitMockHttpRequestResponse(response) {
+    if (typeof response !== 'object' || response === null) {
+        return false;
+    }
+    const kind = Reflect.get(response, 'kind');
+    return (kind === 'success' || kind === 'error' || kind === 'exception');
+}
+//# sourceMappingURL=mock-http-request-for-route.js.map

package/src/lib/mock-http-request-for-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-http-request-for-route.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/mock-http-request-for-route.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CraftHttpRequest,\n  ExtractCraftHttpClientExceptionBodyType,\n  ExtractCraftHttpClientExceptionDependencies,\n} from './craft-http-client';\nimport type { AnyCraftException } from './craft-exception';\nimport type { MergeObjectUnion, Simplify } from './craft-service.shared';\n\ntype AnyTrackedCraftHttpRequest = CraftHttpRequest<\n  string,\n  string,\n  unknown,\n  unknown,\n  unknown,\n  AnyCraftException\n>;\n\ntype HttpMockHeaders = Record<string, string | undefined>;\n\ntype RouteMetaDataHttpDeps<RouteMetaData> = RouteMetaData extends {\n  httpDeps: infer HttpDeps extends object;\n}\n  ? HttpDeps\n  : {};\n\ntype CraftRouteHttpDepsRegistryKey = Extract<\n  keyof CraftRouteHttpDepsRegistry,\n  string\n>;\n\ntype RegisteredRouteHttpDeps<AppKey extends CraftRouteHttpDepsRegistryKey> =\n  CraftRouteHttpDepsRegistry[AppKey] extends infer RouteHttpDeps extends object\n    ? RouteHttpDeps\n    : never;\n\ntype RegisteredRoutePath<AppKey extends CraftRouteHttpDepsRegistryKey> =\n  Extract<keyof RegisteredRouteHttpDeps<AppKey>, string>;\n\ntype RegisteredRouteEndpointDeps<\n  AppKey extends CraftRouteHttpDepsRegistryKey,\n  RoutePath extends RegisteredRoutePath<AppKey>,\n> = RegisteredRouteHttpDeps<AppKey>[RoutePath] extends infer EndpointDeps extends\n  object\n  ? EndpointDeps\n  : never;\n\ntype RegisteredRouteEndpointKey<\n  AppKey extends CraftRouteHttpDepsRegistryKey,\n  RoutePath extends RegisteredRoutePath<AppKey>,\n> = Extract<keyof RegisteredRouteEndpointDeps<AppKey, RoutePath>, string>;\n\ntype RegisteredRouteHttpRequest<\n  AppKey extends CraftRouteHttpDepsRegistryKey,\n  RoutePath extends RegisteredRoutePath<AppKey>,\n  Endpoint extends RegisteredRouteEndpointKey<AppKey, RoutePath>,\n> =\n  RegisteredRouteEndpointDeps<AppKey, RoutePath>[Endpoint] extends infer Request\n    ? Request extends AnyTrackedCraftHttpRequest\n      ? Request\n      : never\n    : never;\n\ntype EndpointMethod<Endpoint extends string> = string extends Endpoint\n  ? string\n  : Endpoint extends `${infer Method} ${string}`\n    ? Method\n    : never;\n\ntype EndpointUrl<Endpoint extends string> = string extends Endpoint\n  ? string\n  : Endpoint extends `${string} ${infer Url}`\n    ? Url\n    : never;\n\ntype ExceptionDependencies<Exception extends AnyCraftException> =\n  ExtractCraftHttpClientExceptionDependencies<Exception>;\n\ntype StatusDependency<Exception extends AnyCraftException> = Extract<\n  ExceptionDependencies<Exception>,\n  { source: 'status' }\n>;\n\ntype CodeDependency<Exception extends AnyCraftException> = Extract<\n  ExceptionDependencies<Exception>,\n  { source: 'code' }\n>;\n\ntype ContentDependency<Exception extends AnyCraftException> = Extract<\n  ExceptionDependencies<Exception>,\n  { source: 'content' }\n>;\n\ntype HeaderDependency<Exception extends AnyCraftException> = Extract<\n  ExceptionDependencies<Exception>,\n  { source: 'header' }\n>;\n\ntype MatchedStatusValue<Exception extends AnyCraftException> = Extract<\n  StatusDependency<Exception>,\n  { mode: 'match' }\n> extends infer Dependency\n  ? Dependency extends { expected: infer Expected extends number }\n    ? Expected\n    : never\n  : never;\n\ntype MatchedCodeValue<Exception extends AnyCraftException> = Extract<\n  CodeDependency<Exception>,\n  { mode: 'match' }\n> extends infer Dependency\n  ? Dependency extends { expected: infer Expected }\n    ? Expected\n    : never\n  : never;\n\ntype MatchedContentValue<Exception extends AnyCraftException> = Extract<\n  ContentDependency<Exception>,\n  { mode: 'match' }\n> extends infer Dependency\n  ? Dependency extends { expected: infer Expected extends string }\n    ? Expected\n    : never\n  : never;\n\ntype ExceptionStatusValue<Exception extends AnyCraftException> = [\n  MatchedStatusValue<Exception>,\n] extends [never]\n  ? number\n  : MatchedStatusValue<Exception>;\n\ntype ExceptionCodeBody<Exception extends AnyCraftException> = [\n  CodeDependency<Exception>,\n] extends [never]\n  ? {}\n  : {\n      code: [MatchedCodeValue<Exception>] extends [never]\n        ? unknown\n        : MatchedCodeValue<Exception>;\n    };\n\ntype ExceptionContentBody<Exception extends AnyCraftException> = [\n  ContentDependency<Exception>,\n] extends [never]\n  ? {}\n  : {\n      message: [MatchedContentValue<Exception>] extends [never]\n        ? string | undefined\n        : MatchedContentValue<Exception>;\n    };\n\ntype ExceptionBaseBody<Exception extends AnyCraftException> = [\n  ExtractCraftHttpClientExceptionBodyType<Exception>,\n] extends [never]\n  ? Record<string, unknown>\n  : ExtractCraftHttpClientExceptionBodyType<Exception>;\n\ntype HeaderMapFromDependency<Dependency> = Dependency extends {\n  name: infer HeaderName extends string;\n}\n  ? {\n      [Key in HeaderName]: Dependency extends {\n        mode: 'match';\n        expected: infer Expected extends string;\n      }\n        ? Expected\n        : string | undefined;\n    }\n  : never;\n\ntype ExceptionHeaderRequirements<Exception extends AnyCraftException> =\n  MergeObjectUnion<HeaderMapFromDependency<HeaderDependency<Exception>>>;\n\ntype ExceptionHeadersField<Exception extends AnyCraftException> = [\n  HeaderDependency<Exception>,\n] extends [never]\n  ? {\n      headers?: HttpMockHeaders;\n    }\n  : {\n      headers: Simplify<\n        HttpMockHeaders & ExceptionHeaderRequirements<Exception>\n      >;\n    };\n\nexport interface CraftRouteHttpDepsRegistry {}\n\nexport type RouteHttpDepsByPath<Routes extends readonly unknown[]> = Simplify<\n  MergeObjectUnion<\n    Routes[number] extends infer RouteMetaData\n      ? RouteMetaData extends {\n          path: infer Path extends string;\n        }\n        ? {\n            [Key in Path]: RouteMetaDataHttpDeps<RouteMetaData>;\n          }\n        : never\n      : never\n  >\n>;\n\nexport type ExtractCraftHttpRequestSuccess<Request> =\n  Request extends CraftHttpRequest<any, any, infer Success, any, any, any>\n    ? Success\n    : never;\n\nexport type ExtractCraftHttpRequestCustomException<Request> =\n  Request extends CraftHttpRequest<any, any, any, any, any, infer Exception>\n    ? Extract<Exception, AnyCraftException>\n    : never;\n\nexport type MockHttpRequestSuccessResponse<Request extends AnyTrackedCraftHttpRequest> =\n  {\n    kind: 'success';\n    body: ExtractCraftHttpRequestSuccess<Request>;\n    status?: number;\n    headers?: HttpMockHeaders;\n  };\n\nexport type MockHttpRequestErrorResponse = {\n  kind: 'error';\n  status: number;\n  body?: unknown;\n  headers?: HttpMockHeaders;\n};\n\nexport type MockHttpRequestCustomExceptionResponse<\n  Exception extends AnyCraftException,\n> = {\n  kind: 'exception';\n  // Mirrors the craft discriminant. NOT to be confused with the `code` inside\n  // `body`, which is the server's own error code (see ExceptionCodeBody).\n  _tag: Exception['_tag'];\n  status: ExceptionStatusValue<Exception>;\n  body: ExceptionBaseBody<Exception> &\n    ExceptionCodeBody<Exception> &\n    ExceptionContentBody<Exception>;\n} & ExceptionHeadersField<Exception>;\n\nexport type MockHttpRequestResponse<Request extends AnyTrackedCraftHttpRequest> =\n  | ExtractCraftHttpRequestSuccess<Request>\n  | MockHttpRequestSuccessResponse<Request>\n  | MockHttpRequestErrorResponse\n  | (ExtractCraftHttpRequestCustomException<Request> extends infer Exception\n      ? Exception extends AnyCraftException\n        ? MockHttpRequestCustomExceptionResponse<Exception>\n        : never\n      : never);\n\nexport type MockHttpRequestForRouteMockInput<\n  Request extends AnyTrackedCraftHttpRequest,\n> = {\n  kind: 'mock';\n  response: MockHttpRequestResponse<Request>;\n};\n\nexport type MockHttpRequestForRouteEndpointInput<\n  Request extends AnyTrackedCraftHttpRequest,\n> =\n  | 'ignore'\n  | 'unusedOrThrow'\n  | MockHttpRequestForRouteMockInput<Request>;\n\nexport type MockHttpRequestForRouteInput<\n  AppKey extends CraftRouteHttpDepsRegistryKey,\n  RoutePath extends RegisteredRoutePath<AppKey>,\n> = {\n  [Endpoint in RegisteredRouteEndpointKey<\n    AppKey,\n    RoutePath\n  >]: MockHttpRequestForRouteEndpointInput<\n    RegisteredRouteHttpRequest<AppKey, RoutePath, Endpoint>\n  >;\n};\n\nexport type MockHttpRequestNormalizedResponse<\n  Request extends AnyTrackedCraftHttpRequest,\n> =\n  | MockHttpRequestSuccessResponse<Request>\n  | MockHttpRequestErrorResponse\n  | (ExtractCraftHttpRequestCustomException<Request> extends infer Exception\n      ? Exception extends AnyCraftException\n        ? MockHttpRequestCustomExceptionResponse<Exception>\n        : never\n      : never);\n\nexport type MockHttpRequestForRouteIgnoreEndpoint<\n  Endpoint extends string = string,\n> = {\n  endpoint: Endpoint;\n  method: EndpointMethod<Endpoint>;\n  url: EndpointUrl<Endpoint>;\n  mode: 'ignore';\n};\n\nexport type MockHttpRequestForRouteUnusedEndpoint<\n  Endpoint extends string = string,\n> = {\n  endpoint: Endpoint;\n  method: EndpointMethod<Endpoint>;\n  url: EndpointUrl<Endpoint>;\n  mode: 'unusedOrThrow';\n  message: string;\n};\n\nexport type MockHttpRequestForRouteMockEndpoint<\n  Endpoint extends string = string,\n  Response = MockHttpRequestNormalizedResponse<AnyTrackedCraftHttpRequest>,\n> = {\n  endpoint: Endpoint;\n  method: EndpointMethod<Endpoint>;\n  url: EndpointUrl<Endpoint>;\n  mode: 'mock';\n  response: Response;\n};\n\nexport type MockHttpRequestForRouteEndpoint<\n  Endpoint extends string = string,\n  Response = MockHttpRequestNormalizedResponse<AnyTrackedCraftHttpRequest>,\n> =\n  | MockHttpRequestForRouteIgnoreEndpoint<Endpoint>\n  | MockHttpRequestForRouteUnusedEndpoint<Endpoint>\n  | MockHttpRequestForRouteMockEndpoint<Endpoint, Response>;\n\ntype MockHttpRequestForRouteNormalizedEndpoint<\n  Endpoint extends string,\n  Request extends AnyTrackedCraftHttpRequest,\n  Input extends MockHttpRequestForRouteEndpointInput<Request>,\n> = Input extends 'ignore'\n  ? MockHttpRequestForRouteIgnoreEndpoint<Endpoint>\n  : Input extends 'unusedOrThrow'\n    ? MockHttpRequestForRouteUnusedEndpoint<Endpoint>\n    : Input extends MockHttpRequestForRouteMockInput<Request>\n      ? MockHttpRequestForRouteMockEndpoint<\n          Endpoint,\n          MockHttpRequestNormalizedResponse<Request>\n        >\n      : never;\n\ntype RejectExtraKeys<\n  Value extends object,\n  AllowedKeys extends PropertyKey,\n> = Exclude<keyof Value, AllowedKeys> extends never ? Value : never;\n\nexport type MockHttpRequestForRouteResult<\n  AppKey extends CraftRouteHttpDepsRegistryKey,\n  RoutePath extends RegisteredRoutePath<AppKey>,\n  Mocks extends MockHttpRequestForRouteInput<AppKey, RoutePath>,\n> = {\n  app: AppKey;\n  route: RoutePath;\n  endpoints: Array<\n    {\n      [Endpoint in RegisteredRouteEndpointKey<\n        AppKey,\n        RoutePath\n      >]: MockHttpRequestForRouteNormalizedEndpoint<\n        Endpoint,\n        RegisteredRouteHttpRequest<AppKey, RoutePath, Endpoint>,\n        Mocks[Endpoint]\n      >;\n    }[RegisteredRouteEndpointKey<AppKey, RoutePath>]\n  >;\n};\n\nexport type MatchMockHttpRequestForRouteRequest = {\n  method: string;\n  url: string;\n};\n\nexport type MatchMockHttpRequestForRouteOptions = {\n  ignoreUnregisteredRequests?: boolean;\n};\n\nexport type MatchMockHttpRequestForRouteDecision<Response = never> =\n  | {\n      kind: 'ignore';\n    }\n  | {\n      kind: 'unusedOrThrow';\n      message: string;\n    }\n  | {\n      kind: 'mock';\n      response: Response;\n    };\n\nexport type MatchMockHttpRequestForRouteSource<Response = unknown> = {\n  app: string;\n  route: string;\n  endpoints: ReadonlyArray<MockHttpRequestForRouteEndpoint<string, Response>>;\n};\n\ntype MatchMockHttpRequestForRouteResponse<RouteMock> =\n  RouteMock extends MatchMockHttpRequestForRouteSource<infer Response>\n    ? Response\n    : never;\n\nexport function mockHttpRequestForRoute<\n  const AppKey extends CraftRouteHttpDepsRegistryKey,\n  const RoutePath extends RegisteredRoutePath<AppKey>,\n  const Mocks extends MockHttpRequestForRouteInput<AppKey, RoutePath>,\n>(\n  app: AppKey,\n  route: RoutePath,\n  mocks: RejectExtraKeys<\n    Mocks,\n    RegisteredRouteEndpointKey<AppKey, RoutePath>\n  >,\n): MockHttpRequestForRouteResult<AppKey, RoutePath, Mocks> {\n  const endpoints = (\n    Object.entries(mocks) as Array<\n      [\n        RegisteredRouteEndpointKey<AppKey, RoutePath>,\n        Mocks[RegisteredRouteEndpointKey<AppKey, RoutePath>],\n      ]\n    >\n  ).map(([endpoint, input]) =>\n    normalizeMockHttpRequestForRouteEndpoint(app, route, endpoint, input),\n  );\n\n  return {\n    app,\n    route,\n    endpoints,\n  } as unknown as MockHttpRequestForRouteResult<AppKey, RoutePath, Mocks>;\n}\n\n/**\n * Resolve a route-level HTTP mock decision from a request shape that can come\n * from Playwright (`page.route`) or any other test runtime.\n */\nexport function matchMockHttpRequestForRoute<\n  const RouteMock extends MatchMockHttpRequestForRouteSource,\n>(\n  mockedRoute: RouteMock,\n  request: MatchMockHttpRequestForRouteRequest,\n  options: MatchMockHttpRequestForRouteOptions = {},\n): MatchMockHttpRequestForRouteDecision<\n  MatchMockHttpRequestForRouteResponse<RouteMock>\n> {\n  const normalizedRequest = normalizeMatchedRouteHttpRequest(request);\n\n  const matchedEndpoint = mockedRoute.endpoints.find((endpoint) =>\n    isMatchedRouteHttpRequestEndpoint(endpoint, normalizedRequest),\n  );\n\n  if (!matchedEndpoint) {\n    return options.ignoreUnregisteredRequests\n      ? {\n          kind: 'ignore',\n        }\n      : {\n          kind: 'unusedOrThrow',\n          message: createUnregisteredRouteHttpRequestMessage(\n            mockedRoute,\n            request,\n            normalizedRequest.method,\n          ),\n        };\n  }\n\n  switch (matchedEndpoint.mode) {\n    case 'ignore':\n      return {\n        kind: 'ignore',\n      };\n    case 'unusedOrThrow':\n      return {\n        kind: 'unusedOrThrow',\n        message: createMatchedUnusedRouteHttpRequestMessage(\n          mockedRoute,\n          matchedEndpoint,\n          request,\n          normalizedRequest.method,\n        ),\n      };\n    case 'mock':\n      return {\n        kind: 'mock',\n        response:\n          matchedEndpoint.response as MatchMockHttpRequestForRouteResponse<RouteMock>,\n      };\n  }\n}\n\nfunction parseEndpointKey(endpoint: string): { method: string; url: string } {\n  const separatorIndex = endpoint.indexOf(' ');\n\n  if (separatorIndex <= 0 || separatorIndex === endpoint.length - 1) {\n    throw new Error(\n      `Invalid route httpDeps endpoint key \"${endpoint}\". Expected \"METHOD URL\".`,\n    );\n  }\n\n  return {\n    method: endpoint.slice(0, separatorIndex),\n    url: endpoint.slice(separatorIndex + 1),\n  };\n}\n\nfunction normalizeMockHttpRequestForRouteEndpoint<\n  AppKey extends string,\n  RoutePath extends string,\n  Endpoint extends string,\n  Request extends AnyTrackedCraftHttpRequest,\n  Input extends MockHttpRequestForRouteEndpointInput<Request>,\n>(\n  app: AppKey,\n  route: RoutePath,\n  endpoint: Endpoint,\n  input: Input,\n): MockHttpRequestForRouteNormalizedEndpoint<Endpoint, Request, Input> {\n  const { method, url } = parseEndpointKey(endpoint);\n\n  if (input === 'ignore') {\n    return {\n      endpoint,\n      method: method as EndpointMethod<Endpoint>,\n      url: url as EndpointUrl<Endpoint>,\n      mode: 'ignore',\n    } as MockHttpRequestForRouteNormalizedEndpoint<Endpoint, Request, Input>;\n  }\n\n  if (input === 'unusedOrThrow') {\n    return {\n      endpoint,\n      method: method as EndpointMethod<Endpoint>,\n      url: url as EndpointUrl<Endpoint>,\n      mode: 'unusedOrThrow',\n      message: createUnusedRouteHttpEndpointMessage(app, route, endpoint),\n    } as MockHttpRequestForRouteNormalizedEndpoint<Endpoint, Request, Input>;\n  }\n\n  return {\n    endpoint,\n    method: method as EndpointMethod<Endpoint>,\n    url: url as EndpointUrl<Endpoint>,\n    mode: 'mock',\n    response: normalizeMockHttpRequestResponse(input.response),\n  } as MockHttpRequestForRouteNormalizedEndpoint<Endpoint, Request, Input>;\n}\n\nfunction normalizeMockHttpRequestResponse(\n  response: unknown,\n):\n  | MockHttpRequestSuccessResponse<AnyTrackedCraftHttpRequest>\n  | MockHttpRequestErrorResponse\n  | MockHttpRequestCustomExceptionResponse<AnyCraftException> {\n  if (isExplicitMockHttpRequestResponse(response)) {\n    return response;\n  }\n\n  return {\n    kind: 'success',\n    body: response,\n  };\n}\n\nfunction normalizeMatchedRouteHttpRequest(\n  request: MatchMockHttpRequestForRouteRequest,\n): {\n  method: string;\n  pathname: string;\n  pathnameWithSearch: string;\n} {\n  const normalizedUrl = normalizeComparableRouteHttpUrl(request.url);\n\n  return {\n    method: request.method.toUpperCase(),\n    pathname: normalizedUrl.pathname,\n    pathnameWithSearch: `${normalizedUrl.pathname}${normalizedUrl.search}`,\n  };\n}\n\nfunction isMatchedRouteHttpRequestEndpoint(\n  endpoint: MockHttpRequestForRouteEndpoint<string, unknown>,\n  request: {\n    method: string;\n    pathname: string;\n    pathnameWithSearch: string;\n  },\n): boolean {\n  if (endpoint.method.toUpperCase() !== request.method) {\n    return false;\n  }\n\n  const normalizedEndpointUrl = normalizeComparableRouteHttpUrl(endpoint.url);\n  const endpointPathname = normalizedEndpointUrl.pathname;\n  const endpointPathnameWithSearch = `${endpointPathname}${normalizedEndpointUrl.search}`;\n\n  return normalizedEndpointUrl.search\n    ? request.pathnameWithSearch === endpointPathnameWithSearch\n    : request.pathname === endpointPathname;\n}\n\nfunction normalizeComparableRouteHttpUrl(url: string): URL {\n  return new URL(url, 'http://craft-ts.local');\n}\n\nfunction createUnusedRouteHttpEndpointMessage(\n  app: string,\n  route: string,\n  endpoint: string,\n): string {\n  return `Route HTTP endpoint \"${endpoint}\" for app \"${app}\" route \"${route}\" is marked as unusedOrThrow.`;\n}\n\nfunction createMatchedUnusedRouteHttpRequestMessage(\n  mockedRoute: Pick<MatchMockHttpRequestForRouteSource, 'app' | 'route'>,\n  endpoint: Pick<MockHttpRequestForRouteUnusedEndpoint<string>, 'endpoint'>,\n  request: MatchMockHttpRequestForRouteRequest,\n  method: string,\n): string {\n  return `Route HTTP request \"${method} ${request.url}\" matched endpoint \"${endpoint.endpoint}\" for app \"${mockedRoute.app}\" route \"${mockedRoute.route}\", but that endpoint is marked as unusedOrThrow.`;\n}\n\nfunction createUnregisteredRouteHttpRequestMessage(\n  mockedRoute: Pick<MatchMockHttpRequestForRouteSource, 'app' | 'route'>,\n  request: MatchMockHttpRequestForRouteRequest,\n  method: string,\n): string {\n  return `Received unregistered route HTTP request \"${method} ${request.url}\" for app \"${mockedRoute.app}\" route \"${mockedRoute.route}\".`;\n}\n\nfunction isExplicitMockHttpRequestResponse(\n  response: unknown,\n): response is\n  | MockHttpRequestSuccessResponse<AnyTrackedCraftHttpRequest>\n  | MockHttpRequestErrorResponse\n  | MockHttpRequestCustomExceptionResponse<AnyCraftException> {\n  if (typeof response !== 'object' || response === null) {\n    return false;\n  }\n\n  const kind = Reflect.get(response, 'kind');\n\n  return (\n    kind === 'success' || kind === 'error' || kind === 'exception'\n  );\n}\n"]}