@zudojs/openapi 0.0.1

package/dist/openApiTypes/openApiDocument.type.d.ts

@@ -0,0 +1,61 @@
+/**
+ * OpenAPI document, info, and server types.
+ */
+/** Supported OpenAPI specification versions. */
+export type OpenAPIVersion = "3.0.0" | "3.0.1" | "3.0.2" | "3.0.3" | "3.1.0" | "3.1.1";
+/** The root OpenAPI document object. */
+export interface OpenAPIDocument {
+    readonly openapi: string;
+    readonly info: OpenAPIInfo;
+    readonly servers?: readonly OpenAPIServer[];
+    readonly paths: import("./openApiPath.type.js").OpenAPIPaths;
+    readonly components?: import("./openApiComponent.type.js").OpenAPIComponents;
+    readonly security?: readonly import("./openApiSecurity.type.js").OpenAPISecurityRequirement[];
+    readonly tags?: readonly OpenAPITag[];
+    readonly externalDocs?: OpenAPIExternalDocumentation;
+}
+/** OpenAPI info object. */
+export interface OpenAPIInfo {
+    readonly title: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly summary?: string;
+    readonly termsOfService?: string;
+    readonly contact?: OpenAPIContact;
+    readonly license?: OpenAPILicense;
+}
+export interface OpenAPIContact {
+    readonly name?: string;
+    readonly url?: string;
+    readonly email?: string;
+}
+export interface OpenAPILicense {
+    readonly name: string;
+    readonly url?: string;
+}
+export interface OpenAPIServer {
+    readonly url: string;
+    readonly description?: string;
+    readonly variables?: Readonly<Record<string, OpenAPIServerVariable>>;
+}
+export interface OpenAPIServerVariable {
+    readonly enum?: readonly string[];
+    readonly default: string;
+    readonly description?: string;
+}
+export interface OpenAPIExternalDocumentation {
+    readonly description?: string;
+    readonly url: string;
+}
+export interface OpenAPITag {
+    readonly name: string;
+    readonly description?: string;
+    readonly externalDocs?: OpenAPIExternalDocumentation;
+    readonly extensions?: Readonly<Record<string, unknown>>;
+}
+export interface OpenAPIReference {
+    readonly $ref: string;
+    readonly summary?: string;
+    readonly description?: string;
+}
+//# sourceMappingURL=openApiDocument.type.d.ts.map

package/dist/openApiTypes/openApiDocument.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiDocument.type.d.ts","sourceRoot":"","sources":["../../src/openApiTypes/openApiDocument.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gDAAgD;AAChD,MAAM,MAAM,cAAc,GACxB,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,uBAAuB,EAAE,YAAY,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,4BAA4B,EAAE,iBAAiB,CAAC;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,OAAO,2BAA2B,EAAE,0BAA0B,EAAE,CAAC;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,4BAA4B,CAAC;CACtD;AAED,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/openApiTypes/openApiDocument.type.js

@@ -0,0 +1,5 @@
+/**
+ * OpenAPI document, info, and server types.
+ */
+export {};
+//# sourceMappingURL=openApiDocument.type.js.map

package/dist/openApiTypes/openApiDocument.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiDocument.type.js","sourceRoot":"","sources":["../../src/openApiTypes/openApiDocument.type.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/openApiTypes/openApiPath.type.d.ts

