@kontract/adonis 0.1.0

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,GAMV,MAAM,2BAA2B,CAAA"}

package/dist/adapters/route-registrar.d.ts

@@ -0,0 +1,53 @@
+import type { Router, HttpContext } from '@adonisjs/core/http';
+import type { TSchema } from '@sinclair/typebox';
+/**
+ * Validation schemas for request data.
+ */
+export interface ValidationSchemas {
+    body?: TSchema;
+    query?: TSchema;
+    params?: TSchema;
+}
+/**
+ * Extended HttpContext with validated data and auth.
+ */
+export interface ValidatedContext extends HttpContext {
+    validatedBody?: unknown;
+    validatedQuery?: unknown;
+    validatedParams?: unknown;
+    auth: {
+        authenticate(): Promise<unknown>;
+    };
+}
+/**
+ * Validator function type.
+ */
+export type ValidateFn = <T>(schema: TSchema, data: unknown) => T;
+/**
+ * Options for registering decorator routes.
+ */
+export interface RegisterRoutesOptions {
+    /** Validation function (e.g., AJV validate) */
+    validate: ValidateFn;
+}
+/**
+ * Registers all routes defined via @Endpoint decorators.
+ * Call this in your routes.ts file after importing decorated controllers.
+ *
+ * @example
+ * ```typescript
+ * // start/routes.ts
+ * import router from '@adonisjs/core/services/router'
+ * import { registerDecoratorRoutes } from '@kontract/adonis'
+ * import { validate } from '#validators/ajv'
+ *
+ * // Import controllers to trigger decorator registration
+ * import '#controllers/games_controller'
+ * import '#controllers/books_controller'
+ *
+ * // Register all decorated routes
+ * registerDecoratorRoutes(router, { validate })
+ * ```
+ */
+export declare function registerDecoratorRoutes(router: Router, options: RegisterRoutesOptions): void;
+//# sourceMappingURL=route-registrar.d.ts.map

package/dist/adapters/route-registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-registrar.d.ts","sourceRoot":"","sources":["../../src/adapters/route-registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAShD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,IAAI,EAAE;QACJ,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;KACjC,CAAA;CACF;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,EAAE,UAAU,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAaN"}

package/dist/adapters/route-registrar.js

