import {z} from 'zod' export type AttributeFieldSpec = {name: string, kind: string, required?: boolean | undefined, description?: string | undefined, enum_values?: (Array | null) | undefined, label?: (string | null) | undefined, instant?: boolean | undefined}; export type PatternCase = {pattern: string, value: string}; export type PatternMapRule = {kind?: 'pattern_map' | undefined, source_field?: string | undefined, cases: Array, default?: (string | null) | undefined}; export type EdgeDegreeRule = {kind?: 'edge_degree' | undefined, relationship_type_id: string, node_role?: ('source' | 'target' | 'either') | undefined, minimum?: number | undefined}; export type DerivedPropertyDefInput = {id: string, description?: string | undefined, rule: PatternMapRule | EdgeDegreeRule, label?: (string | null) | undefined}; export type OntologyPackageEntityTypeInput = {type_id: string, display_name: string, description: string, tier: 'representation' | 'domain', attribute_fields?: Array | undefined, derived_properties?: Array | undefined}; export type OntologyPackageRelationshipType = {type_id: string, display_name: string, description: string, source_tier: 'representation' | 'domain', target_tier: 'representation' | 'domain', source_entity_type_ids?: Array | undefined, target_entity_type_ids?: Array | undefined, attribute_fields?: Array | undefined, symmetric?: boolean | undefined}; export type OntologyPackageInput = {slug: string, version: string, display_name?: string | undefined, entity_types?: Array | undefined, relationship_types?: Array | undefined}; export type SourceBindingSpec = {source_kind: string, role: string, field_map?: {[key: string]: string} | undefined}; export type EntityTypeUpsertRequestInput = {type_id: string, display_name: string, description?: string | undefined, tier: 'representation' | 'domain', attribute_fields?: Array | undefined, derived_properties?: Array | undefined, source_bindings?: Array | undefined}; export type RelationshipTypeUpsertRequest = {type_id: string, display_name: string, description?: string | undefined, source_tier: 'representation' | 'domain', target_tier: 'representation' | 'domain', attribute_fields?: Array | undefined, source_bindings?: Array | undefined, symmetric?: boolean | undefined}; export type OntologyDocumentInput = {format?: 'outerport.kg-ontology' | undefined, format_version?: 1 | undefined, collection_name?: string | undefined, packages?: (Array | null) | undefined, entity_types?: Array | undefined, relationship_types?: Array | undefined}; export type CreateApiApiV0KnowledgeBasesKbIdGraphOntologyArgs = {kb_id: string, body: OntologyDocumentInput}; export type CreateApiApiV0KnowledgeBasesKbIdGraphOntologyOptions = {baseUrl: string, HTTPBearer?: string | undefined, fetch?: typeof fetch | undefined}; export const ontologyImportResponse = z.object({packages_added: z.array(z.string()), packages_switched: z.array(z.string()), packages_removed: z.array(z.string()), entity_types_created: z.array(z.string()), entity_types_updated: z.array(z.string()), relationship_types_created: z.array(z.string()), relationship_types_updated: z.array(z.string())}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Apply an ontology JSON to a collection * * POST /api/v0/knowledge-bases/{kb_id}/graph/ontology */ export const createApiApiV0KnowledgeBasesKbIdGraphOntology = async (args: CreateApiApiV0KnowledgeBasesKbIdGraphOntologyArgs, options: CreateApiApiV0KnowledgeBasesKbIdGraphOntologyOptions) => { const {baseUrl, fetch: fetchFn = fetch, HTTPBearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (HTTPBearer !== undefined) headers.set('authorization', `Bearer ${HTTPBearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/api/v0/knowledge-bases/${encodeURIComponent(String(args.kb_id))}/graph/ontology${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(ontologyImportResponse, await res.json()) };