import {z} from 'zod' export type LogicalConnectionBindingId = string; export type ConnectorExchangeMode = 'PLATFORM_INITIATED_PULL' | 'PLATFORM_INITIATED_PUSH' | 'EXTERNALLY_INITIATED_READ' | 'EXTERNALLY_INITIATED_WRITE' | 'SUBSCRIPTION_CALLBACK' | 'BIDIRECTIONAL_SYNC'; export type GetApiRouteExposuresArgs = {logicalConnectionBindingId?: LogicalConnectionBindingId | undefined, exchangeMode?: ConnectorExchangeMode | undefined, page?: number | undefined, size?: number | undefined}; export type GetApiRouteExposuresOptions = {baseUrl?: string | undefined, bearer?: string | undefined, fetch?: typeof fetch | undefined}; export const routeExposureDescriptorId = z.string(); export const tenantId = z.string(); export const logicalConnectionBindingId = z.string(); export const connectorExchangeMode = z.enum(["PLATFORM_INITIATED_PULL", "PLATFORM_INITIATED_PUSH", "EXTERNALLY_INITIATED_READ", "EXTERNALLY_INITIATED_WRITE", "SUBSCRIPTION_CALLBACK", "BIDIRECTIONAL_SYNC"]); export const operationKind = z.enum(["READ", "WRITE", "UPDATE", "DELETE", "UPSERT", "QUERY", "SEARCH", "IMPORT", "EXPORT", "INVOKE", "DISCOVER", "VALIDATE"]); export const stringMap = z.record(z.string(), z.string()); export const partyRef = z.object({partyId: z.string().optional(), externalId: z.string().optional(), partyType: z.string().optional(), displayName: z.string().optional(), metadata: stringMap.optional()}); export const relationshipRef = z.object({relationshipId: z.string().optional(), relationshipType: z.string(), fromParty: partyRef, toParty: partyRef}); export const semanticReference = z.object({referenceType: z.string(), referenceId: z.string(), iri: z.string().optional(), version: z.string().optional()}); export const connectorFieldSelector = z.object({canonicalFieldPath: z.string().optional(), connectorField: z.string().optional(), protocolClaimPath: z.string().optional(), dcqlCredentialQueryId: z.string().optional(), dcqlClaimId: z.string().optional(), formFieldPath: z.string().optional(), proofRef: z.string().optional(), statusRef: z.string().optional(), tokenRef: z.string().optional(), sourceFieldPath: z.string().optional(), dataProductFieldScope: z.string().optional(), contractAgreementTargetRef: z.string().optional(), semanticReference: semanticReference.optional(), required: z.boolean().optional()}); export const connectorFieldMapping = z.object({source: connectorFieldSelector, target: connectorFieldSelector, required: z.boolean().optional()}); export const connectorSubsetMapping = z.object({inputFields: z.array(connectorFieldSelector).optional(), selectedFields: z.array(connectorFieldSelector).optional(), producedFields: z.array(connectorFieldSelector).optional(), outputMappings: z.array(connectorFieldMapping).optional(), sourceProvenanceFields: z.array(connectorFieldSelector).optional(), qualityStatusFields: z.array(connectorFieldSelector).optional(), redactionProfileId: z.string().optional(), minimizationProfileId: z.string().optional()}); export const connectorAuditCategory = z.enum(["PROTOCOL_ISSUANCE", "PROTOCOL_VERIFICATION", "FORM", "PORTAL", "WORKFLOW", "DATASPACE", "INDUSTRIAL", "EXTERNAL_EXCHANGE", "VAULT", "SYSTEM_CATALOG"]); export const routeExposureDescriptor = z.object({exposureDescriptorId: routeExposureDescriptorId, exposedCapabilityId: z.string(), owningTenantId: tenantId, organizationUnitId: z.string().optional(), brandId: z.string().optional(), logicalConnectionBindingId: logicalConnectionBindingId, exchangeMode: connectorExchangeMode, allowedOperation: operationKind, acceptedAuthMethods: z.array(z.string()), callerPartyConstraints: z.array(partyRef).optional(), callerRelationshipConstraints: z.array(relationshipRef).optional(), requestSchemaRef: z.string().optional(), responseSchemaRef: z.string().optional(), subsetMapping: connectorSubsetMapping.optional(), cursorStrategy: z.string().optional(), idempotencyKeyStrategy: z.string().optional(), payloadLimitBytes: z.number().int().gte(0).optional(), rateLimitKey: z.string().optional(), auditCategory: connectorAuditCategory.optional()}); export const page = z.object({limit: z.number().int().gte(0), offset: z.number().int().gte(0), page: z.number().int().gte(0), size: z.number().int().gte(0), total: z.number().int().gte(0), totalPages: z.number().int().gte(0), hasMore: z.boolean()}); export const routeExposureDescriptorPage = z.object({data: z.array(routeExposureDescriptor), pagination: page}); 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 }; /** * List route exposure descriptors * * GET /route/exposures */ export const getApiRouteExposures = async (args: GetApiRouteExposuresArgs, options?: GetApiRouteExposuresOptions) => { const {baseUrl = "https://api.example.com/api/connector/v1", fetch: fetchFn = fetch, bearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.logicalConnectionBindingId != null) query.append("logicalConnectionBindingId", String(args.logicalConnectionBindingId)) if (args.exchangeMode != null) query.append("exchangeMode", String(args.exchangeMode)) if (args.page != null) query.append("page", String(args.page)) if (args.size != null) query.append("size", String(args.size)) if (bearer !== undefined) headers.set('authorization', `Bearer ${bearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/route/exposures${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(routeExposureDescriptorPage, await res.json()) };