@@ -0,0 +1,139 @@
+import { getApiMetadata, getEndpointMetadata, getRegisteredControllers, isBinaryResponse, } from 'kontract';
+/**
+ * Registers all routes defined via @Endpoint decorators.
+ * Call this in your routes.ts file after importing decorated controllers.
+ *
+ * @example
+ * ```typescript
+ * // start/routes.ts
+ * import router from '@adonisjs/core/services/router'
+ * import { registerDecoratorRoutes } from '@kontract/adonis'
+ * import { validate } from '#validators/ajv'
+ *
+ * // Import controllers to trigger decorator registration
+ * import '#controllers/games_controller'
+ * import '#controllers/books_controller'
+ *
+ * // Register all decorated routes
+ * registerDecoratorRoutes(router, { validate })
+ * ```
+ */
+export function registerDecoratorRoutes(router, options) {
+    const controllers = getRegisteredControllers();
+    for (const controller of controllers) {
+        const apiMeta = getApiMetadata(controller);
+        const endpoints = getEndpointMetadata(controller);
+        if (!apiMeta || endpoints.length === 0)
+            continue;
+        for (const endpoint of endpoints) {
+            registerEndpoint(router, controller, endpoint, options.validate);
+        }
+    }
+}
+/**
+ * Register a single endpoint.
+ */
+function registerEndpoint(router, Controller, endpoint, validate) {
+    const { method, path, methodName, auth, body, query, params, middleware } = endpoint;
+    // Build validation schemas
+    const validationSchemas = {};
+    if (body)
+        validationSchemas.body = body;
+    if (query)
+        validationSchemas.query = query;
+    if (params)
+        validationSchemas.params = params;
+    // Create handler
+    const handler = createHandler(Controller, methodName, auth, validationSchemas, validate);
+    // Register the route
+    let route;
+    switch (method) {
+        case 'get':
+            route = router.get(path, handler);
+            break;
+        case 'post':
+            route = router.post(path, handler);
+            break;
+        case 'put':
+            route = router.put(path, handler);
+            break;
+        case 'patch':
+            route = router.patch(path, handler);
+            break;
+        case 'delete':
+            route = router.delete(path, handler);
+            break;
+    }
+    // Apply additional middleware (cast to expected type)
+    if (middleware && Array.isArray(middleware) && middleware.length > 0) {
+        route.use(middleware);
+    }
+}
+/**
+ * Create a request handler for an endpoint.
+ */
+function createHandler(Controller, methodName, auth, validationSchemas, validate) {
+    return async (ctx) => {
+        const validatedCtx = ctx;
+        // Handle authentication
+        if (auth === 'required') {
+            await validatedCtx.auth.authenticate();
+        }
+        else if (auth === 'optional') {
+            try {
+                await validatedCtx.auth.authenticate();
+            }
+            catch {
+                // Ignore auth failure for optional auth
+            }
+        }
+        // Validate request data
+        if (validationSchemas.body) {
+            validatedCtx.validatedBody = validate(validationSchemas.body, ctx.request.body());
+        }
+        if (validationSchemas.query) {
+            validatedCtx.validatedQuery = validate(validationSchemas.query, ctx.request.qs());
+        }
+        if (validationSchemas.params) {
+            validatedCtx.validatedParams = validate(validationSchemas.params, ctx.params);
+        }
+        const controller = await ctx.containerResolver.make(Controller);
+        const result = await controller[methodName](ctx, validatedCtx.validatedBody, validatedCtx.validatedQuery, validatedCtx.validatedParams);
+        // Handle the response
+        return handleResponse(ctx, result);
+    };
+}
+/**
+ * Handle the response from a controller method.
+ */
+function handleResponse(ctx, result) {
+    // Handle binary response (file downloads)
+    if (isBinaryResponse(result)) {
+        ctx.response.header('Content-Type', result.contentType);
+        if (result.filename) {
+            ctx.response.header('Content-Disposition', `attachment; filename="${result.filename}"`);
+        }
+        return ctx.response.status(result.status).send(result.data);
+    }
+    // Handle structured API response
+    if (isApiResponse(result)) {
+        if (result.status === 204) {
+            return ctx.response.noContent();
+        }
+        return ctx.response.status(result.status).json(result.data);
+    }
+    // Return raw result for backwards compatibility
+    return result;
+}
+/**
+ * Type guard for API responses.
+ */
+function isApiResponse(value) {
+    return (value !== null
+        && typeof value === 'object'
+        && 'status' in value
+        && 'data' in value
+        && !('binary' in value)
+        && typeof value.status === 'number');
+}
+//# sourceMappingURL=route-registrar.js.map

package/dist/adapters/route-registrar.js.map

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

package/dist/adapters/router.d.ts

@@ -0,0 +1,37 @@
+import type { Router, HttpContext } from '@adonisjs/core/http';
+import type { TSchema } from '@sinclair/typebox';
+import { type RouterAdapter } from 'kontract';
+/**
+ * Validation schemas for request data.
+ */
+export interface ValidationSchemas {
+    body?: TSchema;
+    query?: TSchema;
+    params?: TSchema;
+}
+/**
+ * Extended HttpContext with validated data.
+ */
+export interface ValidatedContext extends HttpContext {
+    validatedBody?: unknown;
+    validatedQuery?: unknown;
+    validatedParams?: unknown;
+}
+/**
+ * Validator function type.
+ */
+export type ValidateFn = <T>(schema: TSchema, data: unknown) => T;
+/**
+ * Options for creating the AdonisJS router adapter.
+ */
+export interface AdonisRouterAdapterOptions {
+    /** The AdonisJS router instance */
+    router: Router;
+    /** Validation function (e.g., AJV validate) */
+    validate: ValidateFn;
+}
+/**
+ * Create an AdonisJS router adapter.
+ */
+export declare function createAdonisRouterAdapter(options: AdonisRouterAdapterOptions): RouterAdapter;
+//# sourceMappingURL=router.d.ts.map

