@golemio/core 3.2.0-dev.2591250520 → 3.2.0-dev.2601914129

package/dist/helpers/data-access/opensearch/OpenSearchSyncOrchestrator.js

@@ -47,7 +47,7 @@ class OpenSearchSyncOrchestrator {
             }
             catch (error) {
                 const wrappedError = new errors_1.RecoverableError(`initIndexes(${syncableIndex.baseName}) failed`, this.constructor.name, error);
-                this.logger.error(wrappedError.message, wrappedError);
+                this.logger.error(wrappedError);
                 failed.push(syncableIndex.baseName);
             }
         }

package/dist/helpers/data-access/opensearch/OpenSearchSyncOrchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"OpenSearchSyncOrchestrator.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/OpenSearchSyncOrchestrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OpenSearchSyncOrchestrator.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/OpenSearchSyncOrchestrator.ts"],"names":[],"mappings":"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"}

package/dist/helpers/data-access/opensearch/czechAnalysis.d.ts

@@ -0,0 +1,14 @@
+import { Types } from "@opensearch-project/opensearch";
+export interface ICzechAnalysisOptions {
+    synonyms?: string[];
+    edgeNgramMin?: number;
+    edgeNgramMax?: number;
+}
+export interface IBaseIndexSettingsOptions extends ICzechAnalysisOptions {
+    numberOfShards?: number;
+}
+type Analysis = Types.Indices_Common.IndexSettingsAnalysis;
+export declare const buildCzechAnalysis: (options?: ICzechAnalysisOptions) => Analysis;
+export declare const buildBaseIndexSettings: (options?: IBaseIndexSettingsOptions) => Types.Indices_Common.IndexSettings;
+export declare const czechText: () => Types.Common_Mapping.TextProperty;
+export {};

package/dist/helpers/data-access/opensearch/czechAnalysis.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.czechText = exports.buildBaseIndexSettings = exports.buildCzechAnalysis = void 0;
+// Reusable Czech analysis recipe (holds no vocabulary; the caller passes synonyms in). czechText()
+// maps each field via a hunspell lemma path (ranking) plus an edge_ngram ".prefix" sub-field
+// (prefix/derivational recall), and — when `synonyms` is given — a query-time synonym_graph.
+//
+// hunspell needs the cs_CZ dictionary on every node, and the filter ordering below is load-bearing.
+// Full rationale (paths, ordering trap, dependency caveat) lives in docs/opensearch-czech-search.md.
+// Changing this analysis is a mapping change: existing indexes must be dropped, recreated, and reseeded.
+const HUNSPELL_LOCALE = "cs_CZ";
+const DEFAULT_EDGE_NGRAM_MIN = 2;
+const DEFAULT_EDGE_NGRAM_MAX = 20;
+const buildCzechAnalysis = (options = {}) => {
+    const synonyms = options.synonyms ?? [];
+    const edgeNgramMin = options.edgeNgramMin ?? DEFAULT_EDGE_NGRAM_MIN;
+    const edgeNgramMax = options.edgeNgramMax ?? DEFAULT_EDGE_NGRAM_MAX;
+    const hasSynonyms = synonyms.length > 0;
+    const filter = {
+        czech_stop: { type: "stop", stopwords: "_czech_" },
+        cs_hunspell: { type: "hunspell", locale: HUNSPELL_LOCALE, dedup: true },
+        cs_edge_ngram: { type: "edge_ngram", min_gram: edgeNgramMin, max_gram: edgeNgramMax },
+    };
+    if (hasSynonyms) {
+        // synonym_graph is search-time only; wired into cs_lemma_search, never an index-time analyzer.
+        filter.cs_synonym = { type: "synonym_graph", synonyms };
+    }
+    // Search-time twin of cs_lemma. cs_synonym must precede czech_stop or synonym_graph rejects
+    // multi-word entries with an inner stopword — see docs/opensearch-czech-search.md.
+    const lemmaSearchFilter = hasSynonyms
+        ? ["lowercase", "cs_synonym", "czech_stop", "cs_hunspell", "asciifolding"]
+        : ["lowercase", "czech_stop", "cs_hunspell", "asciifolding"];
+    return {
+        filter,
+        analyzer: {
+            // asciifolding runs after hunspell so it still sees the diacritic-bearing form to look up.
+            cs_lemma: {
+                type: "custom",
+                tokenizer: "standard",
+                filter: ["lowercase", "czech_stop", "cs_hunspell", "asciifolding"],
+            },
+            cs_lemma_search: { type: "custom", tokenizer: "standard", filter: lemmaSearchFilter },
+            // Index side stores prefixes; query side matches the whole token against them (no ngram).
+            cs_prefix_index: { type: "custom", tokenizer: "standard", filter: ["lowercase", "asciifolding", "cs_edge_ngram"] },
+            cs_prefix_search: { type: "custom", tokenizer: "standard", filter: ["lowercase", "asciifolding"] },
+        },
+    };
+};
+exports.buildCzechAnalysis = buildCzechAnalysis;
+// min_gram..max_gram spans more than the default allowed ngram diff of 1, so the index must raise
+// max_ngram_diff or edge_ngram creation is rejected.
+const buildBaseIndexSettings = (options = {}) => {
+    const edgeNgramMin = options.edgeNgramMin ?? DEFAULT_EDGE_NGRAM_MIN;
+    const edgeNgramMax = options.edgeNgramMax ?? DEFAULT_EDGE_NGRAM_MAX;
+    return {
+        number_of_shards: options.numberOfShards ?? 1,
+        max_ngram_diff: edgeNgramMax - edgeNgramMin,
+        analysis: (0, exports.buildCzechAnalysis)(options),
+    };
+};
+exports.buildBaseIndexSettings = buildBaseIndexSettings;
+// Lemma field for ranking + a ".prefix" edge_ngram sub-field for derivational/prefix recall. The
+// analyzer names match those produced by buildCzechAnalysis.
+const czechText = () => ({
+    type: "text",
+    analyzer: "cs_lemma",
+    search_analyzer: "cs_lemma_search",
+    fields: {
+        prefix: { type: "text", analyzer: "cs_prefix_index", search_analyzer: "cs_prefix_search" },
+    },
+});
+exports.czechText = czechText;
+//# sourceMappingURL=czechAnalysis.js.map