@@ -0,0 +1,48 @@
+/**
+ * OpenAPI path, operation, and parameter types.
+ */
+export type OpenAPIPaths = Readonly<Record<string, OpenAPIPathItem | undefined>>;
+export interface OpenAPIPathItem {
+    readonly summary?: string;
+    readonly description?: string;
+    readonly get?: OpenAPIOperation;
+    readonly put?: OpenAPIOperation;
+    readonly post?: OpenAPIOperation;
+    readonly delete?: OpenAPIOperation;
+    readonly options?: OpenAPIOperation;
+    readonly head?: OpenAPIOperation;
+    readonly patch?: OpenAPIOperation;
+    readonly trace?: OpenAPIOperation;
+    readonly parameters?: readonly OpenAPIParameter[];
+    readonly servers?: readonly import("./openApiDocument.type.js").OpenAPIServer[];
+    readonly $ref?: string;
+}
+export interface OpenAPIOperation {
+    readonly tags?: readonly string[];
+    readonly summary?: string;
+    readonly description?: string;
+    readonly operationId?: string;
+    readonly parameters?: readonly OpenAPIParameter[];
+    readonly requestBody?: import("./openApiComponent.type.js").OpenAPIRequestBody;
+    readonly responses: OpenAPIResponses;
+    readonly callbacks?: Readonly<Record<string, Readonly<Record<string, OpenAPIPathItem>>>>;
+    readonly deprecated?: boolean;
+    readonly security?: readonly import("./openApiSecurity.type.js").OpenAPISecurityRequirement[];
+    readonly servers?: readonly import("./openApiDocument.type.js").OpenAPIServer[];
+    readonly externalDocs?: import("./openApiDocument.type.js").OpenAPIExternalDocumentation;
+}
+export type OpenAPIResponses = Readonly<Record<string, import("./openApiComponent.type.js").OpenAPIResponse>>;
+export interface OpenAPIParameter {
+    readonly name: string;
+    readonly in: OpenAPIParameterLocation;
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly deprecated?: boolean;
+    readonly allowEmptyValue?: boolean;
+    readonly schema?: unknown;
+    readonly example?: unknown;
+    readonly examples?: Readonly<Record<string, import("./openApiComponent.type.js").OpenAPIExample>>;
+    readonly content?: Readonly<Record<string, import("./openApiComponent.type.js").OpenAPIMediaType>>;
+}
+export type OpenAPIParameterLocation = "query" | "header" | "path" | "cookie";
+//# sourceMappingURL=openApiPath.type.d.ts.map

package/dist/openApiTypes/openApiPath.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiPath.type.d.ts","sourceRoot":"","sources":["../../src/openApiTypes/openApiPath.type.ts"],"names":[],"mappings":"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"}

package/dist/openApiTypes/openApiPath.type.js

@@ -0,0 +1,5 @@
+/**
+ * OpenAPI path, operation, and parameter types.
+ */
+export {};
+//# sourceMappingURL=openApiPath.type.js.map

package/dist/openApiTypes/openApiPath.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiPath.type.js","sourceRoot":"","sources":["../../src/openApiTypes/openApiPath.type.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/openApiTypes/openApiSchema.type.d.ts

@@ -0,0 +1,40 @@
+/**
+ * OpenAPI schema types.
+ */
+export interface OpenAPISchema {
+    readonly title?: string;
+    readonly type?: string;
+    readonly properties?: Readonly<Record<string, OpenAPISchema>>;
+    readonly required?: readonly string[];
+    readonly description?: string;
+    readonly format?: string;
+    readonly default?: unknown;
+    readonly nullable?: boolean;
+    readonly readOnly?: boolean;
+    readonly writeOnly?: boolean;
+    readonly deprecated?: boolean;
+    readonly example?: unknown;
+    readonly enum?: readonly unknown[];
+    readonly $ref?: string;
+    readonly allOf?: readonly OpenAPISchema[];
+    readonly oneOf?: readonly OpenAPISchema[];
+    readonly anyOf?: readonly OpenAPISchema[];
+    readonly items?: OpenAPISchema;
+    readonly additionalProperties?: OpenAPISchema | boolean;
+    readonly discriminator?: OpenAPIDiscriminator;
+    readonly xml?: OpenAPIXml;
+    readonly extensions?: Readonly<Record<string, unknown>>;
+}
+export interface OpenAPIDiscriminator {
+    readonly propertyName: string;
+    readonly mapping?: Readonly<Record<string, string>>;
+    readonly oneOf?: readonly OpenAPISchema[];
+}
+export interface OpenAPIXml {
+    readonly name?: string;
+    readonly namespace?: string;
+    readonly prefix?: string;
+    readonly attribute?: boolean;
+    readonly wrapped?: boolean;
+}
+//# sourceMappingURL=openApiSchema.type.d.ts.map

package/dist/openApiTypes/openApiSchema.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiSchema.type.d.ts","sourceRoot":"","sources":["../../src/openApiTypes/openApiSchema.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/dist/openApiTypes/openApiSchema.type.js

@@ -0,0 +1,5 @@
+/**
+ * OpenAPI schema types.
+ */
+export {};
+//# sourceMappingURL=openApiSchema.type.js.map

