@jsango/openapi 1.0.0

package/dist/public/schema-builder.js

@@ -0,0 +1,117 @@
+export class SchemaBuilder {
+    static string(options = {}) {
+        return { type: 'string', ...options };
+    }
+    static number(options = {}) {
+        return { type: 'number', ...options };
+    }
+    static integer(options = {}) {
+        return { type: 'integer', ...options };
+    }
+    static boolean(options = {}) {
+        return { type: 'boolean', ...options };
+    }
+    static uuid(options = {}) {
+        return { type: 'string', format: 'uuid', ...options };
+    }
+    static dateTime(options = {}) {
+        return { type: 'string', format: 'date-time', ...options };
+    }
+    static date(options = {}) {
+        return { type: 'string', format: 'date', ...options };
+    }
+    static email(options = {}) {
+        return { type: 'string', format: 'email', ...options };
+    }
+    static binary(options = {}) {
+        return { type: 'string', format: 'binary', ...options };
+    }
+    static array(items, options = {}) {
+        return { type: 'array', items, ...options };
+    }
+    static object(properties, required = [], options = {}) {
+        return {
+            type: 'object',
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+            ...options,
+        };
+    }
+    static enum(values, options = {}) {
+        const type = typeof values[0] === 'number' ? 'number' : 'string';
+        return { type, enum: values, ...options };
+    }
+    static ref(schemaName) {
+        return { $ref: `#/components/schemas/${schemaName}` };
+    }
+    /**
+     * Reusable error response schema matching framework's JsangoError / HTTP error format.
+     */
+    static errorResponse() {
+        return {
+            type: 'object',
+            required: ['ok', 'error'],
+            properties: {
+                ok: { type: 'boolean', example: false },
+                error: {
+                    type: 'object',
+                    required: ['code', 'message'],
+                    properties: {
+                        code: { type: 'string', example: 'ERR_NOT_FOUND' },
+                        message: { type: 'string', example: 'Resource not found' },
+                        meta: { type: 'object', additionalProperties: true },
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Reusable validation error response schema matching @jsango/validation format.
+     */
+    static validationErrorResponse() {
+        return {
+            type: 'object',
+            required: ['ok', 'error'],
+            properties: {
+                ok: { type: 'boolean', example: false },
+                error: {
+                    type: 'object',
+                    required: ['code', 'message', 'errors'],
+                    properties: {
+                        code: { type: 'string', example: 'ERR_VALIDATION' },
+                        message: { type: 'string', example: 'Validation failed' },
+                        errors: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                required: ['field', 'message'],
+                                properties: {
+                                    field: { type: 'string', example: 'email' },
+                                    message: { type: 'string', example: 'Invalid email address format' },
+                                    code: { type: 'string', example: 'invalid_email' },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Standard paginated response schema.
+     */
+    static paginated(itemSchema) {
+        return {
+            type: 'object',
+            required: ['items', 'total', 'page', 'pageSize', 'totalPages'],
+            properties: {
+                items: { type: 'array', items: itemSchema },
+                total: { type: 'integer', minimum: 0 },
+                page: { type: 'integer', minimum: 1 },
+                pageSize: { type: 'integer', minimum: 1 },
+                totalPages: { type: 'integer', minimum: 0 },
+            },
+        };
+    }
+}
+//# sourceMappingURL=schema-builder.js.map

package/dist/public/schema-builder.js.map

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

package/dist/public/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Supported OpenAPI specifications.
+ * Defaults to 3.1.0 (latest stable) while supporting 3.0.3 generation mode.
+ */
+export type OpenApiVersion = '3.1.0' | '3.0.3';
+export interface OpenApiContact {
+    readonly name?: string | undefined;
+    readonly url?: string | undefined;
+    readonly email?: string | undefined;
+}
+export interface OpenApiLicense {
+    readonly name: string;
+    readonly identifier?: string | undefined;
+    readonly url?: string | undefined;
+}
+export interface OpenApiInfo {
+    readonly title: string;
+    readonly version: string;
+    readonly description?: string | undefined;
+    readonly termsOfService?: string | undefined;
+    readonly contact?: OpenApiContact | undefined;
+    readonly license?: OpenApiLicense | undefined;
+}
+export interface OpenApiServerVariable {
+    readonly default: string;
+    readonly description?: string | undefined;
+    readonly enum?: readonly string[] | undefined;
+}
+export interface OpenApiServer {
+    readonly url: string;
+    readonly description?: string | undefined;
+    readonly variables?: Record<string, OpenApiServerVariable> | undefined;
+}
+export type OpenApiParameterIn = 'path' | 'query' | 'header' | 'cookie';
+export interface OpenApiParameter {
+    readonly name: string;
+    readonly in: OpenApiParameterIn;
+    readonly description?: string | undefined;
+    readonly required?: boolean | undefined;
+    readonly deprecated?: boolean | undefined;
+    readonly allowEmptyValue?: boolean | undefined;
+    readonly schema?: OpenApiSchema | undefined;
+    readonly example?: unknown;
+    readonly examples?: Record<string, {
+        summary?: string;
+        value: unknown;
+    }> | undefined;
+}
+export interface OpenApiMediaType {
+    readonly schema?: OpenApiSchema | undefined;
+    readonly example?: unknown;
+    readonly examples?: Record<string, {
+        summary?: string;
+        value: unknown;
+    }> | undefined;
+}
+export interface OpenApiRequestBody {
+    readonly description?: string | undefined;
+    readonly required?: boolean | undefined;
+    readonly content: Record<string, OpenApiMediaType>;
+}
+export interface OpenApiHeader {
+    readonly description?: string | undefined;
+    readonly required?: boolean | undefined;
+    readonly deprecated?: boolean | undefined;
+    readonly schema?: OpenApiSchema | undefined;
+}
+export interface OpenApiResponse {
+    readonly description: string;
+    readonly headers?: Record<string, OpenApiHeader> | undefined;
+    readonly content?: Record<string, OpenApiMediaType> | undefined;
+}
+export type OpenApiResponses = Record<string, OpenApiResponse>;
+export type OpenApiSecuritySchemeType = 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+export interface OpenApiSecurityScheme {
+    readonly type: OpenApiSecuritySchemeType;
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly in?: 'query' | 'header' | 'cookie' | undefined;
+    readonly scheme?: string | undefined;
+    readonly bearerFormat?: string | undefined;
+    readonly openIdConnectUrl?: string | undefined;
+    readonly flows?: Record<string, unknown> | undefined;
+}
+export type OpenApiSecurityRequirement = Record<string, readonly string[]>;
+export interface OpenApiTag {
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly externalDocs?: {
+        description?: string;
+        url: string;
+    } | undefined;
+}
+export interface OpenApiSchema {
+    readonly type?: string | readonly string[] | undefined;
+    readonly format?: string | undefined;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly default?: unknown;
+    readonly multipleOf?: number | undefined;
+    readonly maximum?: number | undefined;
+    readonly exclusiveMaximum?: number | boolean | undefined;
+    readonly minimum?: number | undefined;
+    readonly exclusiveMinimum?: number | boolean | undefined;
+    readonly maxLength?: number | undefined;
+    readonly minLength?: number | undefined;
+    readonly pattern?: string | undefined;
+    readonly maxItems?: number | undefined;
+    readonly minItems?: number | undefined;
+    readonly uniqueItems?: boolean | undefined;
+    readonly maxProperties?: number | undefined;
+    readonly minProperties?: number | undefined;
+    readonly required?: readonly string[] | undefined;
+    readonly enum?: readonly unknown[] | undefined;
+    readonly items?: OpenApiSchema | undefined;
+    readonly properties?: Record<string, OpenApiSchema> | undefined;
+    readonly additionalProperties?: boolean | OpenApiSchema | undefined;
+    readonly nullable?: boolean | undefined;
+    readonly readOnly?: boolean | undefined;
+    readonly writeOnly?: boolean | undefined;
+    readonly example?: unknown;
+    readonly examples?: readonly unknown[] | undefined;
+    readonly deprecated?: boolean | undefined;
+    readonly $ref?: string | undefined;
+    readonly allOf?: readonly OpenApiSchema[] | undefined;
+    readonly anyOf?: readonly OpenApiSchema[] | undefined;
+    readonly oneOf?: readonly OpenApiSchema[] | undefined;
+    readonly not?: OpenApiSchema | undefined;
+    readonly [key: `x-${string}`]: unknown;
+}
+export interface OpenApiOperation {
+    readonly tags?: readonly string[] | undefined;
+    readonly summary?: string | undefined;
+    readonly description?: string | undefined;
+    readonly operationId?: string | undefined;
+    readonly parameters?: readonly OpenApiParameter[] | undefined;
+    readonly requestBody?: OpenApiRequestBody | undefined;
+    readonly responses: OpenApiResponses;
+    readonly deprecated?: boolean | undefined;
+    readonly security?: readonly OpenApiSecurityRequirement[] | undefined;
+    readonly servers?: readonly OpenApiServer[] | undefined;
+    readonly [key: `x-${string}`]: unknown;
+}
+export interface OpenApiPathItem {
+    readonly summary?: string | undefined;
+    readonly description?: string | undefined;
+    readonly get?: OpenApiOperation | undefined;
+    readonly put?: OpenApiOperation | undefined;
+    readonly post?: OpenApiOperation | undefined;
+    readonly delete?: OpenApiOperation | undefined;
+    readonly options?: OpenApiOperation | undefined;
+    readonly head?: OpenApiOperation | undefined;
+    readonly patch?: OpenApiOperation | undefined;
+    readonly trace?: OpenApiOperation | undefined;
+    readonly servers?: readonly OpenApiServer[] | undefined;
+    readonly parameters?: readonly OpenApiParameter[] | undefined;
+}
+export type OpenApiPaths = Record<string, OpenApiPathItem>;
+export interface OpenApiComponents {
+    readonly schemas?: Record<string, OpenApiSchema> | undefined;
+    readonly responses?: Record<string, OpenApiResponse> | undefined;
+    readonly parameters?: Record<string, OpenApiParameter> | undefined;
+    readonly requestBodies?: Record<string, OpenApiRequestBody> | undefined;
+    readonly securitySchemes?: Record<string, OpenApiSecurityScheme> | undefined;
+    readonly headers?: Record<string, OpenApiHeader> | undefined;
+}
+export interface OpenApiDocument {
+    readonly openapi: OpenApiVersion;
+    readonly info: OpenApiInfo;
+    readonly servers?: readonly OpenApiServer[] | undefined;
+    readonly paths: OpenApiPaths;
+    readonly components?: OpenApiComponents | undefined;
+    readonly security?: readonly OpenApiSecurityRequirement[] | undefined;
+    readonly tags?: readonly OpenApiTag[] | undefined;
+    readonly externalDocs?: {
+        description?: string;
+        url: string;
+    } | undefined;
+}
+/**
+ * Route metadata format for explicitly specifying OpenAPI information on routes.
+ * Attached via route options: `{ metadata: { openapi: { ... } } }`.
+ */
+export interface OpenApiRouteMetadata {
+    readonly summary?: string | undefined;
+    readonly description?: string | undefined;
+    readonly operationId?: string | undefined;
+    readonly tags?: readonly string[] | undefined;
+    readonly deprecated?: boolean | undefined;
+    readonly parameters?: readonly OpenApiParameter[] | undefined;
+    readonly requestBody?: OpenApiRequestBody | undefined;
+    readonly responses?: OpenApiResponses | undefined;
+    readonly security?: readonly OpenApiSecurityRequirement[] | undefined;
+    readonly hidden?: boolean | undefined;
+    readonly excludeFromOpenApi?: boolean | undefined;
+    readonly [key: `x-${string}`]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/public/types.d.ts.map

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

package/dist/public/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/public/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/public/types.ts"],"names":[],"mappings":""}

package/dist/public/validation-adapter.d.ts

@@ -0,0 +1,24 @@
+import type { OpenApiSchema } from './types.js';
+export interface ValidationSchemaDescriptor {
+    readonly type?: string | undefined;
+    readonly format?: string | undefined;
+    readonly required?: readonly string[] | boolean | undefined;
+    readonly properties?: Record<string, ValidationSchemaDescriptor> | undefined;
+    readonly items?: ValidationSchemaDescriptor | undefined;
+    readonly enum?: readonly unknown[] | undefined;
+    readonly minimum?: number | undefined;
+    readonly maximum?: number | undefined;
+    readonly minLength?: number | undefined;
+    readonly maxLength?: number | undefined;
+    readonly pattern?: string | undefined;
+    readonly description?: string | undefined;
+    readonly default?: unknown;
+    readonly nullable?: boolean | undefined;
+}
+export declare class ValidationAdapter {
+    /**
+     * Converts validation descriptor/metadata into a valid OpenApiSchema.
+     */
+    static toOpenApiSchema(descriptor: ValidationSchemaDescriptor | unknown): OpenApiSchema;
+}
+//# sourceMappingURL=validation-adapter.d.ts.map

package/dist/public/validation-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-adapter.d.ts","sourceRoot":"","sources":["../../src/public/validation-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,GAAG,SAAS,CAAC;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,qBAAa,iBAAiB;IAC5B;;OAEG;WACW,eAAe,CAAC,UAAU,EAAE,0BAA0B,GAAG,OAAO,GAAG,aAAa;CA+C/F"}

package/dist/public/validation-adapter.js

@@ -0,0 +1,57 @@
+export class ValidationAdapter {
+    /**
+     * Converts validation descriptor/metadata into a valid OpenApiSchema.
+     */
+    static toOpenApiSchema(descriptor) {
+        if (!descriptor || typeof descriptor !== 'object') {
+            return { type: 'string' };
+        }
+        const d = descriptor;
+        const schema = {};
+        if (d.type)
+            schema['type'] = d.type;
+        if (d.format)
+            schema['format'] = d.format;
+        if (d.description)
+            schema['description'] = d.description;
+        if (d.default !== undefined)
+            schema['default'] = d.default;
+        if (d.minimum !== undefined)
+            schema['minimum'] = d.minimum;
+        if (d.maximum !== undefined)
+            schema['maximum'] = d.maximum;
+        if (d.minLength !== undefined)
+            schema['minLength'] = d.minLength;
+        if (d.maxLength !== undefined)
+            schema['maxLength'] = d.maxLength;
+        if (d.pattern !== undefined)
+            schema['pattern'] = d.pattern;
+        if (d.enum !== undefined)
+            schema['enum'] = d.enum;
+        if (d.nullable !== undefined)
+            schema['nullable'] = d.nullable;
+        if (d.type === 'array' && d.items) {
+            schema['items'] = ValidationAdapter.toOpenApiSchema(d.items);
+        }
+        if (d.properties) {
+            const props = {};
+            const requiredFields = [];
+            for (const [key, propDescriptor] of Object.entries(d.properties)) {
+                props[key] = ValidationAdapter.toOpenApiSchema(propDescriptor);
+                if (propDescriptor.required === true) {
+                    requiredFields.push(key);
+                }
+            }
+            schema['type'] = 'object';
+            schema['properties'] = props;
+            if (Array.isArray(d.required)) {
+                schema['required'] = d.required;
+            }
+            else if (requiredFields.length > 0) {
+                schema['required'] = requiredFields;
+            }
+        }
+        return schema;
+    }
+}
+//# sourceMappingURL=validation-adapter.js.map

package/dist/public/validation-adapter.js.map

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

package/dist/public/validator.d.ts

@@ -0,0 +1,14 @@
+import type { OpenApiDocument } from './types.js';
+export declare class OpenApiValidator {
+    /**
+     * Validates an OpenApiDocument.
+     * Returns an array of validation error messages (empty if valid).
+     */
+    static validate(doc: OpenApiDocument): string[];
+    /**
+     * Asserts that an OpenApiDocument is valid, throwing InvalidOpenApiDocumentError if not.
+     */
+    static assertValid(doc: OpenApiDocument): void;
+    private static validateRefs;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/public/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/public/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,qBAAa,gBAAgB;IAC3B;;;OAGG;WACW,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,EAAE;IAoFtD;;OAEG;WACW,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAOrD,OAAO,CAAC,MAAM,CAAC,YAAY;CA0B5B"}

package/dist/public/validator.js

@@ -0,0 +1,107 @@
+import { InvalidOpenApiDocumentError } from './errors.js';
+export class OpenApiValidator {
+    /**
+     * Validates an OpenApiDocument.
+     * Returns an array of validation error messages (empty if valid).
+     */
+    static validate(doc) {
+        const errors = [];
+        if (!doc.openapi) {
+            errors.push('Missing required top-level "openapi" version string.');
+        }
+        if (!doc.info) {
+            errors.push('Missing required top-level "info" object.');
+        }
+        else {
+            if (!doc.info.title)
+                errors.push('Missing required "info.title".');
+            if (!doc.info.version)
+                errors.push('Missing required "info.version".');
+        }
+        if (!doc.paths || typeof doc.paths !== 'object') {
+            errors.push('Missing required top-level "paths" object.');
+            return errors;
+        }
+        const operationIds = new Set();
+        for (const [pathKey, pathItem] of Object.entries(doc.paths)) {
+            if (!pathKey.startsWith('/')) {
+                errors.push(`Path "${pathKey}" must start with a forward slash "/".`);
+            }
+            // Extract path parameter names from `{param}`
+            const pathParamMatches = Array.from(pathKey.matchAll(/\{([a-zA-Z0-9_]+)\}/g)).map((m) => m[1]);
+            const methods = [
+                'get',
+                'post',
+                'put',
+                'patch',
+                'delete',
+                'options',
+                'head',
+                'trace',
+            ];
+            for (const method of methods) {
+                const op = pathItem[method];
+                if (!op)
+                    continue;
+                if (op.operationId) {
+                    if (operationIds.has(op.operationId)) {
+                        errors.push(`Duplicate operationId "${op.operationId}" found in ${method.toUpperCase()} ${pathKey}.`);
+                    }
+                    operationIds.add(op.operationId);
+                }
+                if (!op.responses || Object.keys(op.responses).length === 0) {
+                    errors.push(`Operation ${method.toUpperCase()} ${pathKey} must define at least one response in "responses".`);
+                }
+                // Verify required path parameters
+                const opParams = [...(pathItem.parameters ?? []), ...(op.parameters ?? [])];
+                for (const paramName of pathParamMatches) {
+                    const found = opParams.find((p) => p.in === 'path' && p.name === paramName);
+                    if (!found) {
+                        errors.push(`Path "${pathKey}" defines parameter "{${paramName}}" but operation ${method.toUpperCase()} does not define a matching path parameter.`);
+                    }
+                    else if (!found.required) {
+                        errors.push(`Path parameter "${paramName}" in ${method.toUpperCase()} ${pathKey} must have "required: true".`);
+                    }
+                }
+            }
+        }
+        // Verify component $ref references
+        const availableSchemas = new Set(Object.keys(doc.components?.schemas ?? {}));
+        this.validateRefs(doc, availableSchemas, errors);
+        return errors;
+    }
+    /**
+     * Asserts that an OpenApiDocument is valid, throwing InvalidOpenApiDocumentError if not.
+     */
+    static assertValid(doc) {
+        const errors = this.validate(doc);
+        if (errors.length > 0) {
+            throw new InvalidOpenApiDocumentError(errors);
+        }
+    }
+    static validateRefs(obj, availableSchemas, errors) {
+        if (!obj || typeof obj !== 'object')
+            return;
+        if (Array.isArray(obj)) {
+            for (const item of obj) {
+                this.validateRefs(item, availableSchemas, errors);
+            }
+            return;
+        }
+        const record = obj;
+        if (typeof record['$ref'] === 'string') {
+            const ref = record['$ref'];
+            const prefix = '#/components/schemas/';
+            if (ref.startsWith(prefix)) {
+                const schemaName = ref.slice(prefix.length);
+                if (!availableSchemas.has(schemaName)) {
+                    errors.push(`Unresolved component schema reference: "${ref}".`);
+                }
+            }
+        }
+        for (const value of Object.values(record)) {
+            this.validateRefs(value, availableSchemas, errors);
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/public/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/public/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,OAAO,gBAAgB;IAC3B;;;OAGG;IACI,MAAM,CAAC,QAAQ,CAAC,GAAoB;QACzC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YACnE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO;gBAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QAEvC,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,SAAS,OAAO,wCAAwC,CAAC,CAAC;YACxE,CAAC;YAED,8CAA8C;YAC9C,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAC/E,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CACZ,CAAC;YAEF,MAAM,OAAO,GAAG;gBACd,KAAK;gBACL,MAAM;gBACN,KAAK;gBACL,OAAO;gBACP,QAAQ;gBACR,SAAS;gBACT,MAAM;gBACN,OAAO;aACC,CAAC;YACX,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC5B,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAElB,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBACnB,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;wBACrC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAAE,CAAC,WAAW,cAAc,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,GAAG,CACzF,CAAC;oBACJ,CAAC;oBACD,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;gBACnC,CAAC;gBAED,IAAI,CAAC,EAAE,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5D,MAAM,CAAC,IAAI,CACT,aAAa,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,oDAAoD,CACjG,CAAC;gBACJ,CAAC;gBAED,kCAAkC;gBAClC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC5E,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;oBACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;oBAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,MAAM,CAAC,IAAI,CACT,SAAS,OAAO,yBAAyB,SAAS,oBAAoB,MAAM,CAAC,WAAW,EAAE,6CAA6C,CACxI,CAAC;oBACJ,CAAC;yBAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;wBAC3B,MAAM,CAAC,IAAI,CACT,mBAAmB,SAAS,QAAQ,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,8BAA8B,CAClG,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAEjD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,WAAW,CAAC,GAAoB;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,YAAY,CAAC,GAAY,EAAE,gBAA6B,EAAE,MAAgB;QACvF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO;QAE5C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;gBACvB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;YACpD,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACvC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBACtC,MAAM,CAAC,IAAI,CAAC,2CAA2C,GAAG,IAAI,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@jsango/openapi",
+  "version": "1.0.0",
+  "description": "Deterministic OpenAPI 3.x document generation and documentation foundation for jsango",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@jsango/core": "1.0.0",
+    "@jsango/http": "1.0.0",
+    "@jsango/router": "1.0.0",
+    "@jsango/validation": "1.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flutterbuddy1/jsango.git",
+    "directory": "packages/openapi"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}