@ankhorage/data-sources 0.2.0 → 0.4.0

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":"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","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.2.0",
+  "version": "0.4.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

@@ -1,8 +1,10 @@
 import type { DataSourceConfig, DataSourceKind } from '@ankhorage/contracts/data';
 
 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/managed-api/index.test.ts

@@ -0,0 +1,181 @@
+import { describe, expect, it } from 'bun:test';
+
+import {
+  createManagedApiDataSource,
+  createManagedApiOperationId,
+  createManagedApiResourceSchema,
+  getManagedApiOperations,
+  type ManagedApiGenerationDefinition,
+  normalizeManagedApiDataSource,
+} from './index';
+
+function assertSerializable<TValue>(value: TValue): void {
+  expect(JSON.parse(JSON.stringify(value))).toEqual(value);
+}
+
+function createPostsApiDefinition(): ManagedApiGenerationDefinition {
+  return {
+    id: 'posts-api',
+    name: 'Posts API',
+    adapter: {
+      id: 'primary-db',
+      kind: 'database',
+      packageName: '@ankhorage/supabase-db',
+    },
+    resources: [
+      {
+        name: 'posts',
+        collection: {
+          name: 'posts',
+          schema: 'public',
+          primaryKey: 'id',
+          fields: [
+            { name: 'id', type: 'uuid', required: true, unique: true },
+            { name: 'title', type: 'text', required: true },
+            { name: 'published', type: 'boolean', defaultValue: false },
+            { name: 'createdAt', type: 'datetime' },
+            { name: 'metadata', type: 'json' },
+          ],
+        },
+        policies: [{ id: 'posts-policy' }],
+      },
+    ],
+  };
+}
+
+describe('managed API generation helpers', () => {
+  it('generates deterministic operation IDs', () => {
+    expect(createManagedApiOperationId('posts', 'list')).toBe('posts.list');
+    expect(createManagedApiOperationId('posts', 'delete')).toBe('posts.delete');
+  });
+
+  it('uses all CRUD operations by default', () => {
+    const [resource] = createPostsApiDefinition().resources;
+
+    expect(resource).toBeDefined();
+    if (resource !== undefined) {
+      expect(getManagedApiOperations(resource)).toEqual([
+        'list',
+        'read',
+        'create',
+        'update',
+        'delete',
+      ]);
+    }
+  });
+
+  it('generates a serializable resource schema from a DB collection', () => {
+    const [resource] = createPostsApiDefinition().resources;
+
+    expect(resource).toBeDefined();
+    if (resource !== undefined) {
+      const schema = createManagedApiResourceSchema(resource.collection);
+
+      assertSerializable(schema);
+      expect(schema.type).toBe('object');
+      expect(schema.properties?.id?.format).toBe('uuid');
+      expect(schema.properties?.createdAt?.format).toBe('date-time');
+      expect(schema.properties?.metadata?.type).toBe('object');
+      expect(schema.required).toEqual(['id', 'title']);
+    }
+  });
+
+  it('generates list/read/create/update/delete endpoint configs', () => {
+    const source = normalizeManagedApiDataSource(createPostsApiDefinition());
+
+    assertSerializable(source);
+    expect(source.kind).toBe('managed-api');
+    expect(source.adapter.id).toBe('primary-db');
+    expect(source.endpoints.posts?.kind).toBe('database');
+    expect(source.endpoints.posts?.operations['posts.list']?.intent).toBe('read');
+    expect(source.endpoints.posts?.operations['posts.read']?.intent).toBe('read');
+    expect(source.endpoints.posts?.operations['posts.create']?.intent).toBe('create');
+    expect(source.endpoints.posts?.operations['posts.update']?.intent).toBe('update');
+    expect(source.endpoints.posts?.operations['posts.delete']?.intent).toBe('delete');
+    expect(source.endpoints.posts?.operations['posts.read']?.request?.parameters?.[0]?.name).toBe(
+      'id',
+    );
+    expect(
+      source.endpoints.posts?.operations['posts.list']?.request?.parameters?.map(
+        (parameter) => parameter.name,
+      ),
+    ).toEqual(['limit', 'offset']);
+  });
+
+  it('creates diagnostic result for valid managed APIs', () => {
+    const result = createManagedApiDataSource(createPostsApiDefinition());
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      expect(result.data.resources[0]?.name).toBe('posts');
+      expect(result.diagnostics).toEqual([]);
+    }
+  });
+
+  it('supports multiple managed APIs backed by different adapter refs', () => {
+    const postsApi = normalizeManagedApiDataSource(createPostsApiDefinition());
+    const analyticsApi = normalizeManagedApiDataSource({
+      id: 'analytics-api',
+      adapter: {
+        id: 'analytics-db',
+        kind: 'database',
+        packageName: '@ankhorage/postgres-db',
+      },
+      resources: [
+        {
+          name: 'events',
+          operations: ['list'],
+          collection: {
+            name: 'events',
+            primaryKey: 'id',
+            fields: [
+              { name: 'id', type: 'uuid', required: true, unique: true },
+              { name: 'name', type: 'text', required: true },
+            ],
+          },
+        },
+      ],
+    });
+
+    assertSerializable([postsApi, analyticsApi]);
+    expect(postsApi.id).toBe('posts-api');
+    expect(analyticsApi.id).toBe('analytics-api');
+    expect(postsApi.adapter.id).toBe('primary-db');
+    expect(analyticsApi.adapter.id).toBe('analytics-db');
+    expect(analyticsApi.endpoints.events?.operations['events.list']?.intent).toBe('read');
+    expect(analyticsApi.endpoints.events?.operations['events.read']).toBeUndefined();
+  });
+
+  it('reports missing resources and missing primary key diagnostics', () => {
+    const emptyResult = createManagedApiDataSource({
+      id: 'empty-api',
+      adapter: { id: 'db', kind: 'database' },
+      resources: [],
+    });
+    const missingPrimaryKeyResult = createManagedApiDataSource({
+      id: 'broken-api',
+      adapter: { id: 'db', kind: 'database' },
+      resources: [
+        {
+          name: 'posts',
+          collection: {
+            name: 'posts',
+            fields: [{ name: 'title', type: 'text' }],
+          },
+        },
+      ],
+    });
+
+    expect(emptyResult.ok).toBe(false);
+    if (!emptyResult.ok) {
+      expect(emptyResult.diagnostics.map((diagnostic) => diagnostic.path)).toContain('resources');
+    }
+
+    expect(missingPrimaryKeyResult.ok).toBe(false);
+    if (!missingPrimaryKeyResult.ok) {
+      expect(missingPrimaryKeyResult.diagnostics.map((diagnostic) => diagnostic.path)).toContain(
+        'resources.posts.collection.primaryKey',
+      );
+    }
+  });
+});