package/dist/adapters/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/adapters/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,QAAQ,EAAE,UAAU,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CA4Df"}

package/dist/adapters/router.js

@@ -0,0 +1,129 @@
+import { isBinaryResponse, } from '@blog/openapi-decorators';
+/**
+ * Create an AdonisJS router adapter.
+ */
+export function createAdonisRouterAdapter(options) {
+    const { router, validate } = options;
+    const registeredRoutes = [];
+    return {
+        register(method, path, _handler, metadata) {
+            const { methodName, auth, body, query, params, middleware } = metadata;
+            // Build validation schemas
+            const validationSchemas = {};
+            if (body)
+                validationSchemas.body = body;
+            if (query)
+                validationSchemas.query = query;
+            if (params)
+                validationSchemas.params = params;
+            // Create the handler
+            const handler = createHandler(metadata, methodName, auth, validationSchemas, validate);
+            // Register the route
+            let route;
+            switch (method) {
+                case 'get':
+                    route = router.get(path, handler);
+                    break;
+                case 'post':
+                    route = router.post(path, handler);
+                    break;
+                case 'put':
+                    route = router.put(path, handler);
+                    break;
+                case 'patch':
+                    route = router.patch(path, handler);
+                    break;
+                case 'delete':
+                    route = router.delete(path, handler);
+                    break;
+            }
+            // Apply additional middleware
+            if (middleware && Array.isArray(middleware) && middleware.length > 0) {
+                route.use(middleware);
+            }
+            registeredRoutes.push({ method, path });
+        },
+        getRoutes() {
+            return registeredRoutes;
+        },
+    };
+}
+/**
+ * Create a request handler for an endpoint.
+ */
+function createHandler(metadata, methodName, auth, validationSchemas, validate) {
+    // Get the controller class from metadata
+    // This will be set by the route registrar
+    let Controller = null;
+    return async (ctx) => {
+        const validatedCtx = ctx;
+        // Handle authentication
+        if (auth === 'required') {
+            await ctx.auth.authenticate();
+        }
+        else if (auth === 'optional') {
+            try {
+                await ctx.auth.authenticate();
+            }
+            catch {
+                // Ignore auth failure for optional auth
+            }
+        }
+        // Validate request data
+        if (validationSchemas.body) {
+            validatedCtx.validatedBody = validate(validationSchemas.body, ctx.request.body());
+        }
+        if (validationSchemas.query) {
+            validatedCtx.validatedQuery = validate(validationSchemas.query, ctx.request.qs());
+        }
+        if (validationSchemas.params) {
+            validatedCtx.validatedParams = validate(validationSchemas.params, ctx.params);
+        }
+        // Resolve controller from container
+        // The Controller will be passed via the metadata
+        if (!Controller) {
+            // For now, we'll need to get it from the route's controller reference
+            // This will be handled by the registration function
+            throw new Error(`Controller not found for endpoint ${methodName}. ` +
+                'Use registerDecoratorRoutes() to register routes.');
+        }
+        const controller = await ctx.containerResolver.make(Controller);
+        const result = await controller[methodName](ctx, validatedCtx.validatedBody, validatedCtx.validatedQuery, validatedCtx.validatedParams);
+        // Handle the response
+        return handleResponse(ctx, result);
+    };
+}
+/**
+ * Handle the response from a controller method.
+ */
+function handleResponse(ctx, result) {
+    // Handle binary response (file downloads)
+    if (isBinaryResponse(result)) {
+        ctx.response.header('Content-Type', result.contentType);
+        if (result.filename) {
+            ctx.response.header('Content-Disposition', `attachment; filename="${result.filename}"`);
+        }
+        return ctx.response.status(result.status).send(result.data);
+    }
+    // Handle structured API response
+    if (isApiResponse(result)) {
+        if (result.status === 204) {
+            return ctx.response.noContent();
+        }
+        return ctx.response.status(result.status).json(result.data);
+    }
+    // Return raw result for backwards compatibility
+    return result;
+}
+/**
+ * Type guard for API responses.
+ */
+function isApiResponse(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'status' in value &&
+        'data' in value &&
+        !('binary' in value) &&
+        typeof value.status === 'number');
+}
+//# sourceMappingURL=router.js.map