package/dist/helpers/data-access/opensearch/czechAnalysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"czechAnalysis.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/czechAnalysis.ts"],"names":[],"mappings":"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"}

package/dist/helpers/data-access/opensearch/expandAcronyms.d.ts

@@ -0,0 +1 @@
+export declare const expandAcronyms: (query: string, expansions: Record<string, string>) => string;

package/dist/helpers/data-access/opensearch/expandAcronyms.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandAcronyms = void 0;
+// Appends the full form of every query token that is a known acronym, keeping the original tokens (so
+// a literal-acronym match still fires) — forward-only and additive, never a substitution. `expansions`
+// is the caller's lowercased acronym -> full-form map; matching is case-insensitive. Why this runs in
+// the query layer (not as an index synonym) and why both forms are kept: docs/opensearch-czech-search.md.
+const expandAcronyms = (query, expansions) => {
+    const matched = [];
+    for (const token of query.split(/\s+/)) {
+        const expansion = expansions[token.toLowerCase()];
+        if (expansion) {
+            matched.push(expansion);
+        }
+    }
+    return matched.length > 0 ? `${query} ${matched.join(" ")}` : query;
+};
+exports.expandAcronyms = expandAcronyms;
+//# sourceMappingURL=expandAcronyms.js.map

package/dist/helpers/data-access/opensearch/expandAcronyms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expandAcronyms.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/expandAcronyms.ts"],"names":[],"mappings":";;;AAAA,sGAAsG;AACtG,uGAAuG;AACvG,sGAAsG;AACtG,0GAA0G;AACnG,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,UAAkC,EAAU,EAAE;IACxF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACpC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,IAAI,SAAS,EAAE;YACX,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;SAC3B;KACJ;IAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACxE,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB"}

package/dist/helpers/data-access/opensearch/index.d.ts

@@ -1,4 +1,8 @@
-export { czechAnalysis, defaultIndexSettings, czechText } from "./czechAnalyzer";
+export { buildCzechAnalysis, buildBaseIndexSettings, czechText } from "./czechAnalysis";
+export type { ICzechAnalysisOptions, IBaseIndexSettingsOptions } from "./czechAnalysis";
+export { expandAcronyms } from "./expandAcronyms";
+export { buildLiveSearchQuery } from "./liveSearchQuery";
+export type { ILiveSearchQueryOptions, IFuzzyOptions } from "./liveSearchQuery";
 export { OpenSearchConnector } from "./OpenSearchConnector";
 export type { IOpenSearchConnector } from "./IOpenSearchConnector";
 export { OpenSearchService } from "./OpenSearchService";

