@ankhorage/data-sources 0.0.0 → 0.2.0

package/dist/openapi/index.js

@@ -0,0 +1,330 @@
+const OPENAPI_HTTP_METHODS = ['delete', 'get', 'head', 'options', 'patch', 'post', 'put'];
+const DATA_SCHEMA_PRIMITIVES = [
+    'array',
+    'boolean',
+    'integer',
+    'null',
+    'number',
+    'object',
+    'string',
+];
+export function importOpenApiDocument(input) {
+    const diagnostics = [];
+    const baseUrl = resolveOpenApiBaseUrl(input, diagnostics);
+    const schemas = normalizeOpenApiSchemas(input.document.components?.schemas, input.id, diagnostics);
+    const endpoints = normalizeOpenApiEndpoints(input, baseUrl, diagnostics);
+    const hasErrors = diagnostics.some((diagnostic) => diagnostic.severity === 'error');
+    if (hasErrors) {
+        return { ok: false, diagnostics };
+    }
+    return {
+        ok: true,
+        data: {
+            id: input.id,
+            kind: 'openapi',
+            name: input.name ?? input.document.info?.title,
+            description: input.description ?? input.document.info?.description,
+            baseUrl,
+            credential: input.credential,
+            endpoints,
+            schemas,
+            import: {
+                url: input.documentUrl,
+                documentId: input.documentId,
+                version: input.document.info?.version,
+            },
+            metadata: input.metadata,
+        },
+        diagnostics,
+    };
+}
+export function normalizeOpenApiOperationId(method, path, operationId) {
+    const rawId = operationId ?? `${method}-${path}`;
+    const normalized = rawId
+        .replace(/\{([^}]+)\}/g, '$1')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+    return normalized.length > 0 ? normalized : `${method}-root`;
+}
+export function normalizeOpenApiEndpointId(path) {
+    const normalized = path
+        .replace(/\{([^}]+)\}/g, '$1')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+    return normalized.length > 0 ? normalized : 'root';
+}
+export function normalizeOpenApiSchema(schema) {
+    const additionalProperties = normalizeAdditionalProperties(schema.additionalProperties);
+    return {
+        ref: normalizeOpenApiSchemaRef(schema.$ref),
+        type: normalizeSchemaType(schema.type),
+        title: schema.title,
+        description: schema.description,
+        enum: schema.enum,
+        const: schema.const,
+        default: schema.default,
+        format: schema.format,
+        nullable: schema.nullable,
+        required: schema.required,
+        properties: normalizeSchemaRecord(schema.properties),
+        additionalProperties,
+        items: schema.items === undefined ? undefined : normalizeOpenApiSchema(schema.items),
+        allOf: normalizeSchemaList(schema.allOf),
+        anyOf: normalizeSchemaList(schema.anyOf),
+        oneOf: normalizeSchemaList(schema.oneOf),
+    };
+}
+function resolveOpenApiBaseUrl(input, diagnostics) {
+    if (input.baseUrl !== undefined)
+        return input.baseUrl;
+    const servers = input.document.servers ?? [];
+    if (servers.length === 0) {
+        diagnostics.push({
+            code: 'ambiguous-server',
+            dataSourceId: input.id,
+            message: 'OpenAPI document does not define a server URL and no baseUrl override was provided.',
+            path: 'servers',
+            severity: 'warning',
+        });
+        return undefined;
+    }
+    if (servers.length > 1) {
+        diagnostics.push({
+            code: 'ambiguous-server',
+            dataSourceId: input.id,
+            message: 'OpenAPI document defines multiple servers. The first server URL was selected.',
+            path: 'servers',
+            severity: 'warning',
+        });
+    }
+    return servers[0]?.url;
+}
+function normalizeOpenApiSchemas(schemas, dataSourceId, diagnostics) {
+    if (schemas === undefined)
+        return undefined;
+    const registry = {};
+    for (const [schemaId, schema] of Object.entries(schemas)) {
+        registry[schemaId] = normalizeOpenApiSchema(schema);
+        collectUnsupportedSchemaDiagnostics(schema, dataSourceId, `components.schemas.${schemaId}`, diagnostics);
+    }
+    return registry;
+}
+function normalizeOpenApiEndpoints(input, baseUrl, diagnostics) {
+    const { paths } = input.document;
+    if (paths === undefined || Object.keys(paths).length === 0) {
+        diagnostics.push({
+            code: 'invalid-config',
+            dataSourceId: input.id,
+            message: 'OpenAPI document must define at least one path.',
+            path: 'paths',
+            severity: 'error',
+        });
+        return {};
+    }
+    const endpoints = {};
+    const operationIds = new Set();
+    for (const [path, pathItem] of Object.entries(paths)) {
+        const endpointId = normalizeOpenApiEndpointId(path);
+        const operations = {};
+        for (const method of OPENAPI_HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (operation === undefined)
+                continue;
+            const operationId = resolveUniqueOperationId(input.id, endpointId, method, path, operation.operationId, operationIds, diagnostics);
+            const parameters = normalizeOpenApiParameters([...(pathItem.parameters ?? []), ...(operation.parameters ?? [])], input.id, endpointId, operationId, diagnostics);
+            const request = normalizeOpenApiRequest(operation.requestBody, parameters);
+            const response = normalizeOpenApiResponse(operation.responses);
+            operations[operationId] = {
+                id: operationId,
+                endpointId,
+                name: operation.summary,
+                description: operation.description,
+                protocol: 'http',
+                intent: mapOpenApiMethodToIntent(method),
+                method: method.toUpperCase(),
+                path,
+                request,
+                response,
+                metadata: {
+                    deprecated: operation.deprecated ?? false,
+                    source: 'openapi',
+                },
+            };
+        }
+        endpoints[endpointId] = {
+            id: endpointId,
+            kind: 'http',
+            baseUrl,
+            path,
+            credential: input.credential,
+            operations,
+        };
+    }
+    return endpoints;
+}
+function resolveUniqueOperationId(dataSourceId, endpointId, method, path, operationId, operationIds, diagnostics) {
+    const normalized = normalizeOpenApiOperationId(method, path, operationId);
+    if (!operationIds.has(normalized)) {
+        operationIds.add(normalized);
+        return normalized;
+    }
+    let suffix = 2;
+    let uniqueId = `${normalized}-${suffix}`;
+    while (operationIds.has(uniqueId)) {
+        suffix += 1;
+        uniqueId = `${normalized}-${suffix}`;
+    }
+    operationIds.add(uniqueId);
+    diagnostics.push({
+        code: 'duplicate-operation-id',
+        dataSourceId,
+        endpointId,
+        operationId: uniqueId,
+        message: `OpenAPI operation id '${normalized}' is duplicated. Normalized to '${uniqueId}'.`,
+        path: `paths.${path}.${method}.operationId`,
+        severity: 'warning',
+    });
+    return uniqueId;
+}
+function normalizeOpenApiParameters(parameters, dataSourceId, endpointId, operationId, diagnostics) {
+    if (parameters.length === 0)
+        return undefined;
+    const normalized = [];
+    for (const parameter of parameters) {
+        const location = normalizeParameterLocation(parameter.in);
+        if (location === undefined) {
+            diagnostics.push({
+                code: 'invalid-config',
+                dataSourceId,
+                endpointId,
+                operationId,
+                message: `OpenAPI parameter '${parameter.name}' uses unsupported location '${parameter.in}'.`,
+                path: `paths.${endpointId}.parameters.${parameter.name}`,
+                severity: 'warning',
+            });
+            continue;
+        }
+        normalized.push({
+            name: parameter.name,
+            location,
+            required: parameter.required,
+            description: parameter.description,
+            schema: parameter.schema === undefined ? undefined : normalizeOpenApiSchema(parameter.schema),
+        });
+    }
+    return normalized;
+}
+function normalizeParameterLocation(location) {
+    if (location === 'cookie' ||
+        location === 'header' ||
+        location === 'path' ||
+        location === 'query') {
+        return location;
+    }
+    return undefined;
+}
+function normalizeOpenApiRequest(requestBody, parameters) {
+    const content = firstContentEntry(requestBody?.content);
+    if (requestBody === undefined && parameters === undefined)
+        return undefined;
+    return {
+        contentType: content?.contentType,
+        parameters,
+        schema: content?.schema === undefined ? undefined : normalizeOpenApiSchema(content.schema),
+    };
+}
+function normalizeOpenApiResponse(responses) {
+    if (responses === undefined)
+        return undefined;
+    const status = chooseResponseStatus(Object.keys(responses));
+    if (status === undefined)
+        return undefined;
+    const response = responses[status];
+    const content = firstContentEntry(response?.content);
+    return {
+        status,
+        contentType: content?.contentType,
+        description: response?.description,
+        schema: content?.schema === undefined ? undefined : normalizeOpenApiSchema(content.schema),
+    };
+}
+function firstContentEntry(content) {
+    if (content === undefined)
+        return undefined;
+    const [entry] = Object.entries(content);
+    if (entry === undefined)
+        return undefined;
+    const [contentType, media] = entry;
+    return { contentType, schema: media.schema };
+}
+function chooseResponseStatus(statuses) {
+    return statuses.find((status) => status.startsWith('2')) ?? statuses[0];
+}
+function mapOpenApiMethodToIntent(method) {
+    if (method === 'get' || method === 'head')
+        return 'read';
+    if (method === 'post')
+        return 'create';
+    if (method === 'delete')
+        return 'delete';
+    if (method === 'patch' || method === 'put')
+        return 'update';
+    return 'action';
+}
+function normalizeOpenApiSchemaRef(ref) {
+    if (ref === undefined)
+        return undefined;
+    const prefix = '#/components/schemas/';
+    if (ref.startsWith(prefix))
+        return { id: ref.slice(prefix.length) };
+    return { id: ref };
+}
+function normalizeSchemaRecord(record) {
+    if (record === undefined)
+        return undefined;
+    const normalized = {};
+    for (const [key, schema] of Object.entries(record)) {
+        normalized[key] = normalizeOpenApiSchema(schema);
+    }
+    return normalized;
+}
+function normalizeSchemaList(list) {
+    return list?.map((schema) => normalizeOpenApiSchema(schema));
+}
+function normalizeAdditionalProperties(additionalProperties) {
+    if (additionalProperties === undefined || typeof additionalProperties === 'boolean') {
+        return additionalProperties;
+    }
+    return normalizeOpenApiSchema(additionalProperties);
+}
+function normalizeSchemaType(type) {
+    if (type === undefined)
+        return undefined;
+    if (typeof type === 'string') {
+        return isDataSchemaPrimitive(type) ? type : undefined;
+    }
+    return type.filter(isDataSchemaPrimitive);
+}
+function isDataSchemaPrimitive(type) {
+    return DATA_SCHEMA_PRIMITIVES.some((primitive) => primitive === type);
+}
+function collectUnsupportedSchemaDiagnostics(schema, dataSourceId, path, diagnostics) {
+    if (typeof schema.type === 'string' && !isDataSchemaPrimitive(schema.type)) {
+        diagnostics.push({
+            code: 'unsupported-schema',
+            dataSourceId,
+            message: `OpenAPI schema type '${schema.type}' is not supported by the normalized schema model.`,
+            path: `${path}.type`,
+            severity: 'warning',
+        });
+    }
+    for (const [propertyName, propertySchema] of Object.entries(schema.properties ?? {})) {
+        collectUnsupportedSchemaDiagnostics(propertySchema, dataSourceId, `${path}.properties.${propertyName}`, diagnostics);
+    }
+    if (schema.items !== undefined) {
+        collectUnsupportedSchemaDiagnostics(schema.items, dataSourceId, `${path}.items`, diagnostics);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CredentialRef,\n  DataContractValue,\n  DataEndpointConfig,\n  DataOperationConfig,\n  DataOperationIntent,\n  DataOperationParameter,\n  DataOperationParameterLocation,\n  DataOperationRequest,\n  DataOperationResponse,\n  DataSchema,\n  DataSchemaPrimitiveType,\n  DataSchemaRegistry,\n  DataSourceDiagnostic,\n  DataSourceDiagnosticResult,\n  EndpointId,\n  OpenApiDataSourceConfig,\n  OperationId,\n} from '@ankhorage/contracts/data';\n\nconst OPENAPI_HTTP_METHODS = ['delete', 'get', 'head', 'options', 'patch', 'post', 'put'] as const;\nconst DATA_SCHEMA_PRIMITIVES = [\n  'array',\n  'boolean',\n  'integer',\n  'null',\n  'number',\n  'object',\n  'string',\n] as const satisfies readonly DataSchemaPrimitiveType[];\n\nexport type OpenApiHttpMethod = (typeof OPENAPI_HTTP_METHODS)[number];\n\nexport interface OpenApiServerObject {\n  readonly url: string;\n  readonly description?: string;\n}\n\nexport interface OpenApiSchemaObject {\n  readonly $ref?: string;\n  readonly type?: string | readonly string[];\n  readonly title?: string;\n  readonly description?: string;\n  readonly enum?: readonly DataContractValue[];\n  readonly const?: DataContractValue;\n  readonly default?: DataContractValue;\n  readonly format?: string;\n  readonly nullable?: boolean;\n  readonly required?: readonly string[];\n  readonly properties?: Readonly<Record<string, OpenApiSchemaObject>>;\n  readonly additionalProperties?: boolean | OpenApiSchemaObject;\n  readonly items?: OpenApiSchemaObject;\n  readonly allOf?: readonly OpenApiSchemaObject[];\n  readonly anyOf?: readonly OpenApiSchemaObject[];\n  readonly oneOf?: readonly OpenApiSchemaObject[];\n}\n\nexport interface OpenApiMediaTypeObject {\n  readonly schema?: OpenApiSchemaObject;\n}\n\nexport interface OpenApiRequestBodyObject {\n  readonly description?: string;\n  readonly required?: boolean;\n  readonly content?: Readonly<Record<string, OpenApiMediaTypeObject>>;\n}\n\nexport interface OpenApiResponseObject {\n  readonly description?: string;\n  readonly content?: Readonly<Record<string, OpenApiMediaTypeObject>>;\n}\n\nexport interface OpenApiParameterObject {\n  readonly name: string;\n  readonly in: string;\n  readonly required?: boolean;\n  readonly description?: string;\n  readonly schema?: OpenApiSchemaObject;\n}\n\nexport interface OpenApiOperationObject {\n  readonly operationId?: string;\n  readonly summary?: string;\n  readonly description?: string;\n  readonly deprecated?: boolean;\n  readonly parameters?: readonly OpenApiParameterObject[];\n  readonly requestBody?: OpenApiRequestBodyObject;\n  readonly responses?: Readonly<Record<string, OpenApiResponseObject>>;\n}\n\nexport type OpenApiPathItemObject = Partial<Record<OpenApiHttpMethod, OpenApiOperationObject>> & {\n  readonly parameters?: readonly OpenApiParameterObject[];\n};\n\nexport interface OpenApiComponentsObject {\n  readonly schemas?: Readonly<Record<string, OpenApiSchemaObject>>;\n  readonly securitySchemes?: Readonly<Record<string, DataContractValue>>;\n}\n\nexport interface OpenApiDocumentObject {\n  readonly openapi?: string;\n  readonly info?: {\n    readonly title?: string;\n    readonly version?: string;\n    readonly description?: string;\n  };\n  readonly servers?: readonly OpenApiServerObject[];\n  readonly paths?: Readonly<Record<string, OpenApiPathItemObject>>;\n  readonly components?: OpenApiComponentsObject;\n}\n\nexport interface OpenApiImportInput {\n  readonly id: string;\n  readonly document: OpenApiDocumentObject;\n  readonly baseUrl?: string;\n  readonly credential?: CredentialRef;\n  readonly documentId?: string;\n  readonly documentUrl?: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly metadata?: DataContractValue;\n}\n\nexport type OpenApiImportResult = DataSourceDiagnosticResult<OpenApiDataSourceConfig>;\n\nexport function importOpenApiDocument(input: OpenApiImportInput): OpenApiImportResult {\n  const diagnostics: DataSourceDiagnostic[] = [];\n  const baseUrl = resolveOpenApiBaseUrl(input, diagnostics);\n  const schemas = normalizeOpenApiSchemas(\n    input.document.components?.schemas,\n    input.id,\n    diagnostics,\n  );\n  const endpoints = normalizeOpenApiEndpoints(input, baseUrl, diagnostics);\n  const hasErrors = diagnostics.some((diagnostic) => diagnostic.severity === 'error');\n\n  if (hasErrors) {\n    return { ok: false, diagnostics };\n  }\n\n  return {\n    ok: true,\n    data: {\n      id: input.id,\n      kind: 'openapi',\n      name: input.name ?? input.document.info?.title,\n      description: input.description ?? input.document.info?.description,\n      baseUrl,\n      credential: input.credential,\n      endpoints,\n      schemas,\n      import: {\n        url: input.documentUrl,\n        documentId: input.documentId,\n        version: input.document.info?.version,\n      },\n      metadata: input.metadata,\n    },\n    diagnostics,\n  };\n}\n\nexport function normalizeOpenApiOperationId(\n  method: OpenApiHttpMethod,\n  path: string,\n  operationId?: string,\n): OperationId {\n  const rawId = operationId ?? `${method}-${path}`;\n  const normalized = rawId\n    .replace(/\\{([^}]+)\\}/g, '$1')\n    .replace(/[^A-Za-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .toLowerCase();\n\n  return normalized.length > 0 ? normalized : `${method}-root`;\n}\n\nexport function normalizeOpenApiEndpointId(path: string): EndpointId {\n  const normalized = path\n    .replace(/\\{([^}]+)\\}/g, '$1')\n    .replace(/[^A-Za-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .toLowerCase();\n\n  return normalized.length > 0 ? normalized : 'root';\n}\n\nexport function normalizeOpenApiSchema(schema: OpenApiSchemaObject): DataSchema {\n  const additionalProperties = normalizeAdditionalProperties(schema.additionalProperties);\n\n  return {\n    ref: normalizeOpenApiSchemaRef(schema.$ref),\n    type: normalizeSchemaType(schema.type),\n    title: schema.title,\n    description: schema.description,\n    enum: schema.enum,\n    const: schema.const,\n    default: schema.default,\n    format: schema.format,\n    nullable: schema.nullable,\n    required: schema.required,\n    properties: normalizeSchemaRecord(schema.properties),\n    additionalProperties,\n    items: schema.items === undefined ? undefined : normalizeOpenApiSchema(schema.items),\n    allOf: normalizeSchemaList(schema.allOf),\n    anyOf: normalizeSchemaList(schema.anyOf),\n    oneOf: normalizeSchemaList(schema.oneOf),\n  };\n}\n\nfunction resolveOpenApiBaseUrl(\n  input: OpenApiImportInput,\n  diagnostics: DataSourceDiagnostic[],\n): string | undefined {\n  if (input.baseUrl !== undefined) return input.baseUrl;\n\n  const servers = input.document.servers ?? [];\n\n  if (servers.length === 0) {\n    diagnostics.push({\n      code: 'ambiguous-server',\n      dataSourceId: input.id,\n      message:\n        'OpenAPI document does not define a server URL and no baseUrl override was provided.',\n      path: 'servers',\n      severity: 'warning',\n    });\n    return undefined;\n  }\n\n  if (servers.length > 1) {\n    diagnostics.push({\n      code: 'ambiguous-server',\n      dataSourceId: input.id,\n      message: 'OpenAPI document defines multiple servers. The first server URL was selected.',\n      path: 'servers',\n      severity: 'warning',\n    });\n  }\n\n  return servers[0]?.url;\n}\n\nfunction normalizeOpenApiSchemas(\n  schemas: Readonly<Record<string, OpenApiSchemaObject>> | undefined,\n  dataSourceId: string,\n  diagnostics: DataSourceDiagnostic[],\n): DataSchemaRegistry | undefined {\n  if (schemas === undefined) return undefined;\n\n  const registry: Record<string, DataSchema> = {};\n\n  for (const [schemaId, schema] of Object.entries(schemas)) {\n    registry[schemaId] = normalizeOpenApiSchema(schema);\n    collectUnsupportedSchemaDiagnostics(\n      schema,\n      dataSourceId,\n      `components.schemas.${schemaId}`,\n      diagnostics,\n    );\n  }\n\n  return registry;\n}\n\nfunction normalizeOpenApiEndpoints(\n  input: OpenApiImportInput,\n  baseUrl: string | undefined,\n  diagnostics: DataSourceDiagnostic[],\n): Record<EndpointId, DataEndpointConfig> {\n  const { paths } = input.document;\n\n  if (paths === undefined || Object.keys(paths).length === 0) {\n    diagnostics.push({\n      code: 'invalid-config',\n      dataSourceId: input.id,\n      message: 'OpenAPI document must define at least one path.',\n      path: 'paths',\n      severity: 'error',\n    });\n    return {};\n  }\n\n  const endpoints: Record<EndpointId, DataEndpointConfig> = {};\n  const operationIds = new Set<OperationId>();\n\n  for (const [path, pathItem] of Object.entries(paths)) {\n    const endpointId = normalizeOpenApiEndpointId(path);\n    const operations: Record<OperationId, DataOperationConfig> = {};\n\n    for (const method of OPENAPI_HTTP_METHODS) {\n      const operation = pathItem[method];\n      if (operation === undefined) continue;\n\n      const operationId = resolveUniqueOperationId(\n        input.id,\n        endpointId,\n        method,\n        path,\n        operation.operationId,\n        operationIds,\n        diagnostics,\n      );\n      const parameters = normalizeOpenApiParameters(\n        [...(pathItem.parameters ?? []), ...(operation.parameters ?? [])],\n        input.id,\n        endpointId,\n        operationId,\n        diagnostics,\n      );\n      const request = normalizeOpenApiRequest(operation.requestBody, parameters);\n      const response = normalizeOpenApiResponse(operation.responses);\n\n      operations[operationId] = {\n        id: operationId,\n        endpointId,\n        name: operation.summary,\n        description: operation.description,\n        protocol: 'http',\n        intent: mapOpenApiMethodToIntent(method),\n        method: method.toUpperCase(),\n        path,\n        request,\n        response,\n        metadata: {\n          deprecated: operation.deprecated ?? false,\n          source: 'openapi',\n        },\n      };\n    }\n\n    endpoints[endpointId] = {\n      id: endpointId,\n      kind: 'http',\n      baseUrl,\n      path,\n      credential: input.credential,\n      operations,\n    };\n  }\n\n  return endpoints;\n}\n\nfunction resolveUniqueOperationId(\n  dataSourceId: string,\n  endpointId: EndpointId,\n  method: OpenApiHttpMethod,\n  path: string,\n  operationId: string | undefined,\n  operationIds: Set<OperationId>,\n  diagnostics: DataSourceDiagnostic[],\n): OperationId {\n  const normalized = normalizeOpenApiOperationId(method, path, operationId);\n\n  if (!operationIds.has(normalized)) {\n    operationIds.add(normalized);\n    return normalized;\n  }\n\n  let suffix = 2;\n  let uniqueId: OperationId = `${normalized}-${suffix}`;\n\n  while (operationIds.has(uniqueId)) {\n    suffix += 1;\n    uniqueId = `${normalized}-${suffix}`;\n  }\n\n  operationIds.add(uniqueId);\n  diagnostics.push({\n    code: 'duplicate-operation-id',\n    dataSourceId,\n    endpointId,\n    operationId: uniqueId,\n    message: `OpenAPI operation id '${normalized}' is duplicated. Normalized to '${uniqueId}'.`,\n    path: `paths.${path}.${method}.operationId`,\n    severity: 'warning',\n  });\n\n  return uniqueId;\n}\n\nfunction normalizeOpenApiParameters(\n  parameters: readonly OpenApiParameterObject[],\n  dataSourceId: string,\n  endpointId: EndpointId,\n  operationId: OperationId,\n  diagnostics: DataSourceDiagnostic[],\n): readonly DataOperationParameter[] | undefined {\n  if (parameters.length === 0) return undefined;\n\n  const normalized: DataOperationParameter[] = [];\n\n  for (const parameter of parameters) {\n    const location = normalizeParameterLocation(parameter.in);\n\n    if (location === undefined) {\n      diagnostics.push({\n        code: 'invalid-config',\n        dataSourceId,\n        endpointId,\n        operationId,\n        message: `OpenAPI parameter '${parameter.name}' uses unsupported location '${parameter.in}'.`,\n        path: `paths.${endpointId}.parameters.${parameter.name}`,\n        severity: 'warning',\n      });\n      continue;\n    }\n\n    normalized.push({\n      name: parameter.name,\n      location,\n      required: parameter.required,\n      description: parameter.description,\n      schema: parameter.schema === undefined ? undefined : normalizeOpenApiSchema(parameter.schema),\n    });\n  }\n\n  return normalized;\n}\n\nfunction normalizeParameterLocation(location: string): DataOperationParameterLocation | undefined {\n  if (\n    location === 'cookie' ||\n    location === 'header' ||\n    location === 'path' ||\n    location === 'query'\n  ) {\n    return location;\n  }\n\n  return undefined;\n}\n\nfunction normalizeOpenApiRequest(\n  requestBody: OpenApiRequestBodyObject | undefined,\n  parameters: readonly DataOperationParameter[] | undefined,\n): DataOperationRequest | undefined {\n  const content = firstContentEntry(requestBody?.content);\n\n  if (requestBody === undefined && parameters === undefined) return undefined;\n\n  return {\n    contentType: content?.contentType,\n    parameters,\n    schema: content?.schema === undefined ? undefined : normalizeOpenApiSchema(content.schema),\n  };\n}\n\nfunction normalizeOpenApiResponse(\n  responses: Readonly<Record<string, OpenApiResponseObject>> | undefined,\n): DataOperationResponse | undefined {\n  if (responses === undefined) return undefined;\n\n  const status = chooseResponseStatus(Object.keys(responses));\n  if (status === undefined) return undefined;\n\n  const response = responses[status];\n  const content = firstContentEntry(response?.content);\n\n  return {\n    status,\n    contentType: content?.contentType,\n    description: response?.description,\n    schema: content?.schema === undefined ? undefined : normalizeOpenApiSchema(content.schema),\n  };\n}\n\nfunction firstContentEntry(\n  content: Readonly<Record<string, OpenApiMediaTypeObject>> | undefined,\n): { readonly contentType: string; readonly schema?: OpenApiSchemaObject } | undefined {\n  if (content === undefined) return undefined;\n\n  const [entry] = Object.entries(content);\n  if (entry === undefined) return undefined;\n\n  const [contentType, media] = entry;\n  return { contentType, schema: media.schema };\n}\n\nfunction chooseResponseStatus(statuses: readonly string[]): string | undefined {\n  return statuses.find((status) => status.startsWith('2')) ?? statuses[0];\n}\n\nfunction mapOpenApiMethodToIntent(method: OpenApiHttpMethod): DataOperationIntent {\n  if (method === 'get' || method === 'head') return 'read';\n  if (method === 'post') return 'create';\n  if (method === 'delete') return 'delete';\n  if (method === 'patch' || method === 'put') return 'update';\n  return 'action';\n}\n\nfunction normalizeOpenApiSchemaRef(ref: string | undefined): { readonly id: string } | undefined {\n  if (ref === undefined) return undefined;\n\n  const prefix = '#/components/schemas/';\n  if (ref.startsWith(prefix)) return { id: ref.slice(prefix.length) };\n\n  return { id: ref };\n}\n\nfunction normalizeSchemaRecord(\n  record: Readonly<Record<string, OpenApiSchemaObject>> | undefined,\n): Readonly<Record<string, DataSchema>> | undefined {\n  if (record === undefined) return undefined;\n\n  const normalized: Record<string, DataSchema> = {};\n\n  for (const [key, schema] of Object.entries(record)) {\n    normalized[key] = normalizeOpenApiSchema(schema);\n  }\n\n  return normalized;\n}\n\nfunction normalizeSchemaList(\n  list: readonly OpenApiSchemaObject[] | undefined,\n): readonly DataSchema[] | undefined {\n  return list?.map((schema) => normalizeOpenApiSchema(schema));\n}\n\nfunction normalizeAdditionalProperties(\n  additionalProperties: boolean | OpenApiSchemaObject | undefined,\n): boolean | DataSchema | undefined {\n  if (additionalProperties === undefined || typeof additionalProperties === 'boolean') {\n    return additionalProperties;\n  }\n\n  return normalizeOpenApiSchema(additionalProperties);\n}\n\nfunction normalizeSchemaType(\n  type: string | readonly string[] | undefined,\n): DataSchemaPrimitiveType | readonly DataSchemaPrimitiveType[] | undefined {\n  if (type === undefined) return undefined;\n\n  if (typeof type === 'string') {\n    return isDataSchemaPrimitive(type) ? type : undefined;\n  }\n\n  return type.filter(isDataSchemaPrimitive);\n}\n\nfunction isDataSchemaPrimitive(type: string): type is DataSchemaPrimitiveType {\n  return DATA_SCHEMA_PRIMITIVES.some((primitive) => primitive === type);\n}\n\nfunction collectUnsupportedSchemaDiagnostics(\n  schema: OpenApiSchemaObject,\n  dataSourceId: string,\n  path: string,\n  diagnostics: DataSourceDiagnostic[],\n): void {\n  if (typeof schema.type === 'string' && !isDataSchemaPrimitive(schema.type)) {\n    diagnostics.push({\n      code: 'unsupported-schema',\n      dataSourceId,\n      message: `OpenAPI schema type '${schema.type}' is not supported by the normalized schema model.`,\n      path: `${path}.type`,\n      severity: 'warning',\n    });\n  }\n\n  for (const [propertyName, propertySchema] of Object.entries(schema.properties ?? {})) {\n    collectUnsupportedSchemaDiagnostics(\n      propertySchema,\n      dataSourceId,\n      `${path}.properties.${propertyName}`,\n      diagnostics,\n    );\n  }\n\n  if (schema.items !== undefined) {\n    collectUnsupportedSchemaDiagnostics(schema.items, dataSourceId, `${path}.items`, diagnostics);\n  }\n}\n"]}

package/dist/rest/index.d.ts

@@ -0,0 +1,44 @@
+import type { CredentialRef, DataContractValue, DataOperationIntent, DataOperationMethod, DataOperationPagination, DataOperationParameter, DataOperationRequest, DataOperationResponse, DataSchemaRegistry, DataSourceDiagnostic, DataSourceDiagnosticResult, EndpointId, OperationId, RestDataSourceConfig } from '@ankhorage/contracts/data';
+declare const REST_METHODS: readonly ["DELETE", "GET", "HEAD", "OPTIONS", "PATCH", "POST", "PUT"];
+export type ManualRestMethod = (typeof REST_METHODS)[number];
+export interface ManualRestOperationDefinition {
+    readonly id: OperationId;
+    readonly intent: DataOperationIntent;
+    readonly method: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly path?: string;
+    readonly credential?: CredentialRef;
+    readonly parameters?: readonly DataOperationParameter[];
+    readonly request?: DataOperationRequest;
+    readonly response?: DataOperationResponse;
+    readonly pagination?: DataOperationPagination;
+    readonly metadata?: DataContractValue;
+}
+export interface ManualRestEndpointDefinition {
+    readonly id: EndpointId;
+    readonly path: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly credential?: CredentialRef;
+    readonly operations: readonly ManualRestOperationDefinition[];
+    readonly metadata?: DataContractValue;
+}
+export interface ManualRestDataSourceDefinition {
+    readonly id: string;
+    readonly baseUrl: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly credential?: CredentialRef;
+    readonly endpoints: readonly ManualRestEndpointDefinition[];
+    readonly schemas?: DataSchemaRegistry;
+    readonly metadata?: DataContractValue;
+}
+export declare function isManualRestMethod(method: string): method is ManualRestMethod;
+export declare function normalizeManualRestMethod(method: string): DataOperationMethod;
+export declare function extractRestPathParams(path: string): readonly string[];
+export declare function validateManualRestDataSource(definition: ManualRestDataSourceDefinition): readonly DataSourceDiagnostic[];
+export declare function createManualRestDataSource(definition: ManualRestDataSourceDefinition): DataSourceDiagnosticResult<RestDataSourceConfig>;
+export declare function normalizeManualRestDataSource(definition: ManualRestDataSourceDefinition): RestDataSourceConfig;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/rest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rest/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAGjB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,UAAU,EACV,WAAW,EACX,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAEnC,QAAA,MAAM,YAAY,uEAAwE,CAAC;AAE3F,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,gBAAgB,CAE7E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAE7E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAgBrE;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,8BAA8B,GACzC,SAAS,oBAAoB,EAAE,CA4EjC;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,8BAA8B,GACzC,0BAA0B,CAAC,oBAAoB,CAAC,CAalD;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,8BAA8B,GACzC,oBAAoB,CA0DtB"}

package/dist/rest/index.js

@@ -0,0 +1,158 @@
+const REST_METHODS = ['DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT'];
+export function isManualRestMethod(method) {
+    return REST_METHODS.some((restMethod) => restMethod === method);
+}
+export function normalizeManualRestMethod(method) {
+    return method.toUpperCase();
+}
+export function extractRestPathParams(path) {
+    const params = new Set();
+    const bracedParamPattern = /\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+    const colonParamPattern = /(^|\/):([A-Za-z_][A-Za-z0-9_]*)/g;
+    for (const match of path.matchAll(bracedParamPattern)) {
+        const [, param] = match;
+        if (param !== undefined)
+            params.add(param);
+    }
+    for (const match of path.matchAll(colonParamPattern)) {
+        const [, , param] = match;
+        if (param !== undefined)
+            params.add(param);
+    }
+    return [...params];
+}
+export function validateManualRestDataSource(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.',
+            path: 'baseUrl',
+            severity: 'error',
+        });
+    }
+    for (const endpoint of definition.endpoints) {
+        if (!endpoint.path.startsWith('/')) {
+            diagnostics.push({
+                code: 'invalid-config',
+                dataSourceId: definition.id,
+                endpointId: endpoint.id,
+                message: 'Manual REST endpoint paths must start with `/`.',
+                path: `endpoints.${endpoint.id}.path`,
+                severity: 'error',
+            });
+        }
+        for (const operation of endpoint.operations) {
+            const normalizedMethod = normalizeManualRestMethod(operation.method);
+            const operationPath = operation.path ?? endpoint.path;
+            const templateParams = extractRestPathParams(operationPath);
+            const pathParameters = operation.parameters?.filter((parameter) => parameter.location === 'path') ?? [];
+            const pathParameterNames = new Set(pathParameters.map((parameter) => parameter.name));
+            if (!isManualRestMethod(normalizedMethod)) {
+                diagnostics.push({
+                    code: 'invalid-config',
+                    dataSourceId: definition.id,
+                    endpointId: endpoint.id,
+                    operationId: operation.id,
+                    message: `Manual REST operation method must be one of ${REST_METHODS.join(', ')}.`,
+                    path: `endpoints.${endpoint.id}.operations.${operation.id}.method`,
+                    severity: 'error',
+                });
+            }
+            for (const templateParam of templateParams) {
+                if (!pathParameterNames.has(templateParam)) {
+                    diagnostics.push({
+                        code: 'invalid-config',
+                        dataSourceId: definition.id,
+                        endpointId: endpoint.id,
+                        operationId: operation.id,
+                        message: `Path template parameter '${templateParam}' must have a matching path parameter definition.`,
+                        path: `endpoints.${endpoint.id}.operations.${operation.id}.parameters`,
+                        severity: 'error',
+                    });
+                }
+            }
+            for (const pathParameter of pathParameters) {
+                if (!templateParams.includes(pathParameter.name)) {
+                    diagnostics.push({
+                        code: 'invalid-config',
+                        dataSourceId: definition.id,
+                        endpointId: endpoint.id,
+                        operationId: operation.id,
+                        message: `Path parameter '${pathParameter.name}' is not referenced by the operation path template.`,
+                        path: `endpoints.${endpoint.id}.operations.${operation.id}.parameters.${pathParameter.name}`,
+                        severity: 'error',
+                    });
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+export function createManualRestDataSource(definition) {
+    const diagnostics = validateManualRestDataSource(definition);
+    const hasErrors = diagnostics.some((diagnostic) => diagnostic.severity === 'error');
+    if (hasErrors) {
+        return { ok: false, diagnostics };
+    }
+    return {
+        ok: true,
+        data: normalizeManualRestDataSource(definition),
+        diagnostics,
+    };
+}
+export function normalizeManualRestDataSource(definition) {
+    const endpoints = {};
+    for (const endpoint of definition.endpoints) {
+        const operations = {};
+        for (const operation of endpoint.operations) {
+            const operationPath = operation.path ?? endpoint.path;
+            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: operationPath,
+                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,
+        };
+    }
+    return {
+        id: definition.id,
+        kind: 'rest',
+        name: definition.name,
+        description: definition.description,
+        baseUrl: definition.baseUrl,
+        credential: definition.credential,
+        endpoints,
+        schemas: definition.schemas,
+        metadata: definition.metadata,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/rest/index.js.map

@@ -0,0 +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  OperationId,\n  RestDataSourceConfig,\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      const normalizedMethod = normalizeManualRestMethod(operation.method);\n      const operationPath = operation.path ?? endpoint.path;\n      const templateParams = extractRestPathParams(operationPath);\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(normalizedMethod)) {\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)) {\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\n      for (const pathParameter of pathParameters) {\n        if (!templateParams.includes(pathParameter.name)) {\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    }\n  }\n\n  return diagnostics;\n}\n\nexport function createManualRestDataSource(\n  definition: ManualRestDataSourceDefinition,\n): DataSourceDiagnosticResult<RestDataSourceConfig> {\n  const diagnostics = validateManualRestDataSource(definition);\n  const hasErrors = diagnostics.some((diagnostic) => diagnostic.severity === 'error');\n\n  if (hasErrors) {\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): RestDataSourceConfig {\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 operationPath = operation.path ?? endpoint.path;\n      const { parameters } = operation;\n      const request: DataOperationRequest | undefined =\n        operation.request === undefined && parameters === undefined\n          ? undefined\n          : {\n              ...operation.request,\n              parameters,\n            };\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: operationPath,\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: '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"]}

package/package.json

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