import { JSONSchema } from "../draft_07.ts";
import { SuperSchema } from "../types.ts";
import { OpenAPIV3_1 } from "openapi-types";
import { Extend } from "../../extend.ts";
import SwaggerParser from "@apidevtools/swagger-parser";
export type JsonSchema = JSONSchema;
// After dereferencing, all schemas are objects (no boolean/null)
// Make it recursive so nested properties are also JsonSchemaObject
export type JsonSchemaObject = Omit<
Exclude<JSONSchema, boolean | null>,
"properties" | "additionalProperties" | "items" | "allOf" | "oneOf" | "anyOf"
> & {
properties?: Record<string, JsonSchemaObject>;
additionalProperties?: JsonSchemaObject;
items?: JsonSchemaObject;
allOf?: readonly JsonSchemaObject[];
oneOf?: readonly JsonSchemaObject[];
anyOf?: readonly JsonSchemaObject[];
};
export interface EntraSchema extends SuperSchema {
typeName: string;
description: string;
requiredProperties: Set<string>;
handlers: Record<string, { permissions: string[]; timeoutInMinutes: number }>;
endpoint: string;
}
export type EntraOpenApiDocument = OpenAPIV3_1.Document<
EntraOpenApiOperationExt
>;
export type EntraOpenApiOperation = Extend<
OpenAPIV3_1.OperationObject,
EntraOpenApiOperationExt
>;
interface EntraOpenApiOperationExt {
parameters?: EntraOpenApiParameter[];
requestBody?: EntraOpenApiRequestBody;
responses?: Record<string, EntraOpenApiResponse>;
}
export type EntraOpenApiRequestBody = Extend<
OpenAPIV3_1.RequestBodyObject,
{
content?: Record<string, { schema?: NormalizedEntraSchema }>;
}
>;
export type EntraOpenApiResponse = Extend<
OpenAPIV3_1.ResponseObject,
{
content?: Record<string, { schema?: NormalizedEntraSchema }>;
}
>;
export type EntraOpenApiParameter = Extend<
OpenAPIV3_1.ParameterObject,
{
schema?: NormalizedEntraSchema;
}
>;
export interface OperationData {
endpoint: string;
openApiDescription: {
get?: EntraOpenApiOperation;
post?: EntraOpenApiOperation;
patch?: EntraOpenApiOperation;
delete?: EntraOpenApiOperation;
};
}
export type PropertySet = Set<string>;
export type NormalizedEntraSchema = Extend<
JsonSchemaObject,
{
allOf?: readonly NormalizedEntraSchema[];
oneOf?: readonly NormalizedEntraSchema[];
anyOf?: readonly NormalizedEntraSchema[];
items?: NormalizedEntraSchema;
properties?: Record<string, NormalizedEntraSchema>;
patternProperties?: Record<string, NormalizedEntraSchema>;
additionalProperties?: NormalizedEntraSchema;
}
>;
export async function readEntraOpenApiSpec(
schemaPath: string,
): Promise<EntraOpenApiDocument> {
const fileUrl = new URL(`file://${schemaPath}`);
const spec = (await SwaggerParser.dereference(
fileUrl.href,
)) as EntraOpenApiDocument;
return spec;
}
