@xemahq/platform-common 0.1.3

package/dist/nestjs/jwt-verification.guard.js

@@ -0,0 +1,232 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var JwtVerificationGuard_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JwtVerificationGuard = void 0;
+const common_1 = require("@nestjs/common");
+const decorator_metadata_1 = require("./decorator-metadata");
+const public_decorator_1 = require("./public.decorator");
+const auth_module_options_1 = require("./auth/auth-module-options");
+const request_context_1 = require("../lib/request-context");
+const jwks_verifier_1 = require("./jwks/jwks-verifier");
+const PUBLIC_PATH_PREFIXES = ['/health', '/api/docs', '/api/openapi.json'];
+const PUBLIC_WEBHOOK_PREFIX = '/webhooks';
+let JwtVerificationGuard = class JwtVerificationGuard {
+    static { JwtVerificationGuard_1 = this; }
+    authOptions;
+    logger = new common_1.Logger(JwtVerificationGuard_1.name);
+    jwks = new jwks_verifier_1.JwksVerifier(600_000);
+    static SINGLE_REALM_CACHE_KEY = '__single__';
+    multiRealmConfig = null;
+    resolvingConfig = null;
+    constructor(authOptions) {
+        this.authOptions = authOptions;
+    }
+    async canActivate(context) {
+        const isPublic = (0, decorator_metadata_1.readDecoratorOverride)(public_decorator_1.IS_PUBLIC_KEY, [
+            context.getHandler(),
+            context.getClass(),
+        ]);
+        if (isPublic)
+            return true;
+        const request = context.switchToHttp().getRequest();
+        const path = request.path ?? request.url?.split('?')[0] ?? '';
+        if (this.isPublicPath(path))
+            return true;
+        const authHeader = request.headers.authorization;
+        if (!authHeader?.startsWith('Bearer ')) {
+            throw new common_1.UnauthorizedException('Missing or invalid Authorization header');
+        }
+        const token = authHeader.substring(7);
+        try {
+            const payload = await this.verifyToken(token);
+            this.attachRealmToContext(request, payload);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof common_1.UnauthorizedException)
+                throw error;
+            const msg = error instanceof Error ? error.message : String(error);
+            this.logger.error({ message: 'JWT verification failed', error: msg });
+            throw new common_1.UnauthorizedException('Invalid token');
+        }
+    }
+    async verifyToken(token) {
+        const { payload } = this.decodeOrThrow(token);
+        const multiRealm = await this.resolveMultiRealmConfig();
+        if (multiRealm) {
+            await this.verifyMultiRealm(token, payload, multiRealm);
+        }
+        else {
+            await this.verifySingleRealm(token, payload);
+        }
+        return payload;
+    }
+    decodeOrThrow(token) {
+        try {
+            return this.jwks.decode(token);
+        }
+        catch (error) {
+            if (error instanceof jwks_verifier_1.JwksVerificationError) {
+                throw new common_1.UnauthorizedException(error.message);
+            }
+            throw error;
+        }
+    }
+    async verifyWithJwks(token, cacheKey, jwksUrl) {
+        try {
+            await this.jwks.verify(token, { cacheKey, jwksUrl });
+        }
+        catch (error) {
+            if (error instanceof jwks_verifier_1.JwksVerificationError) {
+                throw new common_1.UnauthorizedException(error.message);
+            }
+            throw error;
+        }
+    }
+    async verifyMultiRealm(token, payload, config) {
+        if (!payload.iss) {
+            throw new common_1.UnauthorizedException('Token missing required issuer claim');
+        }
+        const realmName = this.extractRealmFromIssuer(payload.iss);
+        if (!realmName) {
+            throw new common_1.UnauthorizedException('Cannot determine realm from token issuer');
+        }
+        if (!config.allowedRealms.has(realmName)) {
+            throw new common_1.UnauthorizedException(`Realm '${realmName}' is not allowed`);
+        }
+        const validIssuers = config.keycloakBaseUrls.map((base) => `${base}/realms/${realmName}`);
+        if (!validIssuers.includes(payload.iss) && !payload.iss.endsWith(`/realms/${realmName}`)) {
+            throw new common_1.UnauthorizedException('Invalid token issuer');
+        }
+        const jwksUrl = `${config.keycloakBaseUrls[0]}/realms/${realmName}/protocol/openid-connect/certs`;
+        await this.verifyWithJwks(token, realmName, jwksUrl);
+    }
+    async verifySingleRealm(token, payload) {
+        const expectedIssuer = this.authOptions?.issuer;
+        if (expectedIssuer) {
+            if (!payload.iss) {
+                throw new common_1.UnauthorizedException('Token missing required issuer claim');
+            }
+            const allowedIssuers = expectedIssuer.split(',').map((s) => s.trim());
+            const realmSuffixes = [
+                ...new Set(allowedIssuers.map((iss) => {
+                    const match = iss.match(/(\/realms\/[^/]+)$/);
+                    return match?.[1];
+                }).filter(Boolean)),
+            ];
+            const issuerMatched = allowedIssuers.includes(payload.iss) ||
+                realmSuffixes.some((suffix) => payload.iss.endsWith(suffix));
+            if (!issuerMatched) {
+                throw new common_1.UnauthorizedException('Invalid token issuer');
+            }
+        }
+        const jwksUrl = this.authOptions?.jwksUrl;
+        if (!jwksUrl) {
+            throw new Error('AuthModule jwksUrl is not configured');
+        }
+        await this.verifyWithJwks(token, JwtVerificationGuard_1.SINGLE_REALM_CACHE_KEY, jwksUrl);
+    }
+    async resolveMultiRealmConfig() {
+        if (this.multiRealmConfig)
+            return this.multiRealmConfig;
+        if (this.resolvingConfig)
+            return this.resolvingConfig;
+        this.resolvingConfig = (async () => {
+            try {
+                const keycloakBaseUrl = await this.resolveKeycloakBaseUrl();
+                const allowedRealmsRaw = await this.resolveAllowedRealms();
+                if (keycloakBaseUrl && allowedRealmsRaw.length > 0) {
+                    const keycloakBaseUrls = keycloakBaseUrl
+                        .split(',')
+                        .map((s) => s.trim().replace(/\/$/, ''));
+                    this.appendIssuerBaseUrls(keycloakBaseUrls);
+                    this.multiRealmConfig = {
+                        keycloakBaseUrls,
+                        allowedRealms: new Set(allowedRealmsRaw),
+                    };
+                    this.logger.log(`Multi-realm mode enabled: realms=[${allowedRealmsRaw.join(', ')}], base URLs=[${keycloakBaseUrls.join(', ')}]`);
+                    return this.multiRealmConfig;
+                }
+                return null;
+            }
+            finally {
+                this.resolvingConfig = null;
+            }
+        })();
+        return this.resolvingConfig;
+    }
+    async resolveKeycloakBaseUrl() {
+        if (this.authOptions?.keycloakBaseUrl)
+            return this.authOptions.keycloakBaseUrl;
+        if (this.authOptions?.keycloakBaseUrlProvider) {
+            return (await this.authOptions.keycloakBaseUrlProvider()) ?? undefined;
+        }
+        return undefined;
+    }
+    async resolveAllowedRealms() {
+        if (this.authOptions?.allowedRealms && this.authOptions.allowedRealms.length > 0) {
+            return this.authOptions.allowedRealms;
+        }
+        if (this.authOptions?.allowedRealmsProvider) {
+            return await this.authOptions.allowedRealmsProvider();
+        }
+        return [];
+    }
+    appendIssuerBaseUrls(keycloakBaseUrls) {
+        const issuerRaw = this.authOptions?.issuer;
+        if (!issuerRaw)
+            return;
+        for (const iss of issuerRaw.split(',').map((s) => s.trim())) {
+            const base = iss.replace(/\/realms\/[^/]+$/, '');
+            if (base && !keycloakBaseUrls.includes(base)) {
+                keycloakBaseUrls.push(base);
+            }
+        }
+    }
+    extractRealmFromIssuer(issuer) {
+        const match = issuer.match(/\/realms\/([^/]+)$/);
+        return match?.[1] ?? null;
+    }
+    attachRealmToContext(request, payload) {
+        if (!payload.iss)
+            return;
+        const realmName = this.extractRealmFromIssuer(payload.iss);
+        if (!realmName)
+            return;
+        const ctx = request[request_context_1.REQUEST_CONTEXT];
+        if (ctx) {
+            ctx.realmId = realmName;
+        }
+    }
+    isPublicPath(path) {
+        for (const prefix of PUBLIC_PATH_PREFIXES) {
+            if (path === prefix || path.startsWith(prefix + '/'))
+                return true;
+        }
+        if (path === PUBLIC_WEBHOOK_PREFIX ||
+            path.startsWith(PUBLIC_WEBHOOK_PREFIX + '/')) {
+            return true;
+        }
+        return false;
+    }
+};
+exports.JwtVerificationGuard = JwtVerificationGuard;
+exports.JwtVerificationGuard = JwtVerificationGuard = JwtVerificationGuard_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(auth_module_options_1.AUTH_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], JwtVerificationGuard);
+//# sourceMappingURL=jwt-verification.guard.js.map