package/dist/openApiTypes/openApiSchema.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiSchema.type.js","sourceRoot":"","sources":["../../src/openApiTypes/openApiSchema.type.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/openApiTypes/openApiSecurity.type.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OpenAPI security types.
+ */
+export interface OpenAPISecurityRequirement {
+    readonly [key: string]: readonly string[];
+}
+export interface OpenAPISecurityScheme {
+    readonly type: "apiKey" | "http" | "mutualTLS" | "oauth2" | "openIdConnect";
+    readonly description?: string;
+    readonly name?: string;
+    readonly in?: "query" | "header" | "cookie";
+    readonly scheme?: string;
+    readonly bearerFormat?: string;
+    readonly flows?: OpenAPIOAuthFlows;
+    readonly openIdConnectUrl?: string;
+}
+export interface OpenAPIOAuthFlows {
+    readonly implicit?: OpenAPIOAuthFlow;
+    readonly password?: OpenAPIOAuthFlow;
+    readonly clientCredentials?: OpenAPIOAuthFlow;
+    readonly authorizationCode?: OpenAPIOAuthFlow;
+}
+export interface OpenAPIOAuthFlow {
+    readonly authorizationUrl?: string;
+    readonly tokenUrl?: string;
+    readonly refreshUrl?: string;
+    readonly scopes?: Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=openApiSecurity.type.d.ts.map

package/dist/openApiTypes/openApiSecurity.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiSecurity.type.d.ts","sourceRoot":"","sources":["../../src/openApiTypes/openApiSecurity.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD"}

package/dist/openApiTypes/openApiSecurity.type.js

@@ -0,0 +1,5 @@
+/**
+ * OpenAPI security types.
+ */
+export {};
+//# sourceMappingURL=openApiSecurity.type.js.map

package/dist/openApiTypes/openApiSecurity.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiSecurity.type.js","sourceRoot":"","sources":["../../src/openApiTypes/openApiSecurity.type.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/openApiTypes/openApiTypes.core.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @zudojs/openapi/openApiTypes
+ *
+ * All OpenAPI specification types re-exported from split modules.
+ */
+export * from "./openApiDocument.type.js";
+export * from "./openApiPath.type.js";
+export * from "./openApiComponent.type.js";
+export * from "./openApiSchema.type.js";
+export * from "./openApiSecurity.type.js";
+//# sourceMappingURL=openApiTypes.core.d.ts.map

package/dist/openApiTypes/openApiTypes.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiTypes.core.d.ts","sourceRoot":"","sources":["../../src/openApiTypes/openApiTypes.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/openApiTypes/openApiTypes.core.js

@@ -0,0 +1,11 @@
+/**
+ * @zudojs/openapi/openApiTypes
+ *
+ * All OpenAPI specification types re-exported from split modules.
+ */
+export * from "./openApiDocument.type.js";
+export * from "./openApiPath.type.js";
+export * from "./openApiComponent.type.js";
+export * from "./openApiSchema.type.js";
+export * from "./openApiSecurity.type.js";
+//# sourceMappingURL=openApiTypes.core.js.map

package/dist/openApiTypes/openApiTypes.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiTypes.core.js","sourceRoot":"","sources":["../../src/openApiTypes/openApiTypes.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/openApiValidation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/openapi/openApiValidation
+ *
+ * OpenAPI document validation.
+ */
+export type { OpenAPIValidator } from "./openApiValidator.core.js";
+export { OpenAPIValidatorImpl } from "./openApiValidator.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/openApiValidation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openApiValidation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/openApiValidation/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/openapi/openApiValidation
+ *
+ * OpenAPI document validation.
+ */
+export { OpenAPIValidatorImpl } from "./openApiValidator.core.js";
+//# sourceMappingURL=index.js.map

package/dist/openApiValidation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openApiValidation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/openApiValidation/openApiValidator.core.d.ts

@@ -0,0 +1,22 @@
+import type { OpenAPIDocument } from "../openApiTypes/openApiTypes.core.js";
+import type { OpenAPIValidationIssue } from "../openApiErrors/openApiError.core.js";
+export interface OpenAPIValidator {
+    validate(document: OpenAPIDocument): {
+        readonly valid: boolean;
+        readonly errors: readonly OpenAPIValidationIssue[];
+        readonly warnings: readonly OpenAPIValidationIssue[];
+    };
+    assertValid(document: OpenAPIDocument): void;
+}
+export declare class OpenAPIValidatorImpl implements OpenAPIValidator {
+    validate(document: OpenAPIDocument): {
+        readonly valid: boolean;
+        readonly errors: readonly OpenAPIValidationIssue[];
+        readonly warnings: readonly OpenAPIValidationIssue[];
+    };
+    assertValid(document: OpenAPIDocument): void;
+    private validateDocumentStructure;
+    private validatePaths;
+    private validateOperationIds;
+}
+//# sourceMappingURL=openApiValidator.core.d.ts.map

package/dist/openApiValidation/openApiValidator.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiValidator.core.d.ts","sourceRoot":"","sources":["../../src/openApiValidation/openApiValidator.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAcpF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG;QACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;QACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;KACtD,CAAC;IACF,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC9C;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IACpD,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG;QAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;QACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;KACtD,CAWA;IAEM,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAOlD;IAED,OAAO,CAAC,yBAAyB;IAwCjC,OAAO,CAAC,aAAa;IAsCrB,OAAO,CAAC,oBAAoB;CAwB7B"}

package/dist/openApiValidation/openApiValidator.core.js

@@ -0,0 +1,114 @@
+import { OpenAPIValidationError } from "../openApiErrors/openApiError.core.js";
+const OPERATIONS = [
+    "get",
+    "put",
+    "post",
+    "delete",
+    "options",
+    "head",
+    "patch",
+    "trace",
+];
+export class OpenAPIValidatorImpl {
+    validate(document) {
+        const errors = [];
+        const warnings = [];
+        this.validateDocumentStructure(document, errors, warnings);
+        this.validatePaths(document, errors, warnings);
+        this.validateOperationIds(document, errors, warnings);
+        return {
+            valid: errors.length === 0,
+            errors: Object.freeze([...errors]),
+            warnings: Object.freeze([...warnings]),
+        };
+    }
+    assertValid(document) {
+        const result = this.validate(document);
+        if (!result.valid)
+            throw new OpenAPIValidationError("OpenAPI validation failed.", result.errors);
+    }
+    validateDocumentStructure(document, errors, warnings) {
+        if (!document.openapi)
+            errors.push({
+                path: ["openapi"],
+                message: "OpenAPI version is required.",
+                severity: "error",
+            });
+        if (!document.info) {
+            errors.push({
+                path: ["info"],
+                message: "Info object is required.",
+                severity: "error",
+            });
+        }
+        else {
+            if (!document.info.title)
+                errors.push({
+                    path: ["info", "title"],
+                    message: "Info title is required.",
+                    severity: "error",
+                });
+            if (!document.info.version)
+                errors.push({
+                    path: ["info", "version"],
+                    message: "Info version is required.",
+                    severity: "error",
+                });
+        }
+        if (!document.paths || Object.keys(document.paths).length === 0) {
+            warnings.push({
+                path: ["paths"],
+                message: "Document has no paths defined.",
+                severity: "warning",
+            });
+        }
+    }
+    validatePaths(document, errors, _warnings) {
+        for (const [path, pathItem] of Object.entries(document.paths)) {
+            if (!pathItem)
+                continue;
+            if (path.includes(":") && !path.includes("{")) {
+                errors.push({
+                    path: ["paths", path],
+                    message: `Path "${path}" contains un-converted path parameters. Use "/users/{id}" instead of "/users/:id".`,
+                    severity: "error",
+                });
+            }
+            for (const method of OPERATIONS) {
+                const operation = pathItem[method];
+                if (!operation)
+                    continue;
+                for (const param of operation.parameters ?? []) {
+                    if (param.in === "path" && !param.required) {
+                        errors.push({
+                            path: ["paths", path, method, "parameters"],
+                            message: `Path parameter "${param.name}" must be required.`,
+                            severity: "error",
+                        });
+                    }
+                }
+            }
+        }
+    }
+    validateOperationIds(document, errors, _warnings) {
+        const operationIds = new Set();
+        for (const [path, pathItem] of Object.entries(document.paths)) {
+            if (!pathItem)
+                continue;
+            for (const method of OPERATIONS) {
+                const operation = pathItem[method];
+                if (!operation?.operationId)
+                    continue;
+                if (operationIds.has(operation.operationId)) {
+                    errors.push({
+                        path: ["paths", path, method, "operationId"],
+                        message: `Duplicate operationId "${operation.operationId}".`,
+                        severity: "error",
+                    });
+                }
+                operationIds.add(operation.operationId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=openApiValidator.core.js.map

package/dist/openApiValidation/openApiValidator.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiValidator.core.js","sourceRoot":"","sources":["../../src/openApiValidation/openApiValidator.core.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@zudojs/openapi",
+  "version": "0.0.1",
+  "description": "OpenAPI 3.1 specification generation, validation, and SDK generation for Zudojs applications.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@zudojs/errors": "workspace:*",
+    "@zudojs/constants": "workspace:*",
+    "@zudojs/schema": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "openapi",
+    "swagger",
+    "api-docs"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  }
+}