Initial Commit

packages/api-stack/api/api-manifest/src/schema/openapi.ts

@@ -0,0 +1,14 @@
+import z from "zod";
+
+/**
+ * OpenAPI contribution block. Requires at least one of `graphql.contributes`
+ * or `routes` to be present — enforced by
+ * `validateOpenApiRequiresGraphqlOrRoutes`.
+ */
+export const openapiSchema = z.object({
+    contributes: z.boolean(),
+    tagDisplayName: z.string().min(1).optional(),
+    externalDocs: z.string().url().optional(),
+});
+
+export type OpenApiBlock = z.infer<typeof openapiSchema>;