package/dist/nestjs/jwt-verification.guard.js.map

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

package/dist/nestjs/openapi-docs.enricher.d.ts

@@ -0,0 +1,6 @@
+export interface OpenApiEnrichmentOptions {
+    serviceName: string;
+    serviceDescription: string;
+}
+export declare function enhanceOpenApiDocumentation(document: unknown, options: OpenApiEnrichmentOptions): void;
+//# sourceMappingURL=openapi-docs.enricher.d.ts.map

package/dist/nestjs/openapi-docs.enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-docs.enricher.d.ts","sourceRoot":"","sources":["../../src/nestjs/openapi-docs.enricher.ts"],"names":[],"mappings":"AA8DA,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAqVD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAkBN"}

package/dist/nestjs/openapi-docs.enricher.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enhanceOpenApiDocumentation = enhanceOpenApiDocumentation;
+const HTTP_METHODS = [
+    'get',
+    'put',
+    'post',
+    'delete',
+    'options',
+    'head',
+    'patch',
+    'trace',
+];
+const FIELD_EXAMPLE_BY_NAME = {
+    id: 'a3f84c60-40f9-4a9b-9f38-4a3db5f5d266',
+    orgId: 'org_4f2f9d8c',
+    organizationId: 'org_4f2f9d8c',
+    projectId: 'proj_8ac1f2d0',
+    pipelineRunId: 'run_7f8d5a21',
+    groupKey: 'implementation',
+    phaseKey: 'implementation',
+    status: 'active',
+    createdAt: '2026-04-07T12:00:00.000Z',
+    updatedAt: '2026-04-07T12:00:00.000Z',
+    deletedAt: '2026-04-07T12:00:00.000Z',
+    email: 'developer@example.com',
+    url: 'https://example.com/webhook',
+    webhookUrl: 'https://example.com/webhook',
+    name: 'Example Name',
+    title: 'Example Title',
+    slug: 'example-slug',
+    key: 'example_key',
+    description: 'Example description for this field.',
+    content: 'Example content payload',
+};
+function wordsFromIdentifier(value) {
+    return value
+        .replaceAll('{', '')
+        .replaceAll('}', '')
+        .replaceAll(/([a-z])([A-Z])/g, '$1 $2')
+        .split(/[_\-\s/]+/)
+        .map((part) => part.trim())
+        .filter(Boolean);
+}
+function toSentenceCase(value) {
+    if (!value)
+        return value;
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function humanize(value) {
+    return wordsFromIdentifier(value)
+        .map((word) => word.toLowerCase())
+        .join(' ');
+}
+function toPascalCase(value) {
+    return wordsFromIdentifier(value)
+        .map((word) => toSentenceCase(word.toLowerCase()))
+        .join('');
+}
+function nonPathSegments(path) {
+    return path
+        .split('/')
+        .map((segment) => segment.trim())
+        .filter((segment) => Boolean(segment) && !segment.startsWith('{'));
+}
+function getPrimaryResource(path) {
+    const segments = nonPathSegments(path);
+    if (segments.length === 0)
+        return 'resource';
+    return humanize(segments.at(-1) ?? 'resource');
+}
+function operationSummary(method, path) {
+    const resource = getPrimaryResource(path);
+    const hasPathParam = path.includes('{');
+    if (method === 'get') {
+        return hasPathParam
+            ? `Get ${resource} by identifier`
+            : `List ${resource}`;
+    }
+    if (method === 'post') {
+        return `Create ${resource}`;
+    }
+    if (method === 'put') {
+        return `Replace ${resource}`;
+    }
+    if (method === 'patch') {
+        return `Update ${resource}`;
+    }
+    if (method === 'delete') {
+        return `Delete ${resource}`;
+    }
+    return `${method.toUpperCase()} ${resource}`;
+}
+function operationDescription(method, path, serviceName) {
+    const summary = operationSummary(method, path);
+    return (`${summary} in ${serviceName}. ` +
+        'This endpoint is fully documented with request and response schemas, ' +
+        'including concrete examples to help consumers integrate correctly. ');
+}
+function defaultTagForPath(path) {
+    const segments = nonPathSegments(path);
+    if (segments.length === 0)
+        return 'General';
+    return toPascalCase(segments[0]);
+}
+function inferStringExample(schema) {
+    if (schema.format === 'date-time')
+        return '2026-04-07T12:00:00.000Z';
+    if (schema.format === 'date')
+        return '2026-04-07';
+    if (schema.format === 'uuid')
+        return 'a3f84c60-40f9-4a9b-9f38-4a3db5f5d266';
+    if (schema.format === 'email')
+        return 'developer@example.com';
+    if (schema.format === 'uri')
+        return 'https://example.com/resource';
+    return 'example-value';
+}
+function inferPrimitiveExample(propertyName, schema) {
+    if (schema.example !== undefined)
+        return schema.example;
+    if (schema.default !== undefined)
+        return schema.default;
+    if (schema.enum && schema.enum.length > 0)
+        return schema.enum[0];
+    if (FIELD_EXAMPLE_BY_NAME[propertyName] !== undefined) {
+        return FIELD_EXAMPLE_BY_NAME[propertyName];
+    }
+    if (schema.type === 'string') {
+        return inferStringExample(schema);
+    }
+    if (schema.type === 'integer' || schema.type === 'number')
+        return 1;
+    if (schema.type === 'boolean')
+        return true;
+    return null;
+}
+function buildSchemaExample(schema, propertyName = 'value') {
+    if (!schema)
+        return null;
+    if (schema.$ref)
+        return { reference: schema.$ref };
+    if (Array.isArray(schema.oneOf) && schema.oneOf.length > 0) {
+        return buildSchemaExample(schema.oneOf[0], propertyName);
+    }
+    if (Array.isArray(schema.anyOf) && schema.anyOf.length > 0) {
+        return buildSchemaExample(schema.anyOf[0], propertyName);
+    }
+    if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {
+        const merged = {};
+        schema.allOf.forEach((part) => {
+            const value = buildSchemaExample(part, propertyName);
+            if (value && typeof value === 'object' && !Array.isArray(value)) {
+                Object.assign(merged, value);
+            }
+        });
+        return Object.keys(merged).length > 0 ? merged : null;
+    }
+    if (schema.type === 'array') {
+        return [buildSchemaExample(schema.items, propertyName)];
+    }
+    if (schema.type === 'object' || schema.properties) {
+        const result = {};
+        const properties = schema.properties ?? {};
+        Object.entries(properties).forEach(([key, propertySchema]) => {
+            result[key] = buildSchemaExample(propertySchema, key);
+        });
+        if (Object.keys(result).length === 0 &&
+            schema.additionalProperties &&
+            typeof schema.additionalProperties === 'object') {
+            result.exampleKey = buildSchemaExample(schema.additionalProperties, 'exampleKey');
+        }
+        return result;
+    }
+    return inferPrimitiveExample(propertyName, schema);
+}
+function enrichSchemas(document) {
+    const schemas = document.components?.schemas;
+    if (!schemas)
+        return;
+    Object.entries(schemas).forEach(([schemaName, schema]) => {
+        const properties = schema.properties;
+        if (!properties)
+            return;
+        Object.entries(properties).forEach(([propertyName, propertySchema]) => {
+            if (!propertySchema.description) {
+                propertySchema.description =
+                    `The ${humanize(propertyName)} for ${humanize(schemaName)}.`;
+            }
+            if (propertySchema.example === undefined) {
+                propertySchema.example = buildSchemaExample(propertySchema, propertyName);
+            }
+        });
+    });
+}
+function ensureTagDescriptions(document) {
+    const tags = (document.tags ??= []);
+    const known = new Set(tags.map((tag) => tag.name));
+    Object.entries(document.paths ?? {}).forEach(([path, pathItem]) => {
+        HTTP_METHODS.forEach((method) => {
+            const operation = pathItem[method];
+            if (!operation)
+                return;
+            if (!operation.tags || operation.tags.length === 0) {
+                operation.tags = [defaultTagForPath(path)];
+            }
+            operation.tags.forEach((tagName) => {
+                if (known.has(tagName))
+                    return;
+                tags.push({
+                    name: tagName,
+                    description: `${tagName} endpoints in this service API.`,
+                });
+                known.add(tagName);
+            });
+        });
+    });
+    document.tags = tags.map((tag) => {
+        if (tag.description)
+            return tag;
+        return {
+            ...tag,
+            description: `${tag.name} endpoints in this service API.`,
+        };
+    });
+}
+function enrichOperations(document, options) {
+    Object.entries(document.paths ?? {}).forEach(([path, pathItem]) => {
+        HTTP_METHODS.forEach((method) => {
+            const operation = pathItem[method];
+            if (!operation)
+                return;
+            if (!operation.summary) {
+                operation.summary = operationSummary(method, path);
+            }
+            if (!operation.description) {
+                operation.description = operationDescription(method, path, options.serviceName);
+            }
+            if (!operation.operationId) {
+                const resource = toPascalCase(getPrimaryResource(path));
+                operation.operationId = `${method}${resource}`;
+            }
+            const requestBody = operation.requestBody;
+            const requestBodyContent = requestBody?.content;
+            if (!requestBodyContent)
+                return;
+            Object.values(requestBodyContent).forEach((mediaType) => {
+                if (mediaType.example !== undefined || mediaType.examples) {
+                    return;
+                }
+                const exampleValue = buildSchemaExample(mediaType.schema, 'request');
+                mediaType.examples = {
+                    default: {
+                        summary: 'Example request',
+                        value: exampleValue,
+                    },
+                };
+            });
+        });
+    });
+}
+const TENANT_HEADERS_DOC_SECTION = [
+    '',
+    '## Global request headers',
+    '',
+    'Every authenticated endpoint in this service expects the following headers.',
+    '`RequestContextMiddleware` enforces them and returns `400 Bad Request` when missing.',
+    '',
+    '| Header | Required | Purpose |',
+    '| --- | --- | --- |',
+    '| `Authorization: Bearer <jwt>` | yes | Keycloak access token (or service JWT for inter-service calls). |',
+    '| `X-Org-Id` | yes | Organization context. Frontend Orval clients attach it automatically from `cg_org_id` in `localStorage`. |',
+    '| `X-Project-Id` | conditional | Required for endpoints that call `requireProjectId`; optional otherwise. |',
+    '| `X-Correlation-Id` | optional | Request correlation id. Generated client-side when absent. |',
+].join('\n');
+function appendGlobalHeadersSection(description) {
+    if (description.includes('## Global request headers')) {
+        return description;
+    }
+    return `${description.trimEnd()}\n${TENANT_HEADERS_DOC_SECTION}\n`;
+}
+function enhanceOpenApiDocumentation(document, options) {
+    const openApiDocument = document;
+    openApiDocument.info ??= {
+        title: options.serviceName,
+        description: options.serviceDescription,
+    };
+    if (!openApiDocument.info.title) {
+        openApiDocument.info.title = options.serviceName;
+    }
+    openApiDocument.info.description = appendGlobalHeadersSection(openApiDocument.info.description || options.serviceDescription);
+    enrichSchemas(openApiDocument);
+    enrichOperations(openApiDocument, options);
+    ensureTagDescriptions(openApiDocument);
+}
+//# sourceMappingURL=openapi-docs.enricher.js.map

package/dist/nestjs/openapi-docs.enricher.js.map

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

package/dist/nestjs/pagination.d.ts

@@ -0,0 +1,25 @@
+export declare class PaginationQueryDto {
+    page?: number;
+    limit?: number;
+}
+export declare class PaginationMeta {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasMore: boolean;
+}
+export declare function parsePagination(query: {
+    page?: number;
+    limit?: number;
+}): {
+    skip: number;
+    take: number;
+    page: number;
+    limit: number;
+};
+export declare function buildPaginatedResponse<T>(items: T[], total: number, page: number, limit: number): {
+    data: T[];
+    pagination: PaginationMeta;
+};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/nestjs/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/nestjs/pagination.ts"],"names":[],"mappings":"AAsBA,qBAAa,kBAAkB;IAQ7B,IAAI,CAAC,EAAE,MAAM,CAAK;IAUlB,KAAK,CAAC,EAAE,MAAM,CAAM;CACrB;AAKD,qBAAa,cAAc;IACzB,KAAK,EAAG,MAAM,CAAC;IACf,IAAI,EAAG,MAAM,CAAC;IACd,KAAK,EAAG,MAAM,CAAC;IACf,UAAU,EAAG,MAAM,CAAC;IACpB,OAAO,EAAG,OAAO,CAAC;CACnB;AAeD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAYA;AAOD,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,cAAc,CAAA;CAAE,CAY3C"}