@venizia/ignis 0.1.1-9 → 0.2.0-0

package/dist/connectors/search/connector.d.ts

@@ -1,238 +0,0 @@
-import type { ISynonym } from '../../connectors/search/models';
-import type { ValueOrPromise } from '@venizia/ignis-helpers';
-import { BaseHelper } from '@venizia/ignis-helpers';
-export interface IImportResult<TResponse = unknown> {
-    count: {
-        success: number;
-        fail: number;
-    };
-    responses: TResponse[];
-}
-export interface IAliasInfo {
-    name: string;
-    collection: string;
-}
-export interface ISearchConnectorCallbacks {
-    onInitialized?: (opts: {
-        name: string;
-    }) => void;
-    onError?: (opts: {
-        name: string;
-        error: unknown;
-    }) => void;
-}
-/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */
-export interface ISearchResult<DocumentType extends object = object, HighlightType = unknown, FacetCountType = unknown, GroupedHitType = unknown> {
-    found: number;
-    isFoundExact: boolean;
-    outOf?: number;
-    searchTimeMs?: number;
-    hits?: Array<{
-        document: DocumentType;
-        highlight?: HighlightType;
-        highlights?: HighlightType[];
-        score?: number;
-    }>;
-    facetCounts?: FacetCountType[];
-    groupedHits?: GroupedHitType[];
-}
-export interface ISearchCollectionScoped<CreateSchema = unknown, Schema = unknown, FieldSchema = unknown> {
-    create(opts: {
-        schema: CreateSchema;
-    }): Promise<Schema | void>;
-    ensure(opts: {
-        schema: CreateSchema;
-    }): Promise<Schema>;
-    get(opts: {
-        name: string;
-    }): Promise<Schema>;
-    list(): Promise<Schema[]>;
-    exists(opts: {
-        name: string;
-    }): Promise<boolean>;
-    patchSchema(opts: {
-        name: string;
-        fields: FieldSchema[];
-    }): Promise<void>;
-    delete(opts: {
-        name: string;
-    }): Promise<boolean>;
-}
-/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */
-export interface ISearchAliasScoped {
-    upsert(opts: {
-        name: string;
-        collection: string;
-    }): Promise<void>;
-    get(opts: {
-        name: string;
-    }): Promise<IAliasInfo | null>;
-}
-/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */
-export interface ISearchSwapScoped {
-    indexes(opts: {
-        pairs: Array<[string, string]>;
-    }): Promise<void>;
-}
-export interface ISearchSynonymSetScoped {
-    upsert(opts: {
-        name: string;
-        items: ISynonym[];
-    }): Promise<void>;
-    get(opts: {
-        name: string;
-    }): Promise<ISynonym[] | null>;
-    list(): Promise<string[]>;
-    delete(opts: {
-        name: string;
-    }): Promise<boolean>;
-    link(opts: {
-        collection: string;
-        synonymSets: string[];
-    }): Promise<void>;
-}
-/** A flat per-collection synonym dictionary - no named, linkable set resource. */
-export interface ISearchSynonymScoped {
-    set(opts: {
-        collection: string;
-        items: ISynonym[];
-    }): Promise<void>;
-    get(opts: {
-        collection: string;
-    }): Promise<ISynonym[]>;
-    reset(opts: {
-        collection: string;
-    }): Promise<void>;
-}
-export interface ISearchDocumentScoped {
-    get<T extends object>(opts: {
-        collection: string;
-        id: string;
-    }): Promise<T>;
-    /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */
-    count(opts: {
-        collection: string;
-        filterBy?: string;
-    }): Promise<number>;
-    create<T extends object>(opts: {
-        collection: string;
-        document: T;
-    }): Promise<T>;
-    upsert<T extends object>(opts: {
-        collection: string;
-        document: T;
-    }): Promise<T>;
-    update<T extends object>(opts: {
-        collection: string;
-        id: string;
-        document: Partial<T>;
-    }): Promise<T>;
-    updateBy<T extends object>(opts: {
-        collection: string;
-        document: Partial<T>;
-        filterBy: string;
-    }): Promise<{
-        updatedCount: number;
-    }>;
-    delete(opts: {
-        collection: string;
-        id: string;
-    }): Promise<boolean>;
-    deleteBy(opts: {
-        collection: string;
-        filterBy: string;
-    }): Promise<number>;
-    deleteAll(opts: {
-        collection: string;
-    }): Promise<boolean>;
-    import<T extends object>(opts: {
-        collection: string;
-        documents: T[];
-        batchSize?: number;
-    }): Promise<IImportResult<unknown>>;
-    export(opts: {
-        collection: string;
-        filterBy?: string;
-        includeFields?: string[];
-    }): Promise<string>;
-}
-/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */
-export interface ISearchConnector {
-    getHealth(): Promise<{
-        ok: boolean;
-    }>;
-    ping(): Promise<boolean>;
-    collection: ISearchCollectionScoped;
-    document: ISearchDocumentScoped;
-    alias?: ISearchAliasScoped;
-    synonymSet?: ISearchSynonymSetScoped;
-    synonyms?: ISearchSynonymScoped;
-    swap?: ISearchSwapScoped;
-    search<TDocument extends object = object>(opts: {
-        collection: string;
-        params: unknown;
-    }): Promise<ISearchResult<TDocument>>;
-    multiSearch(opts: {
-        searches: unknown[];
-        union?: boolean;
-        commonParams?: unknown;
-        options?: unknown;
-    }): Promise<unknown>;
-}
-export declare abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {
-    constructor(opts: {
-        scope: string;
-        identifier: string;
-    });
-    ping(): Promise<boolean>;
-    protected assertNonEmpty(opts: {
-        value?: string | null;
-        name: string;
-        method: string;
-    }): void;
-    protected runEngineCall<T>(opts: {
-        method: string;
-        run: () => ValueOrPromise<T>;
-        tolerate?: {
-            when: (error: unknown) => boolean;
-            handle: (error: unknown) => ValueOrPromise<T>;
-        };
-    }): Promise<T>;
-    /** Which errors mean "not found" is engine-specific classification; the sanitized throw and the benign fallback are not. */
-    protected abstract isNotFoundError(opts: {
-        error: unknown;
-    }): boolean;
-    /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */
-    protected notFoundTolerance(opts: {
-        method: string;
-        subject: string;
-    }): {
-        when: (error: unknown) => boolean;
-        handle: (error: unknown) => never;
-    };
-    /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */
-    protected notFoundFallback<T>(opts: {
-        method: string;
-        message: string;
-        args?: unknown[];
-        fallback: T;
-    }): {
-        when: (error: unknown) => boolean;
-        handle: (error: unknown) => T;
-    };
-    abstract getHealth(): Promise<{
-        ok: boolean;
-    }>;
-    abstract collection: ISearchCollectionScoped;
-    abstract document: ISearchDocumentScoped;
-    abstract search<TDocument extends object = object>(opts: {
-        collection: string;
-        params: unknown;
-    }): Promise<ISearchResult<TDocument>>;
-    abstract multiSearch(opts: {
-        searches: unknown[];
-        union?: boolean;
-        commonParams?: unknown;
-    }): Promise<unknown>;
-}
-//# sourceMappingURL=connector.d.ts.map