package/dist/helpers/data-access/opensearch/index.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenSearchSyncOrchestrator = exports.OpenSearchService = exports.OpenSearchConnector = exports.czechText = exports.defaultIndexSettings = exports.czechAnalysis = void 0;
-var czechAnalyzer_1 = require("./czechAnalyzer");
-Object.defineProperty(exports, "czechAnalysis", { enumerable: true, get: function () { return czechAnalyzer_1.czechAnalysis; } });
-Object.defineProperty(exports, "defaultIndexSettings", { enumerable: true, get: function () { return czechAnalyzer_1.defaultIndexSettings; } });
-Object.defineProperty(exports, "czechText", { enumerable: true, get: function () { return czechAnalyzer_1.czechText; } });
+exports.OpenSearchSyncOrchestrator = exports.OpenSearchService = exports.OpenSearchConnector = exports.buildLiveSearchQuery = exports.expandAcronyms = exports.czechText = exports.buildBaseIndexSettings = exports.buildCzechAnalysis = void 0;
+var czechAnalysis_1 = require("./czechAnalysis");
+Object.defineProperty(exports, "buildCzechAnalysis", { enumerable: true, get: function () { return czechAnalysis_1.buildCzechAnalysis; } });
+Object.defineProperty(exports, "buildBaseIndexSettings", { enumerable: true, get: function () { return czechAnalysis_1.buildBaseIndexSettings; } });
+Object.defineProperty(exports, "czechText", { enumerable: true, get: function () { return czechAnalysis_1.czechText; } });
+var expandAcronyms_1 = require("./expandAcronyms");
+Object.defineProperty(exports, "expandAcronyms", { enumerable: true, get: function () { return expandAcronyms_1.expandAcronyms; } });
+var liveSearchQuery_1 = require("./liveSearchQuery");
+Object.defineProperty(exports, "buildLiveSearchQuery", { enumerable: true, get: function () { return liveSearchQuery_1.buildLiveSearchQuery; } });
 var OpenSearchConnector_1 = require("./OpenSearchConnector");
 Object.defineProperty(exports, "OpenSearchConnector", { enumerable: true, get: function () { return OpenSearchConnector_1.OpenSearchConnector; } });
 var OpenSearchService_1 = require("./OpenSearchService");

package/dist/helpers/data-access/opensearch/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/index.ts"],"names":[],"mappings":";;;AAAA,iDAAiF;AAAxE,8GAAA,aAAa,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAAE,0GAAA,SAAS,OAAA;AACvD,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAG1B,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/index.ts"],"names":[],"mappings":";;;AAAA,iDAAwF;AAA/E,mHAAA,kBAAkB,OAAA;AAAE,uHAAA,sBAAsB,OAAA;AAAE,0GAAA,SAAS,OAAA;AAE9D,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,qDAAyD;AAAhD,uHAAA,oBAAoB,OAAA;AAE7B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAG1B,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA"}

package/dist/helpers/data-access/opensearch/liveSearchQuery.d.ts

@@ -0,0 +1,18 @@
+import { API, Types } from "@opensearch-project/opensearch";
+type QueryContainer = Types.Common_QueryDsl.QueryContainer;
+type SearchRequestBody = API.Search_RequestBody;
+export interface IFuzzyOptions {
+    fields?: string[];
+    fuzziness?: string;
+}
+export interface ILiveSearchQueryOptions {
+    query: string;
+    fields: string[];
+    limit?: number;
+    offset?: number;
+    filter?: QueryContainer[];
+    wildcardFields?: string[];
+    fuzzy?: boolean | IFuzzyOptions;
+}
+export declare const buildLiveSearchQuery: (options: ILiveSearchQueryOptions) => SearchRequestBody;
+export {};

package/dist/helpers/data-access/opensearch/liveSearchQuery.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLiveSearchQuery = void 0;
+const DEFAULT_SEARCH_LIMIT = 10;
+const DEFAULT_FUZZINESS = "AUTO";
+const PREFIX_SUBFIELD_SUFFIX = ".prefix";
+const buildLiveSearchQuery = (options) => {
+    const trimmed = options.query.trim();
+    const bool = { filter: options.filter ?? [] };
+    if (!trimmed) {
+        bool.must = [{ match_all: {} }];
+    }
+    else {
+        const shoulds = [{ multi_match: { query: trimmed, fields: options.fields, type: "bool_prefix" } }];
+        const fuzzy = options.fuzzy ?? true;
+        if (fuzzy !== false) {
+            const fuzzyOptions = typeof fuzzy === "object" ? fuzzy : {};
+            const fuzzyFields = fuzzyOptions.fields ?? options.fields.filter((field) => !field.endsWith(PREFIX_SUBFIELD_SUFFIX));
+            shoulds.push({
+                multi_match: { query: trimmed, fields: fuzzyFields, fuzziness: fuzzyOptions.fuzziness ?? DEFAULT_FUZZINESS },
+            });
+        }
+        if (options.wildcardFields?.length) {
+            const escaped = trimmed.replace(/[\\*?]/g, "\\$&");
+            for (const field of options.wildcardFields) {
+                shoulds.push({ wildcard: { [field]: { value: `*${escaped}*`, case_insensitive: true } } });
+            }
+        }
+        bool.should = shoulds;
+        bool.minimum_should_match = 1;
+    }
+    return {
+        query: { bool },
+        _source: false,
+        from: options.offset ?? 0,
+        size: options.limit ?? DEFAULT_SEARCH_LIMIT,
+        track_total_hits: true,
+    };
+};
+exports.buildLiveSearchQuery = buildLiveSearchQuery;
+//# sourceMappingURL=liveSearchQuery.js.map

