@ankhorage/data-sources 1.0.0 → 2.0.0

package/dist/rest/index.js

@@ -21,13 +21,13 @@ export function extractRestPathParams(path) {
     }
     return [...params];
 }
-export function validateManualRestDataSource(definition) {
+export function validateManualRestApi(definition) {
     const diagnostics = [];
     if (definition.baseUrl.trim().length === 0) {
         diagnostics.push({
             code: 'invalid-config',
-            dataSourceId: definition.id,
-            message: 'Manual REST data source requires a non-empty baseUrl.',
+            apiId: definition.id,
+            message: 'Manual REST API requires a non-empty baseUrl.',
             path: 'baseUrl',
             severity: 'error',
         });
@@ -36,7 +36,7 @@ export function validateManualRestDataSource(definition) {
         if (!endpoint.path.startsWith('/')) {
             diagnostics.push({
                 code: 'invalid-config',
-                dataSourceId: definition.id,
+                apiId: definition.id,
                 endpointId: endpoint.id,
                 message: 'Manual REST endpoint paths must start with `/`.',
                 path: `endpoints.${endpoint.id}.path`,
@@ -49,57 +49,21 @@ export function validateManualRestDataSource(definition) {
     }
     return diagnostics;
 }
-export function createManualRestDataSource(definition) {
-    const diagnostics = validateManualRestDataSource(definition);
+export function createManualRestApi(definition) {
+    const diagnostics = validateManualRestApi(definition);
     if (diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {
         return { ok: false, diagnostics };
     }
     return {
         ok: true,
-        data: normalizeManualRestDataSource(definition),
+        data: normalizeManualRestApi(definition),
         diagnostics,
     };
 }
-export function normalizeManualRestDataSource(definition) {
-    const endpoints = {};
-    for (const endpoint of definition.endpoints) {
-        const operations = {};
-        for (const operation of endpoint.operations) {
-            const { parameters } = operation;
-            const request = operation.request === undefined && parameters === undefined
-                ? undefined
-                : { ...operation.request, parameters };
-            operations[operation.id] = {
-                id: operation.id,
-                endpointId: endpoint.id,
-                name: operation.name,
-                description: operation.description,
-                protocol: 'http',
-                intent: operation.intent,
-                method: normalizeManualRestMethod(operation.method),
-                path: operation.path ?? endpoint.path,
-                request,
-                response: operation.response,
-                pagination: operation.pagination,
-                credential: operation.credential,
-                metadata: operation.metadata,
-            };
-        }
-        endpoints[endpoint.id] = {
-            id: endpoint.id,
-            kind: 'http',
-            name: endpoint.name,
-            description: endpoint.description,
-            baseUrl: definition.baseUrl,
-            path: endpoint.path,
-            credential: endpoint.credential,
-            operations,
-            metadata: endpoint.metadata,
-        };
-    }
+export function normalizeManualRestApi(definition) {
+    const endpoints = Object.fromEntries(definition.endpoints.map((endpoint) => [endpoint.id, normalizeManualRestEndpoint(endpoint)]));
     return {
         id: definition.id,
-        kind: 'api',
         origin: 'external',
         protocol: 'rest',
         name: definition.name,
@@ -111,6 +75,43 @@ export function normalizeManualRestDataSource(definition) {
         metadata: definition.metadata,
     };
 }
+function normalizeManualRestEndpoint(endpoint) {
+    const operations = Object.fromEntries(endpoint.operations.map((operation) => [
+        operation.id,
+        normalizeManualRestOperation(endpoint, operation),
+    ]));
+    return {
+        id: endpoint.id,
+        kind: 'http',
+        name: endpoint.name,
+        description: endpoint.description,
+        path: endpoint.path,
+        credential: endpoint.credential,
+        operations,
+        metadata: endpoint.metadata,
+    };
+}
+function normalizeManualRestOperation(endpoint, operation) {
+    const { parameters } = operation;
+    const request = operation.request === undefined && parameters === undefined
+        ? undefined
+        : { ...operation.request, parameters };
+    return {
+        id: operation.id,
+        endpointId: endpoint.id,
+        name: operation.name,
+        description: operation.description,
+        protocol: 'http',
+        intent: operation.intent,
+        method: normalizeManualRestMethod(operation.method),
+        path: operation.path ?? endpoint.path,
+        request,
+        response: operation.response,
+        pagination: operation.pagination,
+        credential: operation.credential,
+        metadata: operation.metadata,
+    };
+}
 function validateManualRestOperation(definition, endpoint, operation, diagnostics) {
     const method = normalizeManualRestMethod(operation.method);
     const path = operation.path ?? endpoint.path;
@@ -120,7 +121,7 @@ function validateManualRestOperation(definition, endpoint, operation, diagnostic
     if (!isManualRestMethod(method)) {
         diagnostics.push({
             code: 'invalid-config',
-            dataSourceId: definition.id,
+            apiId: definition.id,
             endpointId: endpoint.id,
             operationId: operation.id,
             message: `Manual REST operation method must be one of ${REST_METHODS.join(', ')}.`,
@@ -133,7 +134,7 @@ function validateManualRestOperation(definition, endpoint, operation, diagnostic
             continue;
         diagnostics.push({
             code: 'invalid-config',
-            dataSourceId: definition.id,
+            apiId: definition.id,
             endpointId: endpoint.id,
             operationId: operation.id,
             message: `Path template parameter '${templateParam}' must have a matching path parameter definition.`,
@@ -146,7 +147,7 @@ function validateManualRestOperation(definition, endpoint, operation, diagnostic
             continue;
         diagnostics.push({
             code: 'invalid-config',
-            dataSourceId: definition.id,
+            apiId: definition.id,
             endpointId: endpoint.id,
             operationId: operation.id,
             message: `Path parameter '${pathParameter.name}' is not referenced by the operation path template.`,

package/dist/rest/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rest/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CredentialRef,\n  DataContractValue,\n  DataEndpointConfig,\n  DataOperationConfig,\n  DataOperationIntent,\n  DataOperationMethod,\n  DataOperationPagination,\n  DataOperationParameter,\n  DataOperationRequest,\n  DataOperationResponse,\n  DataSchemaRegistry,\n  DataSourceDiagnostic,\n  DataSourceDiagnosticResult,\n  EndpointId,\n  ExternalRestApiDataSourceConfig,\n  OperationId,\n} from '@ankhorage/contracts/data';\n\nconst REST_METHODS = ['DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT'] as const;\n\nexport type ManualRestMethod = (typeof REST_METHODS)[number];\n\nexport interface ManualRestOperationDefinition {\n  readonly id: OperationId;\n  readonly intent: DataOperationIntent;\n  readonly method: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly path?: string;\n  readonly credential?: CredentialRef;\n  readonly parameters?: readonly DataOperationParameter[];\n  readonly request?: DataOperationRequest;\n  readonly response?: DataOperationResponse;\n  readonly pagination?: DataOperationPagination;\n  readonly metadata?: DataContractValue;\n}\n\nexport interface ManualRestEndpointDefinition {\n  readonly id: EndpointId;\n  readonly path: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly credential?: CredentialRef;\n  readonly operations: readonly ManualRestOperationDefinition[];\n  readonly metadata?: DataContractValue;\n}\n\nexport interface ManualRestDataSourceDefinition {\n  readonly id: string;\n  readonly baseUrl: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly credential?: CredentialRef;\n  readonly endpoints: readonly ManualRestEndpointDefinition[];\n  readonly schemas?: DataSchemaRegistry;\n  readonly metadata?: DataContractValue;\n}\n\nexport function isManualRestMethod(method: string): method is ManualRestMethod {\n  return REST_METHODS.some((restMethod) => restMethod === method);\n}\n\nexport function normalizeManualRestMethod(method: string): DataOperationMethod {\n  return method.toUpperCase();\n}\n\nexport function extractRestPathParams(path: string): readonly string[] {\n  const params = new Set<string>();\n  const bracedParamPattern = /\\{([A-Za-z_][A-Za-z0-9_]*)\\}/g;\n  const colonParamPattern = /(^|\\/):([A-Za-z_][A-Za-z0-9_]*)/g;\n\n  for (const match of path.matchAll(bracedParamPattern)) {\n    const [, param] = match;\n    if (param !== undefined) params.add(param);\n  }\n\n  for (const match of path.matchAll(colonParamPattern)) {\n    const [, , param] = match;\n    if (param !== undefined) params.add(param);\n  }\n\n  return [...params];\n}\n\nexport function validateManualRestDataSource(\n  definition: ManualRestDataSourceDefinition,\n): readonly DataSourceDiagnostic[] {\n  const diagnostics: DataSourceDiagnostic[] = [];\n\n  if (definition.baseUrl.trim().length === 0) {\n    diagnostics.push({\n      code: 'invalid-config',\n      dataSourceId: definition.id,\n      message: 'Manual REST data source requires a non-empty baseUrl.',\n      path: 'baseUrl',\n      severity: 'error',\n    });\n  }\n\n  for (const endpoint of definition.endpoints) {\n    if (!endpoint.path.startsWith('/')) {\n      diagnostics.push({\n        code: 'invalid-config',\n        dataSourceId: definition.id,\n        endpointId: endpoint.id,\n        message: 'Manual REST endpoint paths must start with `/`.',\n        path: `endpoints.${endpoint.id}.path`,\n        severity: 'error',\n      });\n    }\n\n    for (const operation of endpoint.operations) {\n      validateManualRestOperation(definition, endpoint, operation, diagnostics);\n    }\n  }\n\n  return diagnostics;\n}\n\nexport function createManualRestDataSource(\n  definition: ManualRestDataSourceDefinition,\n): DataSourceDiagnosticResult<ExternalRestApiDataSourceConfig> {\n  const diagnostics = validateManualRestDataSource(definition);\n  if (diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {\n    return { ok: false, diagnostics };\n  }\n\n  return {\n    ok: true,\n    data: normalizeManualRestDataSource(definition),\n    diagnostics,\n  };\n}\n\nexport function normalizeManualRestDataSource(\n  definition: ManualRestDataSourceDefinition,\n): ExternalRestApiDataSourceConfig {\n  const endpoints: Record<EndpointId, DataEndpointConfig> = {};\n\n  for (const endpoint of definition.endpoints) {\n    const operations: Record<OperationId, DataOperationConfig> = {};\n\n    for (const operation of endpoint.operations) {\n      const { parameters } = operation;\n      const request: DataOperationRequest | undefined =\n        operation.request === undefined && parameters === undefined\n          ? undefined\n          : { ...operation.request, parameters };\n\n      operations[operation.id] = {\n        id: operation.id,\n        endpointId: endpoint.id,\n        name: operation.name,\n        description: operation.description,\n        protocol: 'http',\n        intent: operation.intent,\n        method: normalizeManualRestMethod(operation.method),\n        path: operation.path ?? endpoint.path,\n        request,\n        response: operation.response,\n        pagination: operation.pagination,\n        credential: operation.credential,\n        metadata: operation.metadata,\n      };\n    }\n\n    endpoints[endpoint.id] = {\n      id: endpoint.id,\n      kind: 'http',\n      name: endpoint.name,\n      description: endpoint.description,\n      baseUrl: definition.baseUrl,\n      path: endpoint.path,\n      credential: endpoint.credential,\n      operations,\n      metadata: endpoint.metadata,\n    };\n  }\n\n  return {\n    id: definition.id,\n    kind: 'api',\n    origin: 'external',\n    protocol: 'rest',\n    name: definition.name,\n    description: definition.description,\n    baseUrl: definition.baseUrl,\n    credential: definition.credential,\n    endpoints,\n    schemas: definition.schemas,\n    metadata: definition.metadata,\n  };\n}\n\nfunction validateManualRestOperation(\n  definition: ManualRestDataSourceDefinition,\n  endpoint: ManualRestEndpointDefinition,\n  operation: ManualRestOperationDefinition,\n  diagnostics: DataSourceDiagnostic[],\n): void {\n  const method = normalizeManualRestMethod(operation.method);\n  const path = operation.path ?? endpoint.path;\n  const templateParams = extractRestPathParams(path);\n  const pathParameters =\n    operation.parameters?.filter((parameter) => parameter.location === 'path') ?? [];\n  const pathParameterNames = new Set(pathParameters.map((parameter) => parameter.name));\n\n  if (!isManualRestMethod(method)) {\n    diagnostics.push({\n      code: 'invalid-config',\n      dataSourceId: definition.id,\n      endpointId: endpoint.id,\n      operationId: operation.id,\n      message: `Manual REST operation method must be one of ${REST_METHODS.join(', ')}.`,\n      path: `endpoints.${endpoint.id}.operations.${operation.id}.method`,\n      severity: 'error',\n    });\n  }\n\n  for (const templateParam of templateParams) {\n    if (pathParameterNames.has(templateParam)) continue;\n    diagnostics.push({\n      code: 'invalid-config',\n      dataSourceId: definition.id,\n      endpointId: endpoint.id,\n      operationId: operation.id,\n      message: `Path template parameter '${templateParam}' must have a matching path parameter definition.`,\n      path: `endpoints.${endpoint.id}.operations.${operation.id}.parameters`,\n      severity: 'error',\n    });\n  }\n\n  for (const pathParameter of pathParameters) {\n    if (templateParams.includes(pathParameter.name)) continue;\n    diagnostics.push({\n      code: 'invalid-config',\n      dataSourceId: definition.id,\n      endpointId: endpoint.id,\n      operationId: operation.id,\n      message: `Path parameter '${pathParameter.name}' is not referenced by the operation path template.`,\n      path: `endpoints.${endpoint.id}.operations.${operation.id}.parameters.${pathParameter.name}`,\n      severity: 'error',\n    });\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rest/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CredentialRef,\n  DataContractValue,\n  DataEndpointConfig,\n  DataOperationConfig,\n  DataOperationIntent,\n  DataOperationMethod,\n  DataOperationPagination,\n  DataOperationParameter,\n  DataOperationRequest,\n  DataOperationResponse,\n  DataSchemaRegistry,\n  DataSourceDiagnostic,\n  DataSourceDiagnosticResult,\n  EndpointId,\n  ExternalRestApiDefinition,\n  OperationId,\n} from '@ankhorage/contracts/data';\n\nconst REST_METHODS = ['DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT'] as const;\n\nexport type ManualRestMethod = (typeof REST_METHODS)[number];\n\nexport interface ManualRestOperationDefinition {\n  readonly id: OperationId;\n  readonly intent: DataOperationIntent;\n  readonly method: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly path?: string;\n  readonly credential?: CredentialRef;\n  readonly parameters?: readonly DataOperationParameter[];\n  readonly request?: DataOperationRequest;\n  readonly response?: DataOperationResponse;\n  readonly pagination?: DataOperationPagination;\n  readonly metadata?: DataContractValue;\n}\n\nexport interface ManualRestEndpointDefinition {\n  readonly id: EndpointId;\n  readonly path: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly credential?: CredentialRef;\n  readonly operations: readonly ManualRestOperationDefinition[];\n  readonly metadata?: DataContractValue;\n}\n\nexport interface ManualRestApiDefinition {\n  readonly id: string;\n  readonly baseUrl: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly credential?: CredentialRef;\n  readonly endpoints: readonly ManualRestEndpointDefinition[];\n  readonly schemas?: DataSchemaRegistry;\n  readonly metadata?: DataContractValue;\n}\n\nexport function isManualRestMethod(method: string): method is ManualRestMethod {\n  return REST_METHODS.some((restMethod) => restMethod === method);\n}\n\nexport function normalizeManualRestMethod(method: string): DataOperationMethod {\n  return method.toUpperCase();\n}\n\nexport function extractRestPathParams(path: string): readonly string[] {\n  const params = new Set<string>();\n  const bracedParamPattern = /\\{([A-Za-z_][A-Za-z0-9_]*)\\}/g;\n  const colonParamPattern = /(^|\\/):([A-Za-z_][A-Za-z0-9_]*)/g;\n\n  for (const match of path.matchAll(bracedParamPattern)) {\n    const [, param] = match;\n    if (param !== undefined) params.add(param);\n  }\n\n  for (const match of path.matchAll(colonParamPattern)) {\n    const [, , param] = match;\n    if (param !== undefined) params.add(param);\n  }\n\n  return [...params];\n}\n\nexport function validateManualRestApi(\n  definition: ManualRestApiDefinition,\n): readonly DataSourceDiagnostic[] {\n  const diagnostics: DataSourceDiagnostic[] = [];\n\n  if (definition.baseUrl.trim().length === 0) {\n    diagnostics.push({\n      code: 'invalid-config',\n      apiId: definition.id,\n      message: 'Manual REST API requires a non-empty baseUrl.',\n      path: 'baseUrl',\n      severity: 'error',\n    });\n  }\n\n  for (const endpoint of definition.endpoints) {\n    if (!endpoint.path.startsWith('/')) {\n      diagnostics.push({\n        code: 'invalid-config',\n        apiId: definition.id,\n        endpointId: endpoint.id,\n        message: 'Manual REST endpoint paths must start with `/`.',\n        path: `endpoints.${endpoint.id}.path`,\n        severity: 'error',\n      });\n    }\n\n    for (const operation of endpoint.operations) {\n      validateManualRestOperation(definition, endpoint, operation, diagnostics);\n    }\n  }\n\n  return diagnostics;\n}\n\nexport function createManualRestApi(\n  definition: ManualRestApiDefinition,\n): DataSourceDiagnosticResult<ExternalRestApiDefinition> {\n  const diagnostics = validateManualRestApi(definition);\n  if (diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {\n    return { ok: false, diagnostics };\n  }\n\n  return {\n    ok: true,\n    data: normalizeManualRestApi(definition),\n    diagnostics,\n  };\n}\n\nexport function normalizeManualRestApi(\n  definition: ManualRestApiDefinition,\n): ExternalRestApiDefinition {\n  const endpoints = Object.fromEntries(\n    definition.endpoints.map((endpoint) => [endpoint.id, normalizeManualRestEndpoint(endpoint)]),\n  );\n\n  return {\n    id: definition.id,\n    origin: 'external',\n    protocol: 'rest',\n    name: definition.name,\n    description: definition.description,\n    baseUrl: definition.baseUrl,\n    credential: definition.credential,\n    endpoints,\n    schemas: definition.schemas,\n    metadata: definition.metadata,\n  };\n}\n\nfunction normalizeManualRestEndpoint(endpoint: ManualRestEndpointDefinition): DataEndpointConfig {\n  const operations = Object.fromEntries(\n    endpoint.operations.map((operation) => [\n      operation.id,\n      normalizeManualRestOperation(endpoint, operation),\n    ]),\n  );\n  return {\n    id: endpoint.id,\n    kind: 'http',\n    name: endpoint.name,\n    description: endpoint.description,\n    path: endpoint.path,\n    credential: endpoint.credential,\n    operations,\n    metadata: endpoint.metadata,\n  };\n}\n\nfunction normalizeManualRestOperation(\n  endpoint: ManualRestEndpointDefinition,\n  operation: ManualRestOperationDefinition,\n): DataOperationConfig {\n  const { parameters } = operation;\n  const request: DataOperationRequest | undefined =\n    operation.request === undefined && parameters === undefined\n      ? undefined\n      : { ...operation.request, parameters };\n  return {\n    id: operation.id,\n    endpointId: endpoint.id,\n    name: operation.name,\n    description: operation.description,\n    protocol: 'http',\n    intent: operation.intent,\n    method: normalizeManualRestMethod(operation.method),\n    path: operation.path ?? endpoint.path,\n    request,\n    response: operation.response,\n    pagination: operation.pagination,\n    credential: operation.credential,\n    metadata: operation.metadata,\n  };\n}\n\nfunction validateManualRestOperation(\n  definition: ManualRestApiDefinition,\n  endpoint: ManualRestEndpointDefinition,\n  operation: ManualRestOperationDefinition,\n  diagnostics: DataSourceDiagnostic[],\n): void {\n  const method = normalizeManualRestMethod(operation.method);\n  const path = operation.path ?? endpoint.path;\n  const templateParams = extractRestPathParams(path);\n  const pathParameters =\n    operation.parameters?.filter((parameter) => parameter.location === 'path') ?? [];\n  const pathParameterNames = new Set(pathParameters.map((parameter) => parameter.name));\n\n  if (!isManualRestMethod(method)) {\n    diagnostics.push({\n      code: 'invalid-config',\n      apiId: definition.id,\n      endpointId: endpoint.id,\n      operationId: operation.id,\n      message: `Manual REST operation method must be one of ${REST_METHODS.join(', ')}.`,\n      path: `endpoints.${endpoint.id}.operations.${operation.id}.method`,\n      severity: 'error',\n    });\n  }\n\n  for (const templateParam of templateParams) {\n    if (pathParameterNames.has(templateParam)) continue;\n    diagnostics.push({\n      code: 'invalid-config',\n      apiId: definition.id,\n      endpointId: endpoint.id,\n      operationId: operation.id,\n      message: `Path template parameter '${templateParam}' must have a matching path parameter definition.`,\n      path: `endpoints.${endpoint.id}.operations.${operation.id}.parameters`,\n      severity: 'error',\n    });\n  }\n\n  for (const pathParameter of pathParameters) {\n    if (templateParams.includes(pathParameter.name)) continue;\n    diagnostics.push({\n      code: 'invalid-config',\n      apiId: definition.id,\n      endpointId: endpoint.id,\n      operationId: operation.id,\n      message: `Path parameter '${pathParameter.name}' is not referenced by the operation path template.`,\n      path: `endpoints.${endpoint.id}.operations.${operation.id}.parameters.${pathParameter.name}`,\n      severity: 'error',\n    });\n  }\n}\n"]}

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

@@ -1,60 +1,5 @@
-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[];
-};
+import type { EndpointTestInput, EndpointTestResult } from './types';
+export type * from './types';
 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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-runner/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-runner/index.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,mBAAmB,SAAS,CAAC;AAO7B,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4BxF;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA8B7B"}

package/dist/test-runner/index.js

@@ -1,3 +1,6 @@
+import { createResponseDiagnostic } from './response';
+import { createDiagnostic, createNetworkErrorMessage, failure } from './result';
+import { appendQuery, collectHeaders, collectQuery, createHttpBody, getRecordValue, getStringMetadataValue, getStringValue, interpolatePath, joinUrl, } from './serialization';
 export async function testEndpoint(input) {
     const built = await buildEndpointTestRequest(input);
     if (!built.ok || input.dryRun === true)
@@ -14,20 +17,7 @@ export async function testEndpoint(input) {
             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,
-            }
-            : failure(built.request, diagnostics, responseDiagnostic);
+        return createEndpointTestResult(input, built, await createResponseDiagnostic(response));
     }
     catch (error) {
         return failure(built.request, [
@@ -37,34 +27,51 @@ export async function testEndpoint(input) {
     }
 }
 export async function buildEndpointTestRequest(input) {
+    if (input.api.origin === 'internal') {
+        return failure(undefined, [
+            createDiagnostic(input, 'invalid-config', 'Internal APIs are not executable in API phase 1.'),
+        ]);
+    }
     const selection = selectEndpointOperation(input);
     if (selection === undefined) {
         return failure(undefined, [
             createDiagnostic(input, 'missing-operation', 'Endpoint or operation could not be found.'),
         ]);
     }
-    if (selection.operation.protocol === 'database') {
+    if (selection.operation.protocol !== 'http' && selection.operation.protocol !== 'graphql') {
         return failure(undefined, [
-            createDiagnostic(input, 'invalid-config', 'Database-backed generated API operations require an adapter executor and cannot be tested through the HTTP endpoint runner.'),
+            createDiagnostic(input, 'invalid-config', `API operation protocol '${selection.operation.protocol}' is not supported.`),
         ]);
     }
     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);
+    const request = buildProtocolRequest(input, selection, credential, diagnostics);
     if (request === undefined || diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {
         return failure(request, diagnostics);
     }
     return { ok: true, request, diagnostics };
 }
+function createEndpointTestResult(input, built, response) {
+    const diagnostics = [...built.diagnostics];
+    if (!response.ok) {
+        diagnostics.push(createDiagnostic(input, 'http-error', `Endpoint test request returned HTTP status ${response.status}.`));
+        return failure(built.request, diagnostics, response);
+    }
+    return {
+        ok: true,
+        request: built.request,
+        response,
+        data: response.parsedBody,
+        diagnostics,
+    };
+}
 function selectEndpointOperation(input) {
-    const endpoint = input.dataSource.endpoints[input.endpointId];
+    const endpoint = input.api.endpoints[input.endpointId];
     const operation = endpoint?.operations[input.operationId];
     return endpoint === undefined || operation === undefined ? undefined : { endpoint, operation };
 }
 async function resolveEndpointCredential(input, selection, diagnostics) {
-    const ref = selection.operation.credential ?? selection.endpoint.credential ?? input.dataSource.credential;
+    const ref = selection.operation.credential ?? selection.endpoint.credential ?? input.api.credential;
     if (ref === undefined)
         return undefined;
     if (input.credentialResolver === undefined) {
@@ -77,39 +84,49 @@ async function resolveEndpointCredential(input, selection, diagnostics) {
     }
     return credential;
 }
+function buildProtocolRequest(input, selection, credential, diagnostics) {
+    return selection.operation.protocol === 'graphql'
+        ? buildGraphQlRequest(input, selection, credential, diagnostics)
+        : buildHttpRequest(input, selection, credential, diagnostics);
+}
 function buildHttpRequest(input, selection, credential, diagnostics) {
-    const baseUrl = getDataSourceBaseUrl(input.dataSource, selection.endpoint);
+    const baseUrl = getRestBaseUrl(input.api, selection.endpoint);
     const path = selection.operation.path ?? selection.endpoint.path;
-    if (!baseUrl) {
-        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.'));
+    if (baseUrl === undefined || path === undefined) {
+        const message = baseUrl === undefined
+            ? 'HTTP endpoint requires a base URL.'
+            : 'HTTP operation requires a path.';
+        diagnostics.push(createDiagnostic(input, 'invalid-config', message));
         return undefined;
     }
     const values = input.values ?? {};
     const parameters = selection.operation.request?.parameters ?? [];
     const resolvedPath = interpolatePath(path, parameters, values, input, diagnostics);
     const query = collectQuery(parameters, values, credential?.query);
-    const body = createHttpBody(selection.operation, values);
-    const headers = { ...(credential?.headers ?? {}) };
-    if (body !== undefined)
-        headers['content-type'] = headers['content-type'] ?? 'application/json';
+    const headers = collectHeaders(parameters, values, credential?.headers);
+    const body = createHttpBody(selection.operation, parameters, values);
+    const requestHeaders = body === undefined
+        ? headers
+        : {
+            ...headers,
+            'content-type': headers['content-type'] ??
+                selection.operation.request?.contentType ??
+                'application/json',
+        };
     return {
-        dataSourceId: input.dataSource.id,
+        apiId: input.api.id,
         endpointId: input.endpointId,
         operationId: input.operationId,
         url: appendQuery(joinUrl(baseUrl, resolvedPath), query),
         method: selection.operation.method ?? 'GET',
-        headers,
+        headers: requestHeaders,
         body,
         dryRun: input.dryRun === true,
     };
 }
 function buildGraphQlRequest(input, selection, credential, diagnostics) {
-    const endpointUrl = getGraphQlEndpointUrl(input.dataSource, selection.endpoint);
-    if (!endpointUrl) {
+    const endpointUrl = getGraphQlEndpointUrl(input.api, selection.endpoint);
+    if (endpointUrl === undefined) {
         diagnostics.push(createDiagnostic(input, 'invalid-config', 'GraphQL endpoint requires an endpoint URL.'));
         return undefined;
     }
@@ -121,7 +138,7 @@ function buildGraphQlRequest(input, selection, credential, diagnostics) {
     }
     const variables = getRecordValue(input.values, 'variables');
     return {
-        dataSourceId: input.dataSource.id,
+        apiId: input.api.id,
         endpointId: input.endpointId,
         operationId: input.operationId,
         url: appendQuery(endpointUrl, credential?.query ?? {}),
@@ -131,133 +148,14 @@ function buildGraphQlRequest(input, selection, credential, diagnostics) {
         dryRun: input.dryRun === true,
     };
 }
-function getDataSourceBaseUrl(source, endpoint) {
+function getRestBaseUrl(api, endpoint) {
     if (endpoint.baseUrl !== undefined)
         return endpoint.baseUrl;
-    if (source.kind !== 'api' || source.origin !== 'external')
-        return undefined;
-    return source.protocol === 'rest' ? source.baseUrl : source.endpointUrl;
+    return api.origin === 'external' && api.protocol === 'rest' ? api.baseUrl : undefined;
 }
-function getGraphQlEndpointUrl(source, endpoint) {
+function getGraphQlEndpointUrl(api, endpoint) {
     if (endpoint.baseUrl !== undefined)
         return endpoint.baseUrl;
-    return source.kind === 'api' && source.origin === 'external' && source.protocol === 'graphql'
-        ? source.endpointUrl
-        : undefined;
-}
-function interpolatePath(path, parameters, values, input, diagnostics) {
-    let next = path;
-    for (const parameter of parameters.filter((item) => item.location === 'path')) {
-        const value = values[parameter.name] ?? parameter.default;
-        if (value === undefined) {
-            diagnostics.push(createDiagnostic(input, 'invalid-config', `Missing required path parameter '${parameter.name}'.`));
-            continue;
-        }
-        const encoded = encodeURIComponent(serializeEndpointUrlValue(value));
-        next = next
-            .replaceAll(`{${parameter.name}}`, encoded)
-            .replaceAll(`:${parameter.name}`, encoded);
-    }
-    return next;
-}
-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;
-    return values.body === undefined ? undefined : JSON.stringify(values.body);
-}
-async function createResponseDiagnostic(response) {
-    const bodyText = await response.text();
-    return {
-        status: response.status,
-        ok: response.status >= 200 && response.status < 300,
-        headers: response.headers,
-        bodyText,
-        parsedBody: parseResponseBody(bodyText),
-    };
-}
-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('&');
-    return `${url}${url.includes('?') ? '&' : '?'}${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 normalizedBaseUrl = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
-    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
-    return `${normalizedBaseUrl}${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 failure(request, diagnostics, response) {
-    return { ok: false, request, response, diagnostics };
-}
-function createNetworkErrorMessage(error) {
-    return error instanceof Error ? error.message : 'Endpoint test request failed.';
-}
-function isDataContractValue(value) {
-    if (value === null || ['string', 'number', 'boolean'].includes(typeof value))
-        return true;
-    if (Array.isArray(value))
-        return value.every(isDataContractValue);
-    return typeof value === 'object' && Object.values(value).every(isDataContractValue);
-}
-function isDataContractRecord(value) {
-    return (value !== undefined && typeof value === 'object' && value !== null && !Array.isArray(value));
+    return api.origin === 'external' && api.protocol === 'graphql' ? api.endpointUrl : undefined;
 }
 //# sourceMappingURL=index.js.map