package/dist/adapters/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/adapters/router.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,gBAAgB,GACjB,MAAM,0BAA0B,CAAA;AAmCjC;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAmC;IAEnC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;IACpC,MAAM,gBAAgB,GAAgD,EAAE,CAAA;IAExE,OAAO;QACL,QAAQ,CACN,MAAkB,EAClB,IAAY,EACZ,QAAQ,EACR,QAA0B;YAE1B,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAA;YAEtE,2BAA2B;YAC3B,MAAM,iBAAiB,GAAsB,EAAE,CAAA;YAC/C,IAAI,IAAI;gBAAE,iBAAiB,CAAC,IAAI,GAAG,IAAI,CAAA;YACvC,IAAI,KAAK;gBAAE,iBAAiB,CAAC,KAAK,GAAG,KAAK,CAAA;YAC1C,IAAI,MAAM;gBAAE,iBAAiB,CAAC,MAAM,GAAG,MAAM,CAAA;YAE7C,qBAAqB;YACrB,MAAM,OAAO,GAAG,aAAa,CAC3B,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,iBAAiB,EACjB,QAAQ,CACT,CAAA;YAED,qBAAqB;YACrB,IAAI,KAAK,CAAA;YACT,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,KAAK;oBACR,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;oBACjC,MAAK;gBACP,KAAK,MAAM;oBACT,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;oBAClC,MAAK;gBACP,KAAK,KAAK;oBACR,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;oBACjC,MAAK;gBACP,KAAK,OAAO;oBACV,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;oBACnC,MAAK;gBACP,KAAK,QAAQ;oBACX,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;oBACpC,MAAK;YACT,CAAC;YAED,8BAA8B;YAC9B,IAAI,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YACvB,CAAC;YAED,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACzC,CAAC;QAED,SAAS;YACP,OAAO,gBAAgB,CAAA;QACzB,CAAC;KACF,CAAA;AACH,CAAC;AAUD;;GAEG;AACH,SAAS,aAAa,CACpB,QAA0B,EAC1B,UAAkB,EAClB,IAAsC,EACtC,iBAAoC,EACpC,QAAoB;IAEpB,yCAAyC;IACzC,0CAA0C;IAC1C,IAAI,UAAU,GAA2B,IAAI,CAAA;IAE7C,OAAO,KAAK,EAAE,GAAgB,EAAE,EAAE;QAChC,MAAM,YAAY,GAAG,GAAuB,CAAA;QAE5C,wBAAwB;QACxB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;QAC/B,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,iBAAiB,CAAC,IAAI,EAAE,CAAC;YAC3B,YAAY,CAAC,aAAa,GAAG,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QACnF,CAAC;QACD,IAAI,iBAAiB,CAAC,KAAK,EAAE,CAAC;YAC5B,YAAY,CAAC,cAAc,GAAG,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QACnF,CAAC;QACD,IAAI,iBAAiB,CAAC,MAAM,EAAE,CAAC;YAC7B,YAAY,CAAC,eAAe,GAAG,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QAC/E,CAAC;QAED,oCAAoC;QACpC,iDAAiD;QACjD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,sEAAsE;YACtE,oDAAoD;YACpD,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,IAAI;gBACnD,mDAAmD,CACpD,CAAA;QACH,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAU/D,MAAM,MAAM,GAAG,MAAO,UAA4C,CAAC,UAAU,CAAC,CAC5E,GAAG,EACH,YAAY,CAAC,aAAa,EAC1B,YAAY,CAAC,cAAc,EAC3B,YAAY,CAAC,eAAe,CAC7B,CAAA;QAED,sBAAsB;QACtB,OAAO,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,GAAgB,EAAE,MAAe;IACvD,0CAA0C;IAC1C,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;QACvD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,GAAG,CAAC,QAAQ,CAAC,MAAM,CACjB,qBAAqB,EACrB,yBAAyB,MAAM,CAAC,QAAQ,GAAG,CAC5C,CAAA;QACH,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7D,CAAC;IAED,iCAAiC;IACjC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAA;QACjC,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7D,CAAC;IAED,gDAAgD;IAChD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,KAAc;IAEd,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,MAAM,IAAI,KAAK;QACf,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC;QACpB,OAAQ,KAA6B,CAAC,MAAM,KAAK,QAAQ,CAC1D,CAAA;AACH,CAAC"}

