Add integration tests for JSON Schema vocabulary, tags, and webhooks

- Implement JSON Schema Vocabulary Integration tests to validate support for JSON Schema 2020-12 features in the API specification.
- Create comprehensive tests for OpenAPI tag management, including adding, updating, and removing tags, as well as handling external documentation.
- Develop webhook integration tests to ensure proper functionality of webhooks in the OpenAPI document, including adding, updating, and removing webhooks, as well as testing webhook operations and serialization.

Author: GroophyLifefor

deno.json

@@ -1,7 +1,7 @@
 {
   "name": "@murat/openapi",
   "exports": "./mod.ts",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "tasks": {
     "lint": "deno lint",
     "test": "deno test --allow-all",

deno.lock

@@ -8,8 +8,11 @@ developer-friendly way to define OpenAPI specifications for your APIs.
 - [Getting Started](./getting-started.md)
 - [EndpointBuilder](./endpoint-builder.md)
 - [OpenAPI Schema](./openapi-schema.md)
+- [JSON Schema Vocabularies](./json-schema-vocabularies.md)
 - [Security](./security.md)
+- [Tags](./tags.md)
 - [Components](./components.md)
+- [Webhooks](./webhooks.md)
 - [Examples](./examples.md)
 
 ## Overview
@@ -22,6 +25,10 @@ following the OpenAPI 3.1 standard. It provides:
 - Tools for serialization to JSON and YAML formats
 - Validation rule handling and documentation
 - Comprehensive security scheme definitions and requirements
+- Tag management for API organization and categorization
+- Webhook support for defining asynchronous API callbacks
+- Component reusability for schemas, responses, parameters, and webhooks
+- Full JSON Schema 2020-12 support with advanced schema vocabularies
 
 ## Basic Usage
 
@@ -56,6 +63,34 @@ const getUserEndpoint = new EndpointBuilder({
 // Add the endpoint to the API document
 api.addNewEndpoint_("/users/{id}", getUserEndpoint);
 
+// Add a webhook to the API
+api.createWebhook("userUpdated", {
+  summary: "User Updated Notification",
+  description: "Sent when a user profile is updated",
+  operations: {
+    post: {
+      requestBody: {
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                userId: { type: "string" },
+                updatedAt: { type: "string", format: "date-time" },
+              },
+              required: ["userId", "updatedAt"],
+            },
+          },
+        },
+        required: true,
+      },
+      responses: {
+        "200": { description: "Webhook received" },
+      },
+    },
+  },
+});
+
 // Export as JSON or YAML
 const jsonString = api.getJSONString();
 const yamlString = api.getYAMLString();

docs/README.md

@@ -82,6 +82,32 @@ const getUsersEndpoint = new EndpointBuilder()
 openapi.addNewEndpoint_("/users", getUsersEndpoint);
 ```
 
+### Adding Tags for Organization
+
+Tags help organize and categorize your API operations:
+
+```typescript
+// Define tags at the OpenAPI level
+openapi.addTag("users", "User management endpoints");
+openapi.addTag("products", "Product catalog endpoints");
+openapi.addTag("auth", "Authentication and authorization");
+
+// Then reference these tags in your endpoints
+const getUsersEndpoint = new EndpointBuilder()
+  .setOperation("get")
+  .setTags(["users"]) // Add the "users" tag to this endpoint
+  .setSummary("Get users");
+// ...more endpoint configuration
+
+// Tags can also be added individually
+const createProductEndpoint = new EndpointBuilder()
+  .setOperation("post")
+  .addTag("products") // Add a single tag
+  .addTag("admin") // Add another tag
+  .setSummary("Create product");
+// ...more endpoint configuration
+```
+
 ### Using Components for Reusability
 
 For better organization and to avoid duplication, use the OpenAPI component

docs/getting-started.md

@@ -10,13 +10,17 @@ your API endpoints, schemas, responses, and more.
 - 📚 **OpenAPI 3.1 compatible**: Generate OpenAPI documentation that follows the
   latest specification
 - 🧩 **Components**: Define reusable schemas, responses, parameters, and more
+- 🏷️ **Tags**: Organize your API with descriptive, reusable tags
 - 📄 **JSON & YAML output**: Export your documentation in both formats
 - 🔄 **Validation**: Associate validation rules with your API documentation
+- 🔒 **Security**: Comprehensive security scheme definitions
 
 ## Documentation
 
 - [Getting Started](./getting-started.md): Learn how to use Yelix OpenAPI
 - [Components](./components.md): Learn how to use reusable components
+- [Tags](./tags.md): Learn how to organize your API with tags
+- [Security](./security.md): Learn how to secure your API
 - [Validation](./validation.md): Learn about validation rules
 
 ## Basic Example