package/dist/helpers/data-access/opensearch/liveSearchQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveSearchQuery.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/liveSearchQuery.ts"],"names":[],"mappings":";;;AAYA,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAuBlC,MAAM,oBAAoB,GAAG,CAAC,OAAgC,EAAqB,EAAE;IACxF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,IAAI,GAAc,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IAEzD,IAAI,CAAC,OAAO,EAAE;QACV,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;KACnC;SAAM;QACH,MAAM,OAAO,GAAqB,CAAC,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;QAErH,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;QACpC,IAAI,KAAK,KAAK,KAAK,EAAE;YACjB,MAAM,YAAY,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACrH,OAAO,CAAC,IAAI,CAAC;gBACT,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,iBAAiB,EAAE;aAC/G,CAAC,CAAC;SACN;QAED,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE;YAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,cAAc,EAAE;gBACxC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;aAC9F;SACJ;QAED,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;KACjC;IAED,OAAO;QACH,KAAK,EAAE,EAAE,IAAI,EAAE;QACf,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,oBAAoB;QAC3C,gBAAgB,EAAE,IAAI;KACzB,CAAC;AACN,CAAC,CAAC;AApCW,QAAA,oBAAoB,wBAoC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/core",
-    "version": "3.2.0-dev.2591250520",
+    "version": "3.2.0-dev.2601914129",
     "description": "Golemio Core Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/dist/helpers/data-access/opensearch/czechAnalyzer.d.ts

@@ -1,6 +0,0 @@
-import { Types } from "@opensearch-project/opensearch";
-export declare const czechAnalysis: {
-    analysis: Types.Indices_Common.IndexSettingsAnalysis;
-};
-export declare const defaultIndexSettings: Types.Indices_Common.IndexSettings;
-export declare const czechText: () => Types.Common_Mapping.TextProperty;

package/dist/helpers/data-access/opensearch/czechAnalyzer.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.czechText = exports.defaultIndexSettings = exports.czechAnalysis = void 0;
-exports.czechAnalysis = {
-    analysis: {
-        filter: {
-            czech_stop: { type: "stop", stopwords: "_czech_" },
-            czech_stem: { type: "stemmer", language: "czech" },
-            czech_ascii: { type: "asciifolding", preserve_original: true },
-        },
-        analyzer: {
-            czech_analyzer: {
-                type: "custom",
-                tokenizer: "standard",
-                // pořadí záleží: stemming musí být před asciifolding
-                filter: ["lowercase", "czech_stop", "czech_stem", "czech_ascii"],
-            },
-        },
-    },
-};
-exports.defaultIndexSettings = {
-    number_of_shards: 1,
-    ...exports.czechAnalysis,
-};
-const czechText = () => ({
-    type: "text",
-    analyzer: "czech_analyzer",
-});
-exports.czechText = czechText;
-//# sourceMappingURL=czechAnalyzer.js.map

package/dist/helpers/data-access/opensearch/czechAnalyzer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"czechAnalyzer.js","sourceRoot":"","sources":["../../../../src/helpers/data-access/opensearch/czechAnalyzer.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAA6D;IACnF,QAAQ,EAAE;QACN,MAAM,EAAE;YACJ,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE;YAClD,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;YAClD,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,iBAAiB,EAAE,IAAI,EAAE;SACjE;QACD,QAAQ,EAAE;YACN,cAAc,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,UAAU;gBACrB,qDAAqD;gBACrD,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;aACnE;SACJ;KACJ;CACJ,CAAC;AAEW,QAAA,oBAAoB,GAAuC;IACpE,gBAAgB,EAAE,CAAC;IACnB,GAAG,qBAAa;CACnB,CAAC;AAEK,MAAM,SAAS,GAAG,GAAsC,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,gBAAgB;CAC7B,CAAC,CAAC;AAHU,QAAA,SAAS,aAGnB"}