@ankhorage/data-sources 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/data-sources
 
+## 0.5.0
+
+### Minor Changes
+
+- 5a52064: Add a headless endpoint test runner with dry-run request building, injected fetch execution, credential resolution, response parsing, and structured diagnostics.
+
+## 0.4.0
+
+### Minor Changes
+
+- bc25acb: Add a headless endpoint test runner with dry-run request building, injected fetch execution, credential resolution, response parsing, and structured diagnostics.
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/data-sources
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.2.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.3.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Provider-neutral data source and endpoint system for APIs, databases, and runtime bindings.
 
@@ -43,6 +43,8 @@ graph TD
   package__ankhorage_data_sources -.-> module_src_openapi_index_ts
   module_src_rest_index_ts["src/rest/index.ts"]
   package__ankhorage_data_sources -.-> module_src_rest_index_ts
+  module_src_test_runner_index_ts["src/test-runner/index.ts"]
+  package__ankhorage_data_sources -.-> module_src_test_runner_index_ts
 ```
 
 </details>

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './graphql';
 export * from './managed-api';
 export * from './openapi';
 export * from './rest';
+export * from './test-runner';
 export declare const DATA_SOURCES_PACKAGE_NAME: "@ankhorage/data-sources";
 export declare const SUPPORTED_DATA_SOURCE_KINDS: readonly ["database", "graphql", "managed-api", "openapi", "rest"];
 export interface DataSourcesPackageInfo {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElF,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AAEvB,eAAO,MAAM,yBAAyB,EAAG,yBAAkC,CAAC;AAE5E,eAAO,MAAM,2BAA2B,oEAMM,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,yBAAyB,CAAC;IACvD,QAAQ,CAAC,cAAc,EAAE,OAAO,2BAA2B,CAAC;CAC7D;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAKlE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAE1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElF,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAE9B,eAAO,MAAM,yBAAyB,EAAG,yBAAkC,CAAC;AAE5E,eAAO,MAAM,2BAA2B,oEAMM,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,yBAAyB,CAAC;IACvD,QAAQ,CAAC,cAAc,EAAE,OAAO,2BAA2B,CAAC;CAC7D;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAKlE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAE1E"}

package/dist/index.js

@@ -2,6 +2,7 @@ export * from './graphql';
 export * from './managed-api';
 export * from './openapi';
 export * from './rest';
+export * from './test-runner';
 export const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources';
 export const SUPPORTED_DATA_SOURCE_KINDS = [
     'database',

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AAEvB,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAkC,CAAC;AAE5E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,UAAU;IACV,SAAS;IACT,aAAa;IACb,SAAS;IACT,MAAM;CACsC,CAAC;AAO/C,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,WAAW,EAAE,yBAAyB;QACtC,cAAc,EAAE,2BAA2B;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC","sourcesContent":["import type { DataSourceConfig, DataSourceKind } from '@ankhorage/contracts/data';\n\nexport * from './graphql';\nexport * from './managed-api';\nexport * from './openapi';\nexport * from './rest';\n\nexport const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources' as const;\n\nexport const SUPPORTED_DATA_SOURCE_KINDS = [\n  'database',\n  'graphql',\n  'managed-api',\n  'openapi',\n  'rest',\n] as const satisfies readonly DataSourceKind[];\n\nexport interface DataSourcesPackageInfo {\n  readonly packageName: typeof DATA_SOURCES_PACKAGE_NAME;\n  readonly supportedKinds: typeof SUPPORTED_DATA_SOURCE_KINDS;\n}\n\nexport function getDataSourcesPackageInfo(): DataSourcesPackageInfo {\n  return {\n    packageName: DATA_SOURCES_PACKAGE_NAME,\n    supportedKinds: SUPPORTED_DATA_SOURCE_KINDS,\n  };\n}\n\nexport function isSupportedDataSourceKind(kind: string): kind is DataSourceKind {\n  return SUPPORTED_DATA_SOURCE_KINDS.some((supportedKind) => supportedKind === kind);\n}\n\nexport function getDataSourceKind(source: DataSourceConfig): DataSourceKind {\n  return source.kind;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAE9B,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAkC,CAAC;AAE5E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,UAAU;IACV,SAAS;IACT,aAAa;IACb,SAAS;IACT,MAAM;CACsC,CAAC;AAO/C,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,WAAW,EAAE,yBAAyB;QACtC,cAAc,EAAE,2BAA2B;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC","sourcesContent":["import type { DataSourceConfig, DataSourceKind } from '@ankhorage/contracts/data';\n\nexport * from './graphql';\nexport * from './managed-api';\nexport * from './openapi';\nexport * from './rest';\nexport * from './test-runner';\n\nexport const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources' as const;\n\nexport const SUPPORTED_DATA_SOURCE_KINDS = [\n  'database',\n  'graphql',\n  'managed-api',\n  'openapi',\n  'rest',\n] as const satisfies readonly DataSourceKind[];\n\nexport interface DataSourcesPackageInfo {\n  readonly packageName: typeof DATA_SOURCES_PACKAGE_NAME;\n  readonly supportedKinds: typeof SUPPORTED_DATA_SOURCE_KINDS;\n}\n\nexport function getDataSourcesPackageInfo(): DataSourcesPackageInfo {\n  return {\n    packageName: DATA_SOURCES_PACKAGE_NAME,\n    supportedKinds: SUPPORTED_DATA_SOURCE_KINDS,\n  };\n}\n\nexport function isSupportedDataSourceKind(kind: string): kind is DataSourceKind {\n  return SUPPORTED_DATA_SOURCE_KINDS.some((supportedKind) => supportedKind === kind);\n}\n\nexport function getDataSourceKind(source: DataSourceConfig): DataSourceKind {\n  return source.kind;\n}\n"]}

package/dist/test-runner/index.d.ts

@@ -0,0 +1,60 @@
+import type { CredentialRef, DataContractValue, DataSourceConfig, DataSourceDiagnostic, EndpointId, OperationId } from '@ankhorage/contracts/data';
+export type EndpointTestInputValues = Readonly<Record<string, DataContractValue>>;
+export type EndpointTestHeaders = Readonly<Record<string, string>>;
+export interface EndpointTestCredential {
+    readonly headers?: EndpointTestHeaders;
+    readonly query?: EndpointTestInputValues;
+}
+export type EndpointTestCredentialResolver = (credential: CredentialRef) => EndpointTestCredential | Promise<EndpointTestCredential | undefined> | undefined;
+export interface EndpointTestFetchInit {
+    readonly method: string;
+    readonly headers: EndpointTestHeaders;
+    readonly body?: string;
+}
+export interface EndpointTestFetchResponse {
+    readonly status: number;
+    readonly headers?: EndpointTestHeaders;
+    text(): Promise<string>;
+}
+export type EndpointTestFetch = (url: string, init: EndpointTestFetchInit) => Promise<EndpointTestFetchResponse>;
+export interface EndpointTestInput {
+    readonly dataSource: DataSourceConfig;
+    readonly endpointId: EndpointId;
+    readonly operationId: OperationId;
+    readonly values?: EndpointTestInputValues;
+    readonly dryRun?: boolean;
+    readonly fetch?: EndpointTestFetch;
+    readonly credentialResolver?: EndpointTestCredentialResolver;
+}
+export interface EndpointTestRequestDiagnostic {
+    readonly dataSourceId: string;
+    readonly endpointId: EndpointId;
+    readonly operationId: OperationId;
+    readonly url: string;
+    readonly method: string;
+    readonly headers: EndpointTestHeaders;
+    readonly body?: string;
+    readonly dryRun: boolean;
+}
+export interface EndpointTestResponseDiagnostic {
+    readonly status: number;
+    readonly ok: boolean;
+    readonly headers?: EndpointTestHeaders;
+    readonly bodyText?: string;
+    readonly parsedBody?: DataContractValue;
+}
+export type EndpointTestResult = {
+    readonly ok: true;
+    readonly request: EndpointTestRequestDiagnostic;
+    readonly response?: EndpointTestResponseDiagnostic;
+    readonly data?: DataContractValue;
+    readonly diagnostics: readonly DataSourceDiagnostic[];
+} | {
+    readonly ok: false;
+    readonly request?: EndpointTestRequestDiagnostic;
+    readonly response?: EndpointTestResponseDiagnostic;
+    readonly diagnostics: readonly DataSourceDiagnostic[];
+};
+export declare function testEndpoint(input: EndpointTestInput): Promise<EndpointTestResult>;
+export declare function buildEndpointTestRequest(input: EndpointTestInput): Promise<EndpointTestResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/test-runner/index.d.ts.map

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

package/dist/test-runner/index.js

@@ -0,0 +1,307 @@
+export async function testEndpoint(input) {
+    const built = await buildEndpointTestRequest(input);
+    if (!built.ok)
+        return built;
+    if (input.dryRun === true)
+        return built;
+    if (input.fetch === undefined) {
+        return {
+            ok: false,
+            request: built.request,
+            diagnostics: [
+                ...built.diagnostics,
+                createDiagnostic(input, 'invalid-config', 'Endpoint test runner requires an injected fetch function.'),
+            ],
+        };
+    }
+    try {
+        const response = await input.fetch(built.request.url, {
+            method: built.request.method,
+            headers: built.request.headers,
+            body: built.request.body,
+        });
+        const responseDiagnostic = await createResponseDiagnostic(response);
+        const diagnostics = [...built.diagnostics];
+        if (!responseDiagnostic.ok) {
+            diagnostics.push(createDiagnostic(input, 'http-error', `Endpoint test request returned HTTP status ${responseDiagnostic.status}.`));
+        }
+        return responseDiagnostic.ok
+            ? {
+                ok: true,
+                request: built.request,
+                response: responseDiagnostic,
+                data: responseDiagnostic.parsedBody,
+                diagnostics,
+            }
+            : {
+                ok: false,
+                request: built.request,
+                response: responseDiagnostic,
+                diagnostics,
+            };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            request: built.request,
+            diagnostics: [
+                ...built.diagnostics,
+                createDiagnostic(input, 'network-error', createNetworkErrorMessage(error)),
+            ],
+        };
+    }
+}
+export async function buildEndpointTestRequest(input) {
+    const selection = selectEndpointOperation(input);
+    if (selection === undefined) {
+        return {
+            ok: false,
+            diagnostics: [
+                createDiagnostic(input, 'missing-operation', 'Endpoint or operation could not be found.'),
+            ],
+        };
+    }
+    const diagnostics = [];
+    const credential = await resolveEndpointCredential(input, selection, diagnostics);
+    const request = selection.operation.protocol === 'graphql'
+        ? buildGraphQlRequest(input, selection, credential, diagnostics)
+        : buildHttpRequest(input, selection, credential, diagnostics);
+    if (request === undefined || diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {
+        return {
+            ok: false,
+            request,
+            diagnostics,
+        };
+    }
+    return {
+        ok: true,
+        request,
+        diagnostics,
+    };
+}
+function selectEndpointOperation(input) {
+    const endpoint = input.dataSource.endpoints[input.endpointId];
+    const operation = endpoint?.operations[input.operationId];
+    if (endpoint === undefined || operation === undefined)
+        return undefined;
+    return { endpoint, operation };
+}
+async function resolveEndpointCredential(input, selection, diagnostics) {
+    const credentialRef = selection.operation.credential ?? selection.endpoint.credential ?? input.dataSource.credential;
+    if (credentialRef === undefined)
+        return undefined;
+    if (input.credentialResolver === undefined) {
+        diagnostics.push(createDiagnostic(input, 'missing-credential', `Credential '${credentialRef.id}' requires a resolver.`));
+        return undefined;
+    }
+    const credential = await input.credentialResolver(credentialRef);
+    if (credential === undefined) {
+        diagnostics.push(createDiagnostic(input, 'missing-credential', `Credential '${credentialRef.id}' could not be resolved.`));
+    }
+    return credential;
+}
+function buildHttpRequest(input, selection, credential, diagnostics) {
+    const baseUrl = getDataSourceBaseUrl(input.dataSource, selection.endpoint);
+    const path = selection.operation.path ?? selection.endpoint.path;
+    if (baseUrl === undefined || baseUrl.trim().length === 0) {
+        diagnostics.push(createDiagnostic(input, 'invalid-config', 'HTTP endpoint requires a base URL.'));
+        return undefined;
+    }
+    if (path === undefined) {
+        diagnostics.push(createDiagnostic(input, 'invalid-config', 'HTTP operation requires a path.'));
+        return undefined;
+    }
+    const values = input.values ?? {};
+    const parameters = selection.operation.request?.parameters ?? [];
+    const pathResult = interpolatePath(path, parameters, values, input, diagnostics);
+    const query = collectQuery(parameters, values, credential?.query);
+    const url = appendQuery(joinUrl(baseUrl, pathResult), query);
+    const body = createHttpBody(selection.operation, values);
+    const headers = {
+        ...(credential?.headers ?? {}),
+    };
+    if (body !== undefined) {
+        headers['content-type'] = headers['content-type'] ?? 'application/json';
+    }
+    return {
+        dataSourceId: input.dataSource.id,
+        endpointId: input.endpointId,
+        operationId: input.operationId,
+        url,
+        method: selection.operation.method ?? 'GET',
+        headers,
+        body,
+        dryRun: input.dryRun === true,
+    };
+}
+function buildGraphQlRequest(input, selection, credential, diagnostics) {
+    const endpointUrl = getGraphQlEndpointUrl(input.dataSource, selection.endpoint);
+    if (endpointUrl === undefined || endpointUrl.trim().length === 0) {
+        diagnostics.push(createDiagnostic(input, 'invalid-config', 'GraphQL endpoint requires an endpoint URL.'));
+        return undefined;
+    }
+    const query = getStringMetadataValue(selection.operation.metadata, 'document') ??
+        getStringValue(input.values, 'query');
+    if (query === undefined) {
+        diagnostics.push(createDiagnostic(input, 'invalid-config', 'GraphQL operation requires a query document.'));
+        return undefined;
+    }
+    const variables = getRecordValue(input.values, 'variables');
+    const body = JSON.stringify({ query, variables: variables ?? {} });
+    const headers = {
+        ...(credential?.headers ?? {}),
+        'content-type': 'application/json',
+    };
+    return {
+        dataSourceId: input.dataSource.id,
+        endpointId: input.endpointId,
+        operationId: input.operationId,
+        url: appendQuery(endpointUrl, credential?.query ?? {}),
+        method: 'POST',
+        headers,
+        body,
+        dryRun: input.dryRun === true,
+    };
+}
+function getDataSourceBaseUrl(dataSource, endpoint) {
+    if (endpoint.baseUrl !== undefined)
+        return endpoint.baseUrl;
+    if (dataSource.kind === 'rest' || dataSource.kind === 'openapi')
+        return dataSource.baseUrl;
+    if (dataSource.kind === 'graphql')
+        return dataSource.endpointUrl;
+    return undefined;
+}
+function getGraphQlEndpointUrl(dataSource, endpoint) {
+    if (endpoint.baseUrl !== undefined)
+        return endpoint.baseUrl;
+    if (dataSource.kind === 'graphql')
+        return dataSource.endpointUrl;
+    return undefined;
+}
+function interpolatePath(path, parameters, values, input, diagnostics) {
+    let nextPath = path;
+    const pathParameters = parameters.filter((parameter) => parameter.location === 'path');
+    for (const parameter of pathParameters) {
+        const value = values[parameter.name] ?? parameter.default;
+        if (value === undefined) {
+            diagnostics.push(createDiagnostic(input, 'invalid-config', `Missing required path parameter '${parameter.name}'.`));
+            continue;
+        }
+        const encodedValue = encodeURIComponent(serializeEndpointUrlValue(value));
+        nextPath = nextPath.replaceAll(`{${parameter.name}}`, encodedValue);
+        nextPath = nextPath.replaceAll(`:${parameter.name}`, encodedValue);
+    }
+    return nextPath;
+}
+function collectQuery(parameters, values, credentialQuery) {
+    const query = { ...(credentialQuery ?? {}) };
+    for (const parameter of parameters) {
+        if (parameter.location !== 'query')
+            continue;
+        const value = values[parameter.name] ?? parameter.default;
+        if (value !== undefined)
+            query[parameter.name] = value;
+    }
+    return query;
+}
+function createHttpBody(operation, values) {
+    if (operation.method === 'GET' || operation.method === 'HEAD')
+        return undefined;
+    const { body } = values;
+    if (body === undefined)
+        return undefined;
+    return JSON.stringify(body);
+}
+async function createResponseDiagnostic(response) {
+    const bodyText = await response.text();
+    const parsedBody = parseResponseBody(bodyText);
+    return {
+        status: response.status,
+        ok: response.status >= 200 && response.status < 300,
+        headers: response.headers,
+        bodyText,
+        parsedBody,
+    };
+}
+function parseResponseBody(bodyText) {
+    if (bodyText.trim().length === 0)
+        return undefined;
+    try {
+        const parsed = JSON.parse(bodyText);
+        return isDataContractValue(parsed) ? parsed : { raw: bodyText };
+    }
+    catch {
+        return { raw: bodyText };
+    }
+}
+function appendQuery(url, query) {
+    const entries = Object.entries(query);
+    if (entries.length === 0)
+        return url;
+    const search = entries
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(serializeEndpointUrlValue(value))}`)
+        .join('&');
+    const separator = url.includes('?') ? '&' : '?';
+    return `${url}${separator}${search}`;
+}
+function serializeEndpointUrlValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value.toString();
+    if (value === null)
+        return '';
+    return JSON.stringify(value);
+}
+function joinUrl(baseUrl, path) {
+    const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+    return `${normalizedBase}${normalizedPath}`;
+}
+function getStringValue(values, key) {
+    const value = values?.[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function getRecordValue(values, key) {
+    const value = values?.[key];
+    return isDataContractValue(value) ? value : undefined;
+}
+function getStringMetadataValue(metadata, key) {
+    if (!isDataContractRecord(metadata))
+        return undefined;
+    const value = metadata[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function createDiagnostic(input, code, message) {
+    return {
+        code,
+        dataSourceId: input.dataSource.id,
+        endpointId: input.endpointId,
+        operationId: input.operationId,
+        message,
+        severity: code === 'missing-schema' ? 'info' : 'error',
+    };
+}
+function createNetworkErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return 'Endpoint test request failed.';
+}
+function isDataContractValue(value) {
+    if (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean') {
+        return true;
+    }
+    if (Array.isArray(value))
+        return value.every(isDataContractValue);
+    if (typeof value !== 'object')
+        return false;
+    return Object.values(value).every(isDataContractValue);
+}
+function isDataContractRecord(value) {
+    return (value !== undefined && typeof value === 'object' && value !== null && !Array.isArray(value));
+}
+//# sourceMappingURL=index.js.map

package/dist/test-runner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test-runner/index.ts"],"names":[],"mappings":"AA0FA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAExC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE;gBACX,GAAG,KAAK,CAAC,WAAW;gBACpB,gBAAgB,CACd,KAAK,EACL,gBAAgB,EAChB,2DAA2D,CAC5D;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;YACpD,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO;YAC9B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;SACzB,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,MAAM,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QAE3C,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,KAAK,EACL,YAAY,EACZ,8CAA8C,kBAAkB,CAAC,MAAM,GAAG,CAC3E,CACF,CAAC;QACJ,CAAC;QAED,OAAO,kBAAkB,CAAC,EAAE;YAC1B,CAAC,CAAC;gBACE,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,kBAAkB,CAAC,UAAU;gBACnC,WAAW;aACZ;YACH,CAAC,CAAC;gBACE,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW;aACZ,CAAC;IACR,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE;gBACX,GAAG,KAAK,CAAC,WAAW;gBACpB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,yBAAyB,CAAC,KAAK,CAAC,CAAC;aAC3E;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAwB;IAExB,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,WAAW,EAAE;gBACX,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,EAAE,2CAA2C,CAAC;aAC1F;SACF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAClF,MAAM,OAAO,GACX,SAAS,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS;QACxC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC;QAChE,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAElE,IAAI,OAAO,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;QAC/F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO;YACP,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAwB;IACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAE1D,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAExE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,KAAwB,EACxB,SAAqC,EACrC,WAAmC;IAEnC,MAAM,aAAa,GACjB,SAAS,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;IAEjG,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAElD,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC3C,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,KAAK,EACL,oBAAoB,EACpB,eAAe,aAAa,CAAC,EAAE,wBAAwB,CACxD,CACF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAEjE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,KAAK,EACL,oBAAoB,EACpB,eAAe,aAAa,CAAC,EAAE,0BAA0B,CAC1D,CACF,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAwB,EACxB,SAAqC,EACrC,UAA8C,EAC9C,WAAmC;IAEnC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;IAEjE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,WAAW,CAAC,IAAI,CACd,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,oCAAoC,CAAC,CAChF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,iCAAiC,CAAC,CAAC,CAAC;QAC/F,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;IACjE,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,OAAO,GAA2B;QACtC,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC;KAC/B,CAAC;IAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,kBAAkB,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;QACjC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG;QACH,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,IAAI,KAAK;QAC3C,OAAO;QACP,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAwB,EACxB,SAAqC,EACrC,UAA8C,EAC9C,WAAmC;IAEnC,MAAM,WAAW,GAAG,qBAAqB,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEhF,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjE,WAAW,CAAC,IAAI,CACd,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,4CAA4C,CAAC,CACxF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GACT,sBAAsB,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC;QAChE,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,WAAW,CAAC,IAAI,CACd,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,8CAA8C,CAAC,CAC1F,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,OAAO,GAA2B;QACtC,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC;QAC9B,cAAc,EAAE,kBAAkB;KACnC,CAAC;IAEF,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;QACjC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,EAAE,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAA4B,EAC5B,QAA4B;IAE5B,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC5D,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IAC3F,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IACjE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAC5B,UAA4B,EAC5B,QAA4B;IAE5B,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC5D,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IACjE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CACtB,IAAY,EACZ,UAA6C,EAC7C,MAA+B,EAC/B,KAAwB,EACxB,WAAmC;IAEnC,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAEvF,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC;QAE1D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,KAAK,EACL,gBAAgB,EAChB,oCAAoC,SAAS,CAAC,IAAI,IAAI,CACvD,CACF,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1E,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,GAAG,EAAE,YAAY,CAAC,CAAC;QACpE,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,UAA6C,EAC7C,MAA+B,EAC/B,eAAoD;IAEpD,MAAM,KAAK,GAAsC,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;IAEhF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO;YAAE,SAAS;QAE7C,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC;QAC1D,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACzD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CACrB,SAA8B,EAC9B,MAA+B;IAE/B,IAAI,SAAS,CAAC,MAAM,KAAK,KAAK,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAEhF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEzC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,QAAmC;IAEnC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE/C,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,EAAE,EAAE,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;QACnD,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ;QACR,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,KAA8B;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAErC,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,EAAE,CACvF;SACA,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAEhD,OAAO,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAwB;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACrF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAE9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,IAAY;IAC5C,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9E,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAEhE,OAAO,GAAG,cAAc,GAAG,cAAc,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CACrB,MAA2C,EAC3C,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CACrB,MAA2C,EAC3C,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,SAAS,sBAAsB,CAC7B,QAAuC,EACvC,GAAW;IAEX,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAEtD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAwB,EACxB,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;QACjC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO;QACP,QAAQ,EAAE,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;KACvD,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,+BAA+B,CAAC;AACzC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAoC;IAEpC,OAAO,CACL,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAC5F,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  CredentialRef,\n  DataContractValue,\n  DataEndpointConfig,\n  DataOperationConfig,\n  DataOperationParameter,\n  DataSourceConfig,\n  DataSourceDiagnostic,\n  EndpointId,\n  OperationId,\n} from '@ankhorage/contracts/data';\n\nexport type EndpointTestInputValues = Readonly<Record<string, DataContractValue>>;\nexport type EndpointTestHeaders = Readonly<Record<string, string>>;\n\nexport interface EndpointTestCredential {\n  readonly headers?: EndpointTestHeaders;\n  readonly query?: EndpointTestInputValues;\n}\n\nexport type EndpointTestCredentialResolver = (\n  credential: CredentialRef,\n) => EndpointTestCredential | Promise<EndpointTestCredential | undefined> | undefined;\n\nexport interface EndpointTestFetchInit {\n  readonly method: string;\n  readonly headers: EndpointTestHeaders;\n  readonly body?: string;\n}\n\nexport interface EndpointTestFetchResponse {\n  readonly status: number;\n  readonly headers?: EndpointTestHeaders;\n  text(): Promise<string>;\n}\n\nexport type EndpointTestFetch = (\n  url: string,\n  init: EndpointTestFetchInit,\n) => Promise<EndpointTestFetchResponse>;\n\nexport interface EndpointTestInput {\n  readonly dataSource: DataSourceConfig;\n  readonly endpointId: EndpointId;\n  readonly operationId: OperationId;\n  readonly values?: EndpointTestInputValues;\n  readonly dryRun?: boolean;\n  readonly fetch?: EndpointTestFetch;\n  readonly credentialResolver?: EndpointTestCredentialResolver;\n}\n\nexport interface EndpointTestRequestDiagnostic {\n  readonly dataSourceId: string;\n  readonly endpointId: EndpointId;\n  readonly operationId: OperationId;\n  readonly url: string;\n  readonly method: string;\n  readonly headers: EndpointTestHeaders;\n  readonly body?: string;\n  readonly dryRun: boolean;\n}\n\nexport interface EndpointTestResponseDiagnostic {\n  readonly status: number;\n  readonly ok: boolean;\n  readonly headers?: EndpointTestHeaders;\n  readonly bodyText?: string;\n  readonly parsedBody?: DataContractValue;\n}\n\nexport type EndpointTestResult =\n  | {\n      readonly ok: true;\n      readonly request: EndpointTestRequestDiagnostic;\n      readonly response?: EndpointTestResponseDiagnostic;\n      readonly data?: DataContractValue;\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    }\n  | {\n      readonly ok: false;\n      readonly request?: EndpointTestRequestDiagnostic;\n      readonly response?: EndpointTestResponseDiagnostic;\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    };\n\ninterface EndpointOperationSelection {\n  readonly endpoint: DataEndpointConfig;\n  readonly operation: DataOperationConfig;\n}\n\nexport async function testEndpoint(input: EndpointTestInput): Promise<EndpointTestResult> {\n  const built = await buildEndpointTestRequest(input);\n\n  if (!built.ok) return built;\n  if (input.dryRun === true) return built;\n\n  if (input.fetch === undefined) {\n    return {\n      ok: false,\n      request: built.request,\n      diagnostics: [\n        ...built.diagnostics,\n        createDiagnostic(\n          input,\n          'invalid-config',\n          'Endpoint test runner requires an injected fetch function.',\n        ),\n      ],\n    };\n  }\n\n  try {\n    const response = await input.fetch(built.request.url, {\n      method: built.request.method,\n      headers: built.request.headers,\n      body: built.request.body,\n    });\n    const responseDiagnostic = await createResponseDiagnostic(response);\n    const diagnostics = [...built.diagnostics];\n\n    if (!responseDiagnostic.ok) {\n      diagnostics.push(\n        createDiagnostic(\n          input,\n          'http-error',\n          `Endpoint test request returned HTTP status ${responseDiagnostic.status}.`,\n        ),\n      );\n    }\n\n    return responseDiagnostic.ok\n      ? {\n          ok: true,\n          request: built.request,\n          response: responseDiagnostic,\n          data: responseDiagnostic.parsedBody,\n          diagnostics,\n        }\n      : {\n          ok: false,\n          request: built.request,\n          response: responseDiagnostic,\n          diagnostics,\n        };\n  } catch (error) {\n    return {\n      ok: false,\n      request: built.request,\n      diagnostics: [\n        ...built.diagnostics,\n        createDiagnostic(input, 'network-error', createNetworkErrorMessage(error)),\n      ],\n    };\n  }\n}\n\nexport async function buildEndpointTestRequest(\n  input: EndpointTestInput,\n): Promise<EndpointTestResult> {\n  const selection = selectEndpointOperation(input);\n  if (selection === undefined) {\n    return {\n      ok: false,\n      diagnostics: [\n        createDiagnostic(input, 'missing-operation', 'Endpoint or operation could not be found.'),\n      ],\n    };\n  }\n\n  const diagnostics: DataSourceDiagnostic[] = [];\n  const credential = await resolveEndpointCredential(input, selection, diagnostics);\n  const request =\n    selection.operation.protocol === 'graphql'\n      ? buildGraphQlRequest(input, selection, credential, diagnostics)\n      : buildHttpRequest(input, selection, credential, diagnostics);\n\n  if (request === undefined || diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {\n    return {\n      ok: false,\n      request,\n      diagnostics,\n    };\n  }\n\n  return {\n    ok: true,\n    request,\n    diagnostics,\n  };\n}\n\nfunction selectEndpointOperation(input: EndpointTestInput): EndpointOperationSelection | undefined {\n  const endpoint = input.dataSource.endpoints[input.endpointId];\n  const operation = endpoint?.operations[input.operationId];\n\n  if (endpoint === undefined || operation === undefined) return undefined;\n\n  return { endpoint, operation };\n}\n\nasync function resolveEndpointCredential(\n  input: EndpointTestInput,\n  selection: EndpointOperationSelection,\n  diagnostics: DataSourceDiagnostic[],\n): Promise<EndpointTestCredential | undefined> {\n  const credentialRef =\n    selection.operation.credential ?? selection.endpoint.credential ?? input.dataSource.credential;\n\n  if (credentialRef === undefined) return undefined;\n\n  if (input.credentialResolver === undefined) {\n    diagnostics.push(\n      createDiagnostic(\n        input,\n        'missing-credential',\n        `Credential '${credentialRef.id}' requires a resolver.`,\n      ),\n    );\n    return undefined;\n  }\n\n  const credential = await input.credentialResolver(credentialRef);\n\n  if (credential === undefined) {\n    diagnostics.push(\n      createDiagnostic(\n        input,\n        'missing-credential',\n        `Credential '${credentialRef.id}' could not be resolved.`,\n      ),\n    );\n  }\n\n  return credential;\n}\n\nfunction buildHttpRequest(\n  input: EndpointTestInput,\n  selection: EndpointOperationSelection,\n  credential: EndpointTestCredential | undefined,\n  diagnostics: DataSourceDiagnostic[],\n): EndpointTestRequestDiagnostic | undefined {\n  const baseUrl = getDataSourceBaseUrl(input.dataSource, selection.endpoint);\n  const path = selection.operation.path ?? selection.endpoint.path;\n\n  if (baseUrl === undefined || baseUrl.trim().length === 0) {\n    diagnostics.push(\n      createDiagnostic(input, 'invalid-config', 'HTTP endpoint requires a base URL.'),\n    );\n    return undefined;\n  }\n\n  if (path === undefined) {\n    diagnostics.push(createDiagnostic(input, 'invalid-config', 'HTTP operation requires a path.'));\n    return undefined;\n  }\n\n  const values = input.values ?? {};\n  const parameters = selection.operation.request?.parameters ?? [];\n  const pathResult = interpolatePath(path, parameters, values, input, diagnostics);\n  const query = collectQuery(parameters, values, credential?.query);\n  const url = appendQuery(joinUrl(baseUrl, pathResult), query);\n  const body = createHttpBody(selection.operation, values);\n  const headers: Record<string, string> = {\n    ...(credential?.headers ?? {}),\n  };\n\n  if (body !== undefined) {\n    headers['content-type'] = headers['content-type'] ?? 'application/json';\n  }\n\n  return {\n    dataSourceId: input.dataSource.id,\n    endpointId: input.endpointId,\n    operationId: input.operationId,\n    url,\n    method: selection.operation.method ?? 'GET',\n    headers,\n    body,\n    dryRun: input.dryRun === true,\n  };\n}\n\nfunction buildGraphQlRequest(\n  input: EndpointTestInput,\n  selection: EndpointOperationSelection,\n  credential: EndpointTestCredential | undefined,\n  diagnostics: DataSourceDiagnostic[],\n): EndpointTestRequestDiagnostic | undefined {\n  const endpointUrl = getGraphQlEndpointUrl(input.dataSource, selection.endpoint);\n\n  if (endpointUrl === undefined || endpointUrl.trim().length === 0) {\n    diagnostics.push(\n      createDiagnostic(input, 'invalid-config', 'GraphQL endpoint requires an endpoint URL.'),\n    );\n    return undefined;\n  }\n\n  const query =\n    getStringMetadataValue(selection.operation.metadata, 'document') ??\n    getStringValue(input.values, 'query');\n\n  if (query === undefined) {\n    diagnostics.push(\n      createDiagnostic(input, 'invalid-config', 'GraphQL operation requires a query document.'),\n    );\n    return undefined;\n  }\n\n  const variables = getRecordValue(input.values, 'variables');\n  const body = JSON.stringify({ query, variables: variables ?? {} });\n  const headers: Record<string, string> = {\n    ...(credential?.headers ?? {}),\n    'content-type': 'application/json',\n  };\n\n  return {\n    dataSourceId: input.dataSource.id,\n    endpointId: input.endpointId,\n    operationId: input.operationId,\n    url: appendQuery(endpointUrl, credential?.query ?? {}),\n    method: 'POST',\n    headers,\n    body,\n    dryRun: input.dryRun === true,\n  };\n}\n\nfunction getDataSourceBaseUrl(\n  dataSource: DataSourceConfig,\n  endpoint: DataEndpointConfig,\n): string | undefined {\n  if (endpoint.baseUrl !== undefined) return endpoint.baseUrl;\n  if (dataSource.kind === 'rest' || dataSource.kind === 'openapi') return dataSource.baseUrl;\n  if (dataSource.kind === 'graphql') return dataSource.endpointUrl;\n  return undefined;\n}\n\nfunction getGraphQlEndpointUrl(\n  dataSource: DataSourceConfig,\n  endpoint: DataEndpointConfig,\n): string | undefined {\n  if (endpoint.baseUrl !== undefined) return endpoint.baseUrl;\n  if (dataSource.kind === 'graphql') return dataSource.endpointUrl;\n  return undefined;\n}\n\nfunction interpolatePath(\n  path: string,\n  parameters: readonly DataOperationParameter[],\n  values: EndpointTestInputValues,\n  input: EndpointTestInput,\n  diagnostics: DataSourceDiagnostic[],\n): string {\n  let nextPath = path;\n  const pathParameters = parameters.filter((parameter) => parameter.location === 'path');\n\n  for (const parameter of pathParameters) {\n    const value = values[parameter.name] ?? parameter.default;\n\n    if (value === undefined) {\n      diagnostics.push(\n        createDiagnostic(\n          input,\n          'invalid-config',\n          `Missing required path parameter '${parameter.name}'.`,\n        ),\n      );\n      continue;\n    }\n\n    const encodedValue = encodeURIComponent(serializeEndpointUrlValue(value));\n    nextPath = nextPath.replaceAll(`{${parameter.name}}`, encodedValue);\n    nextPath = nextPath.replaceAll(`:${parameter.name}`, encodedValue);\n  }\n\n  return nextPath;\n}\n\nfunction collectQuery(\n  parameters: readonly DataOperationParameter[],\n  values: EndpointTestInputValues,\n  credentialQuery: EndpointTestInputValues | undefined,\n): EndpointTestInputValues {\n  const query: Record<string, DataContractValue> = { ...(credentialQuery ?? {}) };\n\n  for (const parameter of parameters) {\n    if (parameter.location !== 'query') continue;\n\n    const value = values[parameter.name] ?? parameter.default;\n    if (value !== undefined) query[parameter.name] = value;\n  }\n\n  return query;\n}\n\nfunction createHttpBody(\n  operation: DataOperationConfig,\n  values: EndpointTestInputValues,\n): string | undefined {\n  if (operation.method === 'GET' || operation.method === 'HEAD') return undefined;\n\n  const { body } = values;\n  if (body === undefined) return undefined;\n\n  return JSON.stringify(body);\n}\n\nasync function createResponseDiagnostic(\n  response: EndpointTestFetchResponse,\n): Promise<EndpointTestResponseDiagnostic> {\n  const bodyText = await response.text();\n  const parsedBody = parseResponseBody(bodyText);\n\n  return {\n    status: response.status,\n    ok: response.status >= 200 && response.status < 300,\n    headers: response.headers,\n    bodyText,\n    parsedBody,\n  };\n}\n\nfunction parseResponseBody(bodyText: string): DataContractValue | undefined {\n  if (bodyText.trim().length === 0) return undefined;\n\n  try {\n    const parsed: unknown = JSON.parse(bodyText);\n    return isDataContractValue(parsed) ? parsed : { raw: bodyText };\n  } catch {\n    return { raw: bodyText };\n  }\n}\n\nfunction appendQuery(url: string, query: EndpointTestInputValues): string {\n  const entries = Object.entries(query);\n  if (entries.length === 0) return url;\n\n  const search = entries\n    .map(\n      ([key, value]) =>\n        `${encodeURIComponent(key)}=${encodeURIComponent(serializeEndpointUrlValue(value))}`,\n    )\n    .join('&');\n  const separator = url.includes('?') ? '&' : '?';\n\n  return `${url}${separator}${search}`;\n}\n\nfunction serializeEndpointUrlValue(value: DataContractValue): string {\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number' || typeof value === 'boolean') return value.toString();\n  if (value === null) return '';\n\n  return JSON.stringify(value);\n}\n\nfunction joinUrl(baseUrl: string, path: string): string {\n  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  return `${normalizedBase}${normalizedPath}`;\n}\n\nfunction getStringValue(\n  values: EndpointTestInputValues | undefined,\n  key: string,\n): string | undefined {\n  const value = values?.[key];\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction getRecordValue(\n  values: EndpointTestInputValues | undefined,\n  key: string,\n): DataContractValue | undefined {\n  const value = values?.[key];\n  return isDataContractValue(value) ? value : undefined;\n}\n\nfunction getStringMetadataValue(\n  metadata: DataContractValue | undefined,\n  key: string,\n): string | undefined {\n  if (!isDataContractRecord(metadata)) return undefined;\n\n  const value = metadata[key];\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction createDiagnostic(\n  input: EndpointTestInput,\n  code: string,\n  message: string,\n): DataSourceDiagnostic {\n  return {\n    code,\n    dataSourceId: input.dataSource.id,\n    endpointId: input.endpointId,\n    operationId: input.operationId,\n    message,\n    severity: code === 'missing-schema' ? 'info' : 'error',\n  };\n}\n\nfunction createNetworkErrorMessage(error: unknown): string {\n  if (error instanceof Error) return error.message;\n  return 'Endpoint test request failed.';\n}\n\nfunction isDataContractValue(value: unknown): value is DataContractValue {\n  if (\n    value === null ||\n    typeof value === 'string' ||\n    typeof value === 'number' ||\n    typeof value === 'boolean'\n  ) {\n    return true;\n  }\n\n  if (Array.isArray(value)) return value.every(isDataContractValue);\n  if (typeof value !== 'object') return false;\n\n  return Object.values(value).every(isDataContractValue);\n}\n\nfunction isDataContractRecord(\n  value: DataContractValue | undefined,\n): value is Record<string, DataContractValue> {\n  return (\n    value !== undefined && typeof value === 'object' && value !== null && !Array.isArray(value)\n  );\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/data-sources",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Headless toolkit for importing, generating, normalizing, and testing Ankhorage data-source configs.",
   "homepage": "https://github.com/ankhorage/data-sources#readme",
   "bugs": {

package/src/index.ts

@@ -4,6 +4,7 @@ export * from './graphql';
 export * from './managed-api';
 export * from './openapi';
 export * from './rest';
+export * from './test-runner';
 
 export const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources' as const;
 

package/src/test-runner/index.test.ts

@@ -0,0 +1,266 @@
+import type { DataSourceConfig } from '@ankhorage/contracts/data';
+import { describe, expect, it } from 'bun:test';
+
+import { buildEndpointTestRequest, type EndpointTestFetch, testEndpoint } from './index';
+
+function createRestDataSource(): DataSourceConfig {
+  return {
+    id: 'cms',
+    kind: 'rest',
+    baseUrl: 'https://cms.example.com',
+    credential: { id: 'cms-token', kind: 'bearer' },
+    endpoints: {
+      posts: {
+        id: 'posts',
+        kind: 'http',
+        path: '/posts/{postId}',
+        operations: {
+          'posts.get': {
+            id: 'posts.get',
+            endpointId: 'posts',
+            protocol: 'http',
+            intent: 'read',
+            method: 'GET',
+            path: '/posts/{postId}',
+            request: {
+              parameters: [
+                {
+                  name: 'postId',
+                  location: 'path',
+                  required: true,
+                  schema: { type: 'string' },
+                },
+                {
+                  name: 'preview',
+                  location: 'query',
+                  schema: { type: 'boolean' },
+                },
+              ],
+            },
+            response: {
+              status: 200,
+              schema: {
+                type: 'object',
+              },
+            },
+          },
+          'posts.create': {
+            id: 'posts.create',
+            endpointId: 'posts',
+            protocol: 'http',
+            intent: 'create',
+            method: 'POST',
+            path: '/posts',
+            request: {
+              contentType: 'application/json',
+              schema: { type: 'object' },
+            },
+            response: {
+              status: 201,
+              schema: { type: 'object' },
+            },
+          },
+        },
+      },
+    },
+  };
+}
+
+function createGraphQlDataSource(): DataSourceConfig {
+  return {
+    id: 'content',
+    kind: 'graphql',
+    endpointUrl: 'https://content.example.com/graphql',
+    endpoints: {
+      graphql: {
+        id: 'graphql',
+        kind: 'graphql',
+        operations: {
+          'query.viewer': {
+            id: 'query.viewer',
+            endpointId: 'graphql',
+            protocol: 'graphql',
+            intent: 'read',
+            request: { schema: { type: 'object' } },
+            response: { schema: { type: 'object' } },
+            metadata: {
+              document: 'query Viewer($id: ID!) { viewer(id: $id) { id } }',
+              selectionPath: '$.data.viewer',
+            },
+          },
+        },
+      },
+    },
+  };
+}
+
+describe('endpoint test runner', () => {
+  it('builds a dry-run REST request with path, query, and credential headers', async () => {
+    const result = await buildEndpointTestRequest({
+      dataSource: createRestDataSource(),
+      endpointId: 'posts',
+      operationId: 'posts.get',
+      dryRun: true,
+      values: {
+        postId: 'post 1',
+        preview: true,
+      },
+      credentialResolver: () => ({
+        headers: { authorization: 'Bearer token' },
+      }),
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      expect(result.request.url).toBe('https://cms.example.com/posts/post%201?preview=true');
+      expect(result.request.method).toBe('GET');
+      expect(result.request.headers.authorization).toBe('Bearer token');
+      expect(result.request.dryRun).toBe(true);
+    }
+  });
+
+  it('executes a successful REST request and parses JSON responses', async () => {
+    const fetch: EndpointTestFetch = (url, init) => {
+      expect(url).toBe('https://cms.example.com/posts/post-1');
+      expect(init.method).toBe('GET');
+      return Promise.resolve({
+        status: 200,
+        headers: { 'content-type': 'application/json' },
+        text: () => Promise.resolve('{"id":"post-1"}'),
+      });
+    };
+
+    const result = await testEndpoint({
+      dataSource: createRestDataSource(),
+      endpointId: 'posts',
+      operationId: 'posts.get',
+      values: { postId: 'post-1' },
+      credentialResolver: () => ({ headers: { authorization: 'Bearer token' } }),
+      fetch,
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      expect(result.response?.status).toBe(200);
+      expect(result.data).toEqual({ id: 'post-1' });
+    }
+  });
+
+  it('returns structured diagnostics for HTTP errors', async () => {
+    const fetch: EndpointTestFetch = () =>
+      Promise.resolve({
+        status: 404,
+        text: () => Promise.resolve('{"error":"Not found"}'),
+      });
+
+    const result = await testEndpoint({
+      dataSource: createRestDataSource(),
+      endpointId: 'posts',
+      operationId: 'posts.get',
+      values: { postId: 'missing' },
+      credentialResolver: () => ({ headers: { authorization: 'Bearer token' } }),
+      fetch,
+    });
+
+    expect(result.ok).toBe(false);
+    if (!result.ok) {
+      expect(result.response?.status).toBe(404);
+      expect(result.diagnostics.map((diagnostic) => diagnostic.code)).toContain('http-error');
+    }
+  });
+
+  it('returns structured diagnostics for network errors', async () => {
+    const fetch: EndpointTestFetch = () => Promise.reject(new Error('Connection failed'));
+
+    const result = await testEndpoint({
+      dataSource: createRestDataSource(),
+      endpointId: 'posts',
+      operationId: 'posts.get',
+      values: { postId: 'post-1' },
+      credentialResolver: () => ({ headers: { authorization: 'Bearer token' } }),
+      fetch,
+    });
+
+    expect(result.ok).toBe(false);
+    if (!result.ok) {
+      expect(result.diagnostics.map((diagnostic) => diagnostic.code)).toContain('network-error');
+      expect(result.diagnostics.map((diagnostic) => diagnostic.message)).toContain(
+        'Connection failed',
+      );
+    }
+  });
+
+  it('returns structured diagnostics for missing credentials', async () => {
+    const result = await buildEndpointTestRequest({
+      dataSource: createRestDataSource(),
+      endpointId: 'posts',
+      operationId: 'posts.get',
+      values: { postId: 'post-1' },
+    });
+
+    expect(result.ok).toBe(false);
+    if (!result.ok) {
+      expect(result.diagnostics.map((diagnostic) => diagnostic.code)).toContain(
+        'missing-credential',
+      );
+    }
+  });
+
+  it('returns structured diagnostics for invalid input', async () => {
+    const result = await buildEndpointTestRequest({
+      dataSource: createRestDataSource(),
+      endpointId: 'posts',
+      operationId: 'posts.get',
+      credentialResolver: () => ({ headers: { authorization: 'Bearer token' } }),
+    });
+
+    expect(result.ok).toBe(false);
+    if (!result.ok) {
+      expect(result.diagnostics.map((diagnostic) => diagnostic.message)).toContain(
+        "Missing required path parameter 'postId'.",
+      );
+    }
+  });
+
+  it('builds POST request bodies from input body values', async () => {
+    const result = await buildEndpointTestRequest({
+      dataSource: createRestDataSource(),
+      endpointId: 'posts',
+      operationId: 'posts.create',
+      dryRun: true,
+      values: {
+        body: { title: 'Hello' },
+      },
+      credentialResolver: () => ({ headers: { authorization: 'Bearer token' } }),
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      expect(result.request.method).toBe('POST');
+      expect(result.request.body).toBe('{"title":"Hello"}');
+      expect(result.request.headers['content-type']).toBe('application/json');
+    }
+  });
+
+  it('builds dry-run GraphQL requests from operation metadata', async () => {
+    const result = await buildEndpointTestRequest({
+      dataSource: createGraphQlDataSource(),
+      endpointId: 'graphql',
+      operationId: 'query.viewer',
+      dryRun: true,
+      values: {
+        variables: { id: 'viewer-1' },
+      },
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      expect(result.request.url).toBe('https://content.example.com/graphql');
+      expect(result.request.method).toBe('POST');
+      expect(result.request.headers['content-type']).toBe('application/json');
+      expect(result.request.body).toBe(
+        '{"query":"query Viewer($id: ID!) { viewer(id: $id) { id } }","variables":{"id":"viewer-1"}}',
+      );
+    }
+  });
+});

package/src/test-runner/index.ts

@@ -0,0 +1,533 @@
+import type {
+  CredentialRef,
+  DataContractValue,
+  DataEndpointConfig,
+  DataOperationConfig,
+  DataOperationParameter,
+  DataSourceConfig,
+  DataSourceDiagnostic,
+  EndpointId,
+  OperationId,
+} from '@ankhorage/contracts/data';
+
+export type EndpointTestInputValues = Readonly<Record<string, DataContractValue>>;
+export type EndpointTestHeaders = Readonly<Record<string, string>>;
+
+export interface EndpointTestCredential {
+  readonly headers?: EndpointTestHeaders;
+  readonly query?: EndpointTestInputValues;
+}
+
+export type EndpointTestCredentialResolver = (
+  credential: CredentialRef,
+) => EndpointTestCredential | Promise<EndpointTestCredential | undefined> | undefined;
+
+export interface EndpointTestFetchInit {
+  readonly method: string;
+  readonly headers: EndpointTestHeaders;
+  readonly body?: string;
+}
+
+export interface EndpointTestFetchResponse {
+  readonly status: number;
+  readonly headers?: EndpointTestHeaders;
+  text(): Promise<string>;
+}
+
+export type EndpointTestFetch = (
+  url: string,
+  init: EndpointTestFetchInit,
+) => Promise<EndpointTestFetchResponse>;
+
+export interface EndpointTestInput {
+  readonly dataSource: DataSourceConfig;
+  readonly endpointId: EndpointId;
+  readonly operationId: OperationId;
+  readonly values?: EndpointTestInputValues;
+  readonly dryRun?: boolean;
+  readonly fetch?: EndpointTestFetch;
+  readonly credentialResolver?: EndpointTestCredentialResolver;
+}
+
+export interface EndpointTestRequestDiagnostic {
+  readonly dataSourceId: string;
+  readonly endpointId: EndpointId;
+  readonly operationId: OperationId;
+  readonly url: string;
+  readonly method: string;
+  readonly headers: EndpointTestHeaders;
+  readonly body?: string;
+  readonly dryRun: boolean;
+}
+
+export interface EndpointTestResponseDiagnostic {
+  readonly status: number;
+  readonly ok: boolean;
+  readonly headers?: EndpointTestHeaders;
+  readonly bodyText?: string;
+  readonly parsedBody?: DataContractValue;
+}
+
+export type EndpointTestResult =
+  | {
+      readonly ok: true;
+      readonly request: EndpointTestRequestDiagnostic;
+      readonly response?: EndpointTestResponseDiagnostic;
+      readonly data?: DataContractValue;
+      readonly diagnostics: readonly DataSourceDiagnostic[];
+    }
+  | {
+      readonly ok: false;
+      readonly request?: EndpointTestRequestDiagnostic;
+      readonly response?: EndpointTestResponseDiagnostic;
+      readonly diagnostics: readonly DataSourceDiagnostic[];
+    };
+
+interface EndpointOperationSelection {
+  readonly endpoint: DataEndpointConfig;
+  readonly operation: DataOperationConfig;
+}
+
+export async function testEndpoint(input: EndpointTestInput): Promise<EndpointTestResult> {
+  const built = await buildEndpointTestRequest(input);
+
+  if (!built.ok) return built;
+  if (input.dryRun === true) return built;
+
+  if (input.fetch === undefined) {
+    return {
+      ok: false,
+      request: built.request,
+      diagnostics: [
+        ...built.diagnostics,
+        createDiagnostic(
+          input,
+          'invalid-config',
+          'Endpoint test runner requires an injected fetch function.',
+        ),
+      ],
+    };
+  }
+
+  try {
+    const response = await input.fetch(built.request.url, {
+      method: built.request.method,
+      headers: built.request.headers,
+      body: built.request.body,
+    });
+    const responseDiagnostic = await createResponseDiagnostic(response);
+    const diagnostics = [...built.diagnostics];
+
+    if (!responseDiagnostic.ok) {
+      diagnostics.push(
+        createDiagnostic(
+          input,
+          'http-error',
+          `Endpoint test request returned HTTP status ${responseDiagnostic.status}.`,
+        ),
+      );
+    }
+
+    return responseDiagnostic.ok
+      ? {
+          ok: true,
+          request: built.request,
+          response: responseDiagnostic,
+          data: responseDiagnostic.parsedBody,
+          diagnostics,
+        }
+      : {
+          ok: false,
+          request: built.request,
+          response: responseDiagnostic,
+          diagnostics,
+        };
+  } catch (error) {
+    return {
+      ok: false,
+      request: built.request,
+      diagnostics: [
+        ...built.diagnostics,
+        createDiagnostic(input, 'network-error', createNetworkErrorMessage(error)),
+      ],
+    };
+  }
+}
+
+export async function buildEndpointTestRequest(
+  input: EndpointTestInput,
+): Promise<EndpointTestResult> {
+  const selection = selectEndpointOperation(input);
+  if (selection === undefined) {
+    return {
+      ok: false,
+      diagnostics: [
+        createDiagnostic(input, 'missing-operation', 'Endpoint or operation could not be found.'),
+      ],
+    };
+  }
+
+  const diagnostics: DataSourceDiagnostic[] = [];
+  const credential = await resolveEndpointCredential(input, selection, diagnostics);
+  const request =
+    selection.operation.protocol === 'graphql'
+      ? buildGraphQlRequest(input, selection, credential, diagnostics)
+      : buildHttpRequest(input, selection, credential, diagnostics);
+
+  if (request === undefined || diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {
+    return {
+      ok: false,
+      request,
+      diagnostics,
+    };
+  }
+
+  return {
+    ok: true,
+    request,
+    diagnostics,
+  };
+}
+
+function selectEndpointOperation(input: EndpointTestInput): EndpointOperationSelection | undefined {
+  const endpoint = input.dataSource.endpoints[input.endpointId];
+  const operation = endpoint?.operations[input.operationId];
+
+  if (endpoint === undefined || operation === undefined) return undefined;
+
+  return { endpoint, operation };
+}
+
+async function resolveEndpointCredential(
+  input: EndpointTestInput,
+  selection: EndpointOperationSelection,
+  diagnostics: DataSourceDiagnostic[],
+): Promise<EndpointTestCredential | undefined> {
+  const credentialRef =
+    selection.operation.credential ?? selection.endpoint.credential ?? input.dataSource.credential;
+
+  if (credentialRef === undefined) return undefined;
+
+  if (input.credentialResolver === undefined) {
+    diagnostics.push(
+      createDiagnostic(
+        input,
+        'missing-credential',
+        `Credential '${credentialRef.id}' requires a resolver.`,
+      ),
+    );
+    return undefined;
+  }
+
+  const credential = await input.credentialResolver(credentialRef);
+
+  if (credential === undefined) {
+    diagnostics.push(
+      createDiagnostic(
+        input,
+        'missing-credential',
+        `Credential '${credentialRef.id}' could not be resolved.`,
+      ),
+    );
+  }
+
+  return credential;
+}
+
+function buildHttpRequest(
+  input: EndpointTestInput,
+  selection: EndpointOperationSelection,
+  credential: EndpointTestCredential | undefined,
+  diagnostics: DataSourceDiagnostic[],
+): EndpointTestRequestDiagnostic | undefined {
+  const baseUrl = getDataSourceBaseUrl(input.dataSource, selection.endpoint);
+  const path = selection.operation.path ?? selection.endpoint.path;
+
+  if (baseUrl === undefined || baseUrl.trim().length === 0) {
+    diagnostics.push(
+      createDiagnostic(input, 'invalid-config', 'HTTP endpoint requires a base URL.'),
+    );
+    return undefined;
+  }
+
+  if (path === undefined) {
+    diagnostics.push(createDiagnostic(input, 'invalid-config', 'HTTP operation requires a path.'));
+    return undefined;
+  }
+
+  const values = input.values ?? {};
+  const parameters = selection.operation.request?.parameters ?? [];
+  const pathResult = interpolatePath(path, parameters, values, input, diagnostics);
+  const query = collectQuery(parameters, values, credential?.query);
+  const url = appendQuery(joinUrl(baseUrl, pathResult), query);
+  const body = createHttpBody(selection.operation, values);
+  const headers: Record<string, string> = {
+    ...(credential?.headers ?? {}),
+  };
+
+  if (body !== undefined) {
+    headers['content-type'] = headers['content-type'] ?? 'application/json';
+  }
+
+  return {
+    dataSourceId: input.dataSource.id,
+    endpointId: input.endpointId,
+    operationId: input.operationId,
+    url,
+    method: selection.operation.method ?? 'GET',
+    headers,
+    body,
+    dryRun: input.dryRun === true,
+  };
+}
+
+function buildGraphQlRequest(
+  input: EndpointTestInput,
+  selection: EndpointOperationSelection,
+  credential: EndpointTestCredential | undefined,
+  diagnostics: DataSourceDiagnostic[],
+): EndpointTestRequestDiagnostic | undefined {
+  const endpointUrl = getGraphQlEndpointUrl(input.dataSource, selection.endpoint);
+
+  if (endpointUrl === undefined || endpointUrl.trim().length === 0) {
+    diagnostics.push(
+      createDiagnostic(input, 'invalid-config', 'GraphQL endpoint requires an endpoint URL.'),
+    );
+    return undefined;
+  }
+
+  const query =
+    getStringMetadataValue(selection.operation.metadata, 'document') ??
+    getStringValue(input.values, 'query');
+
+  if (query === undefined) {
+    diagnostics.push(
+      createDiagnostic(input, 'invalid-config', 'GraphQL operation requires a query document.'),
+    );
+    return undefined;
+  }
+
+  const variables = getRecordValue(input.values, 'variables');
+  const body = JSON.stringify({ query, variables: variables ?? {} });
+  const headers: Record<string, string> = {
+    ...(credential?.headers ?? {}),
+    'content-type': 'application/json',
+  };
+
+  return {
+    dataSourceId: input.dataSource.id,
+    endpointId: input.endpointId,
+    operationId: input.operationId,
+    url: appendQuery(endpointUrl, credential?.query ?? {}),
+    method: 'POST',
+    headers,
+    body,
+    dryRun: input.dryRun === true,
+  };
+}
+
+function getDataSourceBaseUrl(
+  dataSource: DataSourceConfig,
+  endpoint: DataEndpointConfig,
+): string | undefined {
+  if (endpoint.baseUrl !== undefined) return endpoint.baseUrl;
+  if (dataSource.kind === 'rest' || dataSource.kind === 'openapi') return dataSource.baseUrl;
+  if (dataSource.kind === 'graphql') return dataSource.endpointUrl;
+  return undefined;
+}
+
+function getGraphQlEndpointUrl(
+  dataSource: DataSourceConfig,
+  endpoint: DataEndpointConfig,
+): string | undefined {
+  if (endpoint.baseUrl !== undefined) return endpoint.baseUrl;
+  if (dataSource.kind === 'graphql') return dataSource.endpointUrl;
+  return undefined;
+}
+
+function interpolatePath(
+  path: string,
+  parameters: readonly DataOperationParameter[],
+  values: EndpointTestInputValues,
+  input: EndpointTestInput,
+  diagnostics: DataSourceDiagnostic[],
+): string {
+  let nextPath = path;
+  const pathParameters = parameters.filter((parameter) => parameter.location === 'path');
+
+  for (const parameter of pathParameters) {
+    const value = values[parameter.name] ?? parameter.default;
+
+    if (value === undefined) {
+      diagnostics.push(
+        createDiagnostic(
+          input,
+          'invalid-config',
+          `Missing required path parameter '${parameter.name}'.`,
+        ),
+      );
+      continue;
+    }
+
+    const encodedValue = encodeURIComponent(serializeEndpointUrlValue(value));
+    nextPath = nextPath.replaceAll(`{${parameter.name}}`, encodedValue);
+    nextPath = nextPath.replaceAll(`:${parameter.name}`, encodedValue);
+  }
+
+  return nextPath;
+}
+
+function collectQuery(
+  parameters: readonly DataOperationParameter[],
+  values: EndpointTestInputValues,
+  credentialQuery: EndpointTestInputValues | undefined,
+): EndpointTestInputValues {
+  const query: Record<string, DataContractValue> = { ...(credentialQuery ?? {}) };
+
+  for (const parameter of parameters) {
+    if (parameter.location !== 'query') continue;
+
+    const value = values[parameter.name] ?? parameter.default;
+    if (value !== undefined) query[parameter.name] = value;
+  }
+
+  return query;
+}
+
+function createHttpBody(
+  operation: DataOperationConfig,
+  values: EndpointTestInputValues,
+): string | undefined {
+  if (operation.method === 'GET' || operation.method === 'HEAD') return undefined;
+
+  const { body } = values;
+  if (body === undefined) return undefined;
+
+  return JSON.stringify(body);
+}
+
+async function createResponseDiagnostic(
+  response: EndpointTestFetchResponse,
+): Promise<EndpointTestResponseDiagnostic> {
+  const bodyText = await response.text();
+  const parsedBody = parseResponseBody(bodyText);
+
+  return {
+    status: response.status,
+    ok: response.status >= 200 && response.status < 300,
+    headers: response.headers,
+    bodyText,
+    parsedBody,
+  };
+}
+
+function parseResponseBody(bodyText: string): DataContractValue | undefined {
+  if (bodyText.trim().length === 0) return undefined;
+
+  try {
+    const parsed: unknown = JSON.parse(bodyText);
+    return isDataContractValue(parsed) ? parsed : { raw: bodyText };
+  } catch {
+    return { raw: bodyText };
+  }
+}
+
+function appendQuery(url: string, query: EndpointTestInputValues): string {
+  const entries = Object.entries(query);
+  if (entries.length === 0) return url;
+
+  const search = entries
+    .map(
+      ([key, value]) =>
+        `${encodeURIComponent(key)}=${encodeURIComponent(serializeEndpointUrlValue(value))}`,
+    )
+    .join('&');
+  const separator = url.includes('?') ? '&' : '?';
+
+  return `${url}${separator}${search}`;
+}
+
+function serializeEndpointUrlValue(value: DataContractValue): string {
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number' || typeof value === 'boolean') return value.toString();
+  if (value === null) return '';
+
+  return JSON.stringify(value);
+}
+
+function joinUrl(baseUrl: string, path: string): string {
+  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+
+  return `${normalizedBase}${normalizedPath}`;
+}
+
+function getStringValue(
+  values: EndpointTestInputValues | undefined,
+  key: string,
+): string | undefined {
+  const value = values?.[key];
+  return typeof value === 'string' ? value : undefined;
+}
+
+function getRecordValue(
+  values: EndpointTestInputValues | undefined,
+  key: string,
+): DataContractValue | undefined {
+  const value = values?.[key];
+  return isDataContractValue(value) ? value : undefined;
+}
+
+function getStringMetadataValue(
+  metadata: DataContractValue | undefined,
+  key: string,
+): string | undefined {
+  if (!isDataContractRecord(metadata)) return undefined;
+
+  const value = metadata[key];
+  return typeof value === 'string' ? value : undefined;
+}
+
+function createDiagnostic(
+  input: EndpointTestInput,
+  code: string,
+  message: string,
+): DataSourceDiagnostic {
+  return {
+    code,
+    dataSourceId: input.dataSource.id,
+    endpointId: input.endpointId,
+    operationId: input.operationId,
+    message,
+    severity: code === 'missing-schema' ? 'info' : 'error',
+  };
+}
+
+function createNetworkErrorMessage(error: unknown): string {
+  if (error instanceof Error) return error.message;
+  return 'Endpoint test request failed.';
+}
+
+function isDataContractValue(value: unknown): value is DataContractValue {
+  if (
+    value === null ||
+    typeof value === 'string' ||
+    typeof value === 'number' ||
+    typeof value === 'boolean'
+  ) {
+    return true;
+  }
+
+  if (Array.isArray(value)) return value.every(isDataContractValue);
+  if (typeof value !== 'object') return false;
+
+  return Object.values(value).every(isDataContractValue);
+}
+
+function isDataContractRecord(
+  value: DataContractValue | undefined,
+): value is Record<string, DataContractValue> {
+  return (
+    value !== undefined && typeof value === 'object' && value !== null && !Array.isArray(value)
+  );
+}