@buenojs/bueno 0.8.5 → 0.8.7

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

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

package/dist/middleware/built-in.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Built-in Middleware
+ *
+ * Common middleware utilities for logging, CORS, request ID, etc.
+ */
+import type { Context } from "../context";
+import type { Middleware } from "../index";
+export interface LoggerOptions {
+    format?: "json" | "text";
+    level?: "debug" | "info" | "warn" | "error";
+}
+export declare function logger(options?: LoggerOptions): Middleware;
+export interface CorsOptions {
+    origin?: string | string[] | ((origin: string) => string | undefined);
+    methods?: string[];
+    allowedHeaders?: string[];
+    exposedHeaders?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
+export declare function cors(options?: CorsOptions): Middleware;
+export interface RequestIdOptions {
+    header?: string;
+    generator?: () => string;
+}
+export declare function requestId(options?: RequestIdOptions): Middleware;
+export declare function timing(): Middleware;
+export interface SecurityHeadersOptions {
+    contentSecurityPolicy?: string;
+    xssProtection?: boolean;
+    frameGuard?: "DENY" | "SAMEORIGIN" | "ALLOW-FROM";
+    hsts?: boolean | {
+        maxAge?: number;
+        includeSubDomains?: boolean;
+    };
+}
+export declare function securityHeaders(options?: SecurityHeadersOptions): Middleware;
+export interface RateLimitOptions {
+    windowMs?: number;
+    max?: number;
+    keyGenerator?: (context: Context) => string;
+    handler?: (context: Context) => Response;
+}
+export declare function rateLimit(options?: RateLimitOptions): Middleware;
+export interface CompressionOptions {
+    threshold?: number;
+    types?: string[];
+}
+export declare function compression(options?: CompressionOptions): Middleware;
+//# sourceMappingURL=built-in.d.ts.map

package/dist/middleware/built-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.d.ts","sourceRoot":"","sources":["../../src/middleware/built-in.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,MAAM,WAAW,aAAa;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC5C;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,UAAU,CA+D9D;AAID,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CAuD1D;AAID,MAAM,WAAW,gBAAgB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CACzB;AAMD,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAkBpE;AAID,wBAAgB,MAAM,IAAI,UAAU,CAYnC;AAID,MAAM,WAAW,sBAAsB;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;IAClD,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAClE;AAED,wBAAgB,eAAe,CAC9B,OAAO,GAAE,sBAA2B,GAClC,UAAU,CAwCZ;AAID,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAgDpE;AAID,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,UAAU,CA4CxE"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Middleware System
+ *
+ * Provides a composable middleware pipeline with async/await support
+ * and context mutation capabilities.
+ */
+import type { Context } from "../context";
+/**
+ * Middleware function type
+ */
+export type Middleware = (context: Context, next: () => Promise<Response>) => Promise<Response> | Response;
+/**
+ * Route handler type
+ */
+export type Handler = (context: Context) => Promise<Response> | Response;
+/**
+ * Compose multiple middleware into a single function
+ * Following Koa-style middleware pattern
+ */
+export declare function compose(middleware: Middleware[]): (context: Context, handler: Handler) => Promise<Response>;
+export declare class Pipeline {
+    private middleware;
+    /**
+     * Add middleware to the pipeline
+     */
+    use(middleware: Middleware): this;
+    /**
+     * Execute the pipeline with a handler
+     */
+    execute(context: Context, handler: Handler): Promise<Response>;
+    /**
+     * Get middleware count
+     */
+    get length(): number;
+}
+/**
+ * Create a new middleware pipeline
+ */
+export declare function createPipeline(): Pipeline;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACxB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,KACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAIzE;;;GAGG;AACH,wBAAgB,OAAO,CACtB,UAAU,EAAE,UAAU,EAAE,GACtB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAyB3D;AAID,qBAAa,QAAQ;IACpB,OAAO,CAAC,UAAU,CAAoB;IAEtC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKjC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKpE;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bueno Migrations
+ *
+ * Database migration runner, builder, and helpers.
+ *
+ * @example
+ * import { createMigration, type MigrationRunner } from '@buenojs/bueno/migrations';
+ */
+export * from "../database/migrations";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/modules/filters.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Exception Filters System
+ *
+ * Filters catch exceptions thrown during request processing and transform
+ * them into appropriate responses. They act as error boundaries in the
+ * request pipeline.
+ *
+ * Execution Order:
+ * Incoming Request → Guards → Pipes → Handler → Filters (if error) → Error Response
+ */
+import type { Context } from "../context";
+import type { Token } from "../types";
+import { BuenoError, NotFoundError, ValidationError } from "../types";
+/**
+ * Exception filter interface
+ * Filters implement this interface to handle specific exception types
+ */
+export interface ExceptionFilter<T = Error> {
+    catch(exception: T, context: Context): Response | Promise<Response>;
+}
+/**
+ * Filter function type for functional filters
+ */
+export type FilterFn<T = Error> = (exception: T, context: Context) => Response | Promise<Response>;
+/**
+ * Filter type - can be a token, instance, or function
+ */
+export type Filter<T = Error> = Token<ExceptionFilter<T>> | ExceptionFilter<T> | FilterFn<T>;
+type Constructor = new (...args: unknown[]) => unknown;
+/**
+ * Decorator to apply filters to a controller class or method
+ * Filters are executed in order: global → class → method
+ *
+ * @param filters - Filters to apply
+ * @returns ClassDecorator & MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * @Controller('users')
+ * @UseFilters(CustomExceptionFilter)  // Applied to all methods
+ * class UsersController {
+ *   @Get(':id')
+ *   @UseFilters(NotFoundExceptionFilter)  // Additional filter for this method
+ *   getUser() {}
+ * }
+ * ```
+ */
+export declare function UseFilters(...filters: Filter[]): MethodDecorator & ClassDecorator;
+/**
+ * Decorator to mark a filter as catching a specific exception type
+ *
+ * @param exceptionType - The exception class to catch
+ * @returns ClassDecorator
+ *
+ * @example
+ * ```typescript
+ * @Catch(ValidationError)
+ * @Injectable()
+ * class CustomValidationFilter implements ExceptionFilter<ValidationError> {
+ *   catch(exception: ValidationError, context: Context): Response {
+ *     return context.status(422).json({
+ *       error: 'Validation Failed',
+ *       issues: exception.issues
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare function Catch<T extends Error>(exceptionType: new (...args: never[]) => T): ClassDecorator;
+/**
+ * Get class-level filters from a controller
+ */
+export declare function getClassFilters(target: Constructor): Filter[] | undefined;
+/**
+ * Get method-level filters from a controller method
+ */
+export declare function getMethodFilters(target: object, propertyKey: string | symbol): Filter[] | undefined;
+/**
+ * Get the exception type that a filter catches
+ */
+export declare function getCatchType(filter: Filter): (new (...args: unknown[]) => Error) | undefined;
+/**
+ * Check if a filter can handle a specific exception
+ */
+export declare function canHandleException(filter: Filter, exception: Error): boolean;
+/**
+ * Type guard to check if a value is an ExceptionFilter instance
+ */
+export declare function isExceptionFilter(value: unknown): value is ExceptionFilter;
+/**
+ * Type guard to check if a value is a FilterFn
+ */
+export declare function isFilterFn(value: unknown): value is FilterFn;
+/**
+ * Execute a filter and return the response
+ */
+export declare function executeFilter(filter: Filter, exception: Error, context: Context, resolveFilter?: (filter: Filter) => ExceptionFilter | null): Promise<Response>;
+/**
+ * Options for executing filters
+ */
+export interface ExecuteFiltersOptions {
+    globalFilters: Filter[];
+    classFilters: Filter[];
+    methodFilters: Filter[];
+    resolveFilter?: (filter: Filter) => ExceptionFilter | null;
+}
+/**
+ * Find and execute the appropriate filter for an exception
+ * Filters are checked in order: method → class → global
+ * The first filter that can handle the exception is used
+ */
+export declare function findAndExecuteFilter(exception: Error, context: Context, options: ExecuteFiltersOptions): Promise<Response>;
+/**
+ * HttpExceptionFilter - Handles BuenoError exceptions
+ * Returns appropriate HTTP status codes and error details
+ */
+export declare class HttpExceptionFilter implements ExceptionFilter<BuenoError> {
+    catch(exception: BuenoError, context: Context): Response;
+}
+/**
+ * ValidationFilter - Handles ValidationError exceptions
+ * Returns validation error details with issues list
+ */
+export declare class ValidationFilter implements ExceptionFilter<ValidationError> {
+    catch(exception: ValidationError, context: Context): Response;
+}
+/**
+ * NotFoundFilter - Handles NotFoundError exceptions
+ * Returns 404 response with resource not found message
+ */
+export declare class NotFoundFilter implements ExceptionFilter<NotFoundError> {
+    catch(exception: NotFoundError, context: Context): Response;
+}
+/**
+ * AllExceptionsFilter - Catch-all filter for any Error
+ * This filter handles all unhandled exceptions
+ */
+export declare class AllExceptionsFilter implements ExceptionFilter<Error> {
+    catch(exception: Error, context: Context): Response;
+}
+/**
+ * Create a default error response when no filter matches
+ */
+export declare function createDefaultErrorResponse(exception: Error, context: Context): Response;
+/**
+ * Create an internal error response
+ */
+export declare function createInternalErrorResponse(exception: Error): Response;
+export {};
+//# sourceMappingURL=filters.d.ts.map

package/dist/modules/filters.d.ts.map

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

package/dist/modules/guards.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Guards System
+ *
+ * Guards determine whether a request should be allowed to proceed to the handler.
+ * They run before interceptors and pipes in the request pipeline.
+ *
+ * Execution Order:
+ * Incoming Request → Guards → Interceptors → Pipes → Handler
+ *
+ * If any guard returns false, the request is rejected with 403 Forbidden.
+ */
+import type { Token } from "../container";
+import type { Context } from "../context";
+/**
+ * Guard interface for authorization checks
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class AuthGuard implements CanActivate {
+ *   canActivate(context: Context): boolean {
+ *     return !!context.request.headers.get('Authorization');
+ *   }
+ * }
+ * ```
+ */
+export interface CanActivate {
+    canActivate(context: Context): boolean | Promise<boolean>;
+}
+/**
+ * Guard function type (for functional guards)
+ *
+ * @example
+ * ```typescript
+ * const authGuard: GuardFn = (context) => {
+ *   return !!context.request.headers.get('Authorization');
+ * };
+ * ```
+ */
+export type GuardFn = (context: Context) => boolean | Promise<boolean>;
+/**
+ * Guard type - can be:
+ * - A token for a guard class registered in the container
+ * - A guard class instance
+ * - A guard function
+ */
+export type Guard = Token<CanActivate> | CanActivate | GuardFn;
+type Constructor = new (...args: unknown[]) => unknown;
+/**
+ * Get guards from a class constructor
+ */
+export declare function getClassGuards(target: Constructor): Guard[] | undefined;
+/**
+ * Get guards from a method
+ */
+export declare function getMethodGuards(target: object, propertyKey: string | symbol): Guard[] | undefined;
+/**
+ * Decorator to apply guards to a controller class or method.
+ * Guards are executed in the order they are provided.
+ *
+ * @param guards - Guards to apply
+ * @returns ClassDecorator & MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * // Apply to all methods in controller
+ * @Controller('users')
+ * @UseGuards(AuthGuard)
+ * class UsersController {
+ *   @Get()
+ *   getUsers() {} // Protected by AuthGuard
+ *
+ *   @Get(':id')
+ *   @UseGuards(RolesGuard) // Additional guard
+ *   getUser() {} // Protected by AuthGuard AND RolesGuard
+ * }
+ * ```
+ */
+export declare function UseGuards(...guards: Guard[]): MethodDecorator & ClassDecorator;
+/**
+ * AuthGuard - Checks for Authorization header
+ *
+ * This guard verifies that the request has an Authorization header.
+ * It does not validate the token - that should be done by a custom guard.
+ *
+ * @example
+ * ```typescript
+ * @Controller('api')
+ * @UseGuards(AuthGuard)
+ * class ApiController {
+ *   @Get('protected')
+ *   protectedRoute() {} // Requires Authorization header
+ * }
+ * ```
+ */
+export declare class AuthGuard implements CanActivate {
+    canActivate(context: Context): boolean;
+}
+/**
+ * Get required roles from a method
+ */
+export declare function getMethodRoles(target: object, propertyKey: string | symbol): string[] | undefined;
+/**
+ * Decorator to specify required roles for a route
+ * Must be used in conjunction with RolesGuard
+ *
+ * @param roles - Required roles
+ * @returns MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * @Controller('admin')
+ * @UseGuards(AuthGuard, RolesGuard)
+ * class AdminController {
+ *   @Get('users')
+ *   @Roles('admin', 'moderator')
+ *   getUsers() {} // Requires 'admin' or 'moderator' role
+ * }
+ * ```
+ */
+export declare function Roles(...roles: string[]): MethodDecorator;
+/**
+ * User interface for type safety
+ * Applications should extend this interface with their user type
+ */
+export interface User {
+    id: string | number;
+    roles?: string[];
+}
+/**
+ * Context extension for user data
+ * This extends the Context type to include user information
+ */
+declare module "../context" {
+    interface Context {
+        user?: User;
+    }
+}
+/**
+ * RolesGuard - Checks user roles
+ *
+ * This guard checks if the authenticated user has the required roles.
+ * It should be used after AuthGuard in the guard chain.
+ *
+ * The user object must be set on the context before this guard runs.
+ * This is typically done by an authentication middleware or a previous guard.
+ *
+ * @example
+ * ```typescript
+ * @Controller('admin')
+ * @UseGuards(AuthGuard, RolesGuard)
+ * class AdminController {
+ *   @Get('dashboard')
+ *   @Roles('admin')
+ *   getDashboard() {} // Requires 'admin' role
+ * }
+ * ```
+ */
+export declare class RolesGuard implements CanActivate {
+    canActivate(context: Context): boolean;
+}
+/**
+ * Guard executor options
+ */
+export interface GuardExecutorOptions {
+    /** Global guards applied to all routes */
+    globalGuards?: Guard[];
+    /** Guards from controller class */
+    classGuards?: Guard[];
+    /** Guards from method */
+    methodGuards?: Guard[];
+    /** Container for resolving guard instances */
+    resolveGuard?: (guard: Guard) => CanActivate | GuardFn | null;
+}
+/**
+ * Execute guards in order and return whether the request should proceed
+ *
+ * @param context - Request context
+ * @param options - Guard executor options
+ * @returns true if all guards pass, false otherwise
+ */
+export declare function executeGuards(context: Context, options: GuardExecutorOptions): Promise<boolean>;
+/**
+ * Create a 403 Forbidden response
+ */
+export declare function createForbiddenResponse(): Response;
+export {};
+//# sourceMappingURL=guards.d.ts.map

package/dist/modules/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/modules/guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC3B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,OAAO,CAAC;AAU/D,KAAK,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAkBvD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,SAAS,CAEvE;AAgBD;;GAEG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC1B,KAAK,EAAE,GAAG,SAAS,CAErB;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CACxB,GAAG,MAAM,EAAE,KAAK,EAAE,GAChB,eAAe,GAAG,cAAc,CAoBlC;AAID;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,YAAW,WAAW;IAC5C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;CAItC;AA2BD;;GAEG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC1B,MAAM,EAAE,GAAG,SAAS,CAEtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAUzD;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,OAAO,QAAQ,YAAY,CAAC;IAC3B,UAAU,OAAO;QAChB,IAAI,CAAC,EAAE,IAAI,CAAC;KACZ;CACD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC7C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;CAkBtC;AAID;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IACvB,mCAAmC;IACnC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC;IACtB,yBAAyB;IACzB,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IACvB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAyElB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,QAAQ,CAclD"}