@ankhorage/data-sources 0.0.0 → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @ankhorage/data-sources
+
+## 0.1.0
+
+### Minor Changes
+
+- a52311c: Add manual REST data-source definition helpers with normalization and structured diagnostics.
+- 84ddd56: Add dependency-free OpenAPI JSON import helpers that normalize paths, operations, parameters, requests, responses, schemas, and diagnostics into shared Ankhorage data-source contracts.
+- bee5b37: Establish the package baseline, ownership boundaries, shared contracts dependency, and initial smoke-tested public API.

package/README.md

@@ -15,6 +15,10 @@ Provider-neutral data source and endpoint system for APIs, databases, and runtim
 - [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
 - [Module relationships](././paradox/diagrams/module-relationships.mmd)
 - [Export graph](././paradox/diagrams/export-graph.mmd)
+- [createManualRestDataSource sequence](././paradox/diagrams/sequences/create-manual-rest-data-source.mmd)
+- [normalizeManualRestDataSource sequence](././paradox/diagrams/sequences/normalize-manual-rest-data-source.mmd)
+- [normalizeOpenApiSchema sequence](././paradox/diagrams/sequences/normalize-open-api-schema.mmd)
+- [validateManualRestDataSource sequence](././paradox/diagrams/sequences/validate-manual-rest-data-source.mmd)
 
 ## Architecture preview
 
@@ -27,6 +31,10 @@ graph TD
   entrypoint_src_index_ts["src/index.ts"]
   package__ankhorage_data_sources --> entrypoint_src_index_ts
   module_src_index_ts["src/index.ts"]
+  module_src_openapi_index_ts["src/openapi/index.ts"]
+  package__ankhorage_data_sources -.-> module_src_openapi_index_ts
+  module_src_rest_index_ts["src/rest/index.ts"]
+  package__ankhorage_data_sources -.-> module_src_rest_index_ts
 ```
 
 </details>

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import type { DataSourceConfig, DataSourceKind } from '@ankhorage/contracts/data';
+export * from './openapi';
+export * from './rest';
 export declare const DATA_SOURCES_PACKAGE_NAME: "@ankhorage/data-sources";
 export declare const SUPPORTED_DATA_SOURCE_KINDS: readonly ["database", "graphql", "managed-api", "openapi", "rest"];
 export interface DataSourcesPackageInfo {

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,3 +1,5 @@
+export * from './openapi';
+export * from './rest';
 export const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources';
 export const SUPPORTED_DATA_SOURCE_KINDS = [
     'database',

package/dist/index.js.map

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,89 @@
+import type { CredentialRef, DataContractValue, DataSchema, DataSourceDiagnosticResult, EndpointId, OpenApiDataSourceConfig, OperationId } from '@ankhorage/contracts/data';
+declare const OPENAPI_HTTP_METHODS: readonly ["delete", "get", "head", "options", "patch", "post", "put"];
+export type OpenApiHttpMethod = (typeof OPENAPI_HTTP_METHODS)[number];
+export interface OpenApiServerObject {
+    readonly url: string;
+    readonly description?: string;
+}
+export interface OpenApiSchemaObject {
+    readonly $ref?: string;
+    readonly type?: string | readonly string[];
+    readonly title?: string;
+    readonly description?: string;
+    readonly enum?: readonly DataContractValue[];
+    readonly const?: DataContractValue;
+    readonly default?: DataContractValue;
+    readonly format?: string;
+    readonly nullable?: boolean;
+    readonly required?: readonly string[];
+    readonly properties?: Readonly<Record<string, OpenApiSchemaObject>>;
+    readonly additionalProperties?: boolean | OpenApiSchemaObject;
+    readonly items?: OpenApiSchemaObject;
+    readonly allOf?: readonly OpenApiSchemaObject[];
+    readonly anyOf?: readonly OpenApiSchemaObject[];
+    readonly oneOf?: readonly OpenApiSchemaObject[];
+}
+export interface OpenApiMediaTypeObject {
+    readonly schema?: OpenApiSchemaObject;
+}
+export interface OpenApiRequestBodyObject {
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly content?: Readonly<Record<string, OpenApiMediaTypeObject>>;
+}
+export interface OpenApiResponseObject {
+    readonly description?: string;
+    readonly content?: Readonly<Record<string, OpenApiMediaTypeObject>>;
+}
+export interface OpenApiParameterObject {
+    readonly name: string;
+    readonly in: string;
+    readonly required?: boolean;
+    readonly description?: string;
+    readonly schema?: OpenApiSchemaObject;
+}
+export interface OpenApiOperationObject {
+    readonly operationId?: string;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly deprecated?: boolean;
+    readonly parameters?: readonly OpenApiParameterObject[];
+    readonly requestBody?: OpenApiRequestBodyObject;
+    readonly responses?: Readonly<Record<string, OpenApiResponseObject>>;
+}
+export type OpenApiPathItemObject = Partial<Record<OpenApiHttpMethod, OpenApiOperationObject>> & {
+    readonly parameters?: readonly OpenApiParameterObject[];
+};
+export interface OpenApiComponentsObject {
+    readonly schemas?: Readonly<Record<string, OpenApiSchemaObject>>;
+    readonly securitySchemes?: Readonly<Record<string, DataContractValue>>;
+}
+export interface OpenApiDocumentObject {
+    readonly openapi?: string;
+    readonly info?: {
+        readonly title?: string;
+        readonly version?: string;
+        readonly description?: string;
+    };
+    readonly servers?: readonly OpenApiServerObject[];
+    readonly paths?: Readonly<Record<string, OpenApiPathItemObject>>;
+    readonly components?: OpenApiComponentsObject;
+}
+export interface OpenApiImportInput {
+    readonly id: string;
+    readonly document: OpenApiDocumentObject;
+    readonly baseUrl?: string;
+    readonly credential?: CredentialRef;
+    readonly documentId?: string;
+    readonly documentUrl?: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly metadata?: DataContractValue;
+}
+export type OpenApiImportResult = DataSourceDiagnosticResult<OpenApiDataSourceConfig>;
+export declare function importOpenApiDocument(input: OpenApiImportInput): OpenApiImportResult;
+export declare function normalizeOpenApiOperationId(method: OpenApiHttpMethod, path: string, operationId?: string): OperationId;
+export declare function normalizeOpenApiEndpointId(path: string): EndpointId;
+export declare function normalizeOpenApiSchema(schema: OpenApiSchemaObject): DataSchema;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

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"}