package/dist/builder/index.d.ts

@@ -0,0 +1,2 @@
+export { OpenApiBuilder, type OpenApiBuilderOptions } from 'kontract';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAA"}

package/dist/builder/index.js

@@ -0,0 +1,3 @@
+// Re-export from core package
+export { OpenApiBuilder } from 'kontract';
+//# sourceMappingURL=index.js.map

package/dist/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EAAE,cAAc,EAA8B,MAAM,UAAU,CAAA"}

package/dist/builder/openapi-builder.d.ts

@@ -0,0 +1,100 @@
+import { type OpenApiDocument, type OpenApiVersion } from 'kontract';
+/**
+ * Options for building the OpenAPI document.
+ */
+export interface OpenApiBuilderOptions {
+    title: string;
+    description: string;
+    version: string;
+    servers: Array<{
+        url: string;
+        description: string;
+    }>;
+    /**
+     * OpenAPI specification version.
+     * @default '3.1.0'
+     */
+    openapiVersion?: OpenApiVersion;
+    /**
+     * Security scheme configuration.
+     * @default Bearer JWT authentication
+     */
+    securityScheme?: {
+        name: string;
+        type: 'http' | 'apiKey' | 'oauth2';
+        scheme?: string;
+        bearerFormat?: string;
+        description?: string;
+    };
+}
+/**
+ * Builds an OpenAPI specification from registered @Api and @Endpoint decorators.
+ *
+ * @example
+ * ```typescript
+ * const builder = new OpenApiBuilder({
+ *   title: 'My API',
+ *   description: 'API description',
+ *   version: '1.0.0',
+ *   servers: [{ url: 'http://localhost:3333', description: 'Development' }],
+ * })
+ *
+ * const spec = builder.build()
+ * ```
+ */
+export declare class OpenApiBuilder {
+    private document;
+    private schemas;
+    private tags;
+    private securitySchemeName;
+    constructor(options: OpenApiBuilderOptions);
+    /**
+     * Build the OpenAPI document from registered decorators.
+     */
+    build(): OpenApiDocument;
+    /**
+     * Process a single endpoint and add it to the document.
+     */
+    private processEndpoint;
+    /**
+     * Build file upload request body.
+     */
+    private buildFileRequestBody;
+    /**
+     * Build parameters from endpoint metadata.
+     */
+    private buildParameters;
+    /**
+     * Convert a TypeBox schema to OpenAPI parameters.
+     */
+    private schemaToParameters;
+    /**
+     * Build responses from endpoint metadata.
+     */
+    private buildResponses;
+    /**
+     * Register a schema and return its name.
+     */
+    private registerSchema;
+    /**
+     * Extract and register nested schemas with $id.
+     */
+    private extractNestedSchemas;
+    /**
+     * Convert TypeBox schema to JSON Schema (for OpenAPI).
+     */
+    private toJsonSchema;
+    /**
+     * Remove TypeBox-specific properties from schema.
+     */
+    private removeTypeBoxProps;
+    /**
+     * Generate an operation ID from endpoint metadata.
+     */
+    private generateOperationId;
+    /**
+     * Get default description for a status code.
+     */
+    private defaultDescription;
+}
+//# sourceMappingURL=openapi-builder.d.ts.map

package/dist/builder/openapi-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-builder.d.ts","sourceRoot":"","sources":["../../src/builder/openapi-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,cAAc,EAMpB,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;QAClC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAwC;IACpD,OAAO,CAAC,kBAAkB,CAAQ;gBAEtB,OAAO,EAAE,qBAAqB;IAgC1C;;OAEG;IACH,KAAK,IAAI,eAAe;IA+BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4DvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgD5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAc3B"}