package/dist/connectors/search/connector.d.ts.map

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

package/dist/connectors/search/connector.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseSearchConnector = void 0;
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const internal_1 = require("./internal");
-class BaseSearchConnector extends ignis_helpers_1.BaseHelper {
-    constructor(opts) {
-        super(opts);
-    }
-    async ping() {
-        const health = await this.getHealth();
-        return health.ok;
-    }
-    assertNonEmpty(opts) {
-        const { value, name, method } = opts;
-        if (!value || value.trim().length === 0) {
-            throw (0, ignis_helpers_1.getError)({ message: `[${method}] Missing or empty value | name: ${name}` });
-        }
-    }
-    // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.
-    async runEngineCall(opts) {
-        const { method, run, tolerate } = opts;
-        try {
-            const rs = await run();
-            return rs;
-        }
-        catch (error) {
-            if (tolerate?.when(error)) {
-                const rs = await tolerate.handle(error);
-                return rs;
-            }
-            // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.
-            if ((0, ignis_helpers_1.isApplicationError)(error)) {
-                throw error;
-            }
-            internal_1.SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });
-        }
-    }
-    /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */
-    notFoundTolerance(opts) {
-        const { method, subject } = opts;
-        return {
-            when: error => this.isNotFoundError({ error }),
-            handle: () => {
-                this.logger.for(method).debug('%s not found', subject);
-                internal_1.SearchConnectorInternal.throwNotFoundError({ method, subject });
-            },
-        };
-    }
-    /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */
-    notFoundFallback(opts) {
-        const { method, message, args, fallback } = opts;
-        return {
-            when: error => this.isNotFoundError({ error }),
-            handle: () => {
-                this.logger.for(method).debug(message, ...(args ?? []));
-                return fallback;
-            },
-        };
-    }
-}
-exports.BaseSearchConnector = BaseSearchConnector;
-//# sourceMappingURL=connector.js.map

package/dist/connectors/search/connector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/connectors/search/connector.ts"],"names":[],"mappings":";;;AAEA,0DAAkF;AAClF,yCAAqD;AA8IrD,MAAsB,mBAAoB,SAAQ,0BAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAA,wBAAQ,EAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,IAAA,kCAAkB,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,kCAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF;AAhGD,kDAgGC"}

package/dist/connectors/search/controllers/abstract.d.ts

@@ -1,27 +0,0 @@
-import type { TEntityDataObject, TRouteContext } from '../../../base/controllers';
-import { BaseRestController } from '../../../base/controllers';
-import type { AbstractEntity } from '../../../base/models';
-import type { TAnyObjectSchema } from '../../../utilities/schema.utility';
-import type { AnyType } from '@venizia/ignis-helpers';
-import type { Env, Schema } from 'hono';
-import type { ReadableSearchRepository } from '../repositories/core/readable';
-/** Base tier of a generated search controller: the repository handle plus the search / multi-search verbs; SearchControllerFactory returns a thin subclass that only builds route configs and wires them. */
-export declare abstract class AbstractSearchController<TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, TDataObject extends object = TEntityDataObject<TEntity>> extends BaseRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
-    repository: ReadableSearchRepository<TDataObject>;
-    constructor(opts: {
-        scope: string;
-        path: string;
-        isStrict?: boolean;
-        repository: ReadableSearchRepository<TDataObject>;
-        definitions: AnyType;
-    });
-    /** POST /search - single-collection keyword/semantic/hybrid/raw search. */
-    search(opts: {
-        context: TRouteContext<RouteEnv>;
-    }): Promise<import("../../../base/controllers").TJsonResponse<unknown, 200>>;
-    /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */
-    multiSearch(opts: {
-        context: TRouteContext<RouteEnv>;
-    }): Promise<import("../../../base/controllers").TJsonResponse<unknown, 200>>;
-}
-//# sourceMappingURL=abstract.d.ts.map

package/dist/connectors/search/controllers/abstract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAExC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E,6MAA6M;AAC7M,8BAAsB,wBAAwB,CAC5C,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CACvD,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAChF,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;QAClD,WAAW,EAAE,OAAO,CAAC;KACtB;IAMD,2EAA2E;IACrE,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;IAiBvD,sFAAsF;IAChF,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;CAY7D"}

package/dist/connectors/search/controllers/abstract.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractSearchController = void 0;
-const controllers_1 = require("../../../base/controllers");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-/** Base tier of a generated search controller: the repository handle plus the search / multi-search verbs; SearchControllerFactory returns a thin subclass that only builds route configs and wires them. */
-class AbstractSearchController extends controllers_1.BaseRestController {
-    constructor(opts) {
-        super({ scope: opts.scope, path: opts.path, isStrict: opts.isStrict });
-        this.repository = opts.repository;
-        this.definitions = opts.definitions;
-    }
-    /** POST /search - single-collection keyword/semantic/hybrid/raw search. */
-    async search(opts) {
-        const { context } = opts;
-        const input = context.req.valid('json');
-        const rs = await this.measure({
-            scope: 'search',
-            args: input,
-            task: async () => {
-                // `isFoundExact` travels to the caller so an engine whose `found` is an estimate never looks exhaustive across the HTTP boundary.
-                const { found, isFoundExact, hits } = await this.repository.search(input);
-                return { found, isFoundExact, hits: hits ?? [] };
-            },
-        });
-        return context.json(rs, ignis_helpers_1.HTTP.ResultCodes.RS_2.Ok);
-    }
-    /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */
-    async multiSearch(opts) {
-        const { context } = opts;
-        const input = context.req.valid('json');
-        const rs = await this.measure({
-            scope: 'multiSearch',
-            args: input,
-            task: () => this.repository.multiSearch(input),
-        });
-        return context.json(rs, ignis_helpers_1.HTTP.ResultCodes.RS_2.Ok);
-    }
-}
-exports.AbstractSearchController = AbstractSearchController;
-//# sourceMappingURL=abstract.js.map

package/dist/connectors/search/controllers/abstract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/abstract.ts"],"names":[],"mappings":";;;AACA,oDAAwD;AAIxD,0DAA8C;AAK9C,6MAA6M;AAC7M,MAAsB,wBAOpB,SAAQ,gCAAwE;IAGhF,YAAY,IAMX;QACC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,MAAM,CAAC,IAA0C;QACrD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAe,MAAM,CAAC,CAAC;QAEtD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAC5B,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,kIAAkI;gBAClI,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;YACnD,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,WAAW,CAAC,IAA0C;QAC1D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAoB,MAAM,CAAC,CAAC;QAE3D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAC5B,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC;SAC/C,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AArDD,4DAqDC"}