@adviser/cement 0.4.8 → 0.4.9

package/ts/cjs/tracer.test.js

@@ -0,0 +1,306 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cement_1 = require("@adviser/cement");
+describe("trace", () => {
+    let time;
+    let refTime;
+    let trace;
+    const logger = (0, cement_1.MockLogger)().logger.With().Module("trace").Str("value", "important").Logger();
+    beforeEach(() => {
+        time = (0, cement_1.BasicSysAbstractionFactory)({ TimeMode: cement_1.TimeMode.STEP }).Time();
+        trace = cement_1.TraceNode.root(time, logger);
+        refTime = (0, cement_1.BasicSysAbstractionFactory)({ TimeMode: cement_1.TimeMode.STEP }).Time();
+    });
+    it("a simple trace", () => {
+        expect(trace.span("test", (trace) => {
+            const r1 = trace.span("test.1", () => {
+                return 1;
+            });
+            const r2 = trace.span("test.2", () => {
+                return 1;
+            });
+            return r1 + r2;
+        })).toBe(2);
+        const childs = Array.from(trace.childs.values());
+        expect(childs.map((v) => v.invokes())).toEqual([
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test",
+                    value: "important",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now().getTime(),
+                        result: "success",
+                        end: refTime.Now(5).getTime(),
+                    },
+                ],
+            },
+        ]);
+        const layered = Array.from(trace.childs.get("test")?.childs.values() || []);
+        refTime = (0, cement_1.BasicSysAbstractionFactory)({ TimeMode: cement_1.TimeMode.STEP }).Time();
+        expect(layered.map((v) => v.invokes())).toEqual([
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test.1",
+                    value: "important",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now(2).getTime(),
+                        result: "success",
+                        end: refTime.Now().getTime(),
+                    },
+                ],
+            },
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test.2",
+                    value: "important",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now().getTime(),
+                        result: "success",
+                        end: refTime.Now(1).getTime(),
+                    },
+                ],
+            },
+        ]);
+    });
+    it("a async simple trace", async () => {
+        const log = trace.ctx.logger?.With().Str("value", "test").Logger();
+        const ret = await trace.span(trace.ctxWith("test", log), async (trace) => {
+            const r1 = trace.span(trace.ctxWith("test.1"), () => 1);
+            const log2 = trace.ctx.logger?.With().Module("xxx").Str("r2", "test.2").Logger();
+            const r2 = await trace.span(trace.ctxWith("test.2", log2), async () => {
+                time.Now();
+                await new Promise((resolve) => setTimeout(() => {
+                    time.Now();
+                    time.Now();
+                    resolve();
+                }, 100));
+                return 1;
+            });
+            return r1 + r2;
+        });
+        expect(ret).toBe(2);
+        const childs = Array.from(trace.childs.values());
+        const exp = childs.map((v) => v.invokes());
+        expect(exp).toEqual([
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test",
+                    value: "test",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now().getTime(),
+                        result: "success",
+                        end: refTime.Now(8).getTime(),
+                    },
+                ],
+            },
+        ]);
+        const layered = Array.from(trace.childs.get("test")?.childs.values() || []);
+        expect(layered.map((v) => v.invokes())).toEqual([
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test.1",
+                    value: "test",
+                },
+                invokations: [
+                    {
+                        result: "success",
+                        start: refTime.Now(-2).getTime(),
+                        end: refTime.Now().getTime(),
+                    },
+                ],
+            },
+            {
+                ctx: {
+                    module: "xxx",
+                    r2: "test.2",
+                    spanId: "test.2",
+                    value: "test",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now().getTime(),
+                        end: refTime.Now(4).getTime(),
+                        result: "success",
+                    },
+                ],
+            },
+        ]);
+    });
+    it("a async exception trace", async () => {
+        const ret = await trace.span("test", async (trace) => {
+            let r1 = 0;
+            let r2 = 0;
+            for (let i = 0; i < 3; i++) {
+                try {
+                    r1 += trace.span("test.1", (trace) => {
+                        if (i % 2) {
+                            throw new Error("test.1");
+                        }
+                        trace.metrics.get("i.1").add([i]);
+                        return 1;
+                    });
+                }
+                catch (e) {
+                    if (i % 2) {
+                        expect(e.message).toEqual("test.1");
+                    }
+                    else {
+                        assert(false, "should not happen");
+                    }
+                }
+                try {
+                    r2 += await trace.span("test.2", async (trace) => {
+                        time.Now();
+                        await new Promise((resolve, reject) => setTimeout(() => {
+                            time.Now();
+                            time.Now();
+                            if (i % 2) {
+                                trace.metrics.get("i.2").add(i);
+                                resolve();
+                            }
+                            else {
+                                reject(new Error("test.2"));
+                            }
+                        }, 10));
+                        return 1;
+                    });
+                }
+                catch (e) {
+                    if (i % 2) {
+                        assert(false, "should not happen");
+                    }
+                    else {
+                        expect(e.message).toEqual("test.2");
+                    }
+                }
+            }
+            return r1 + r2;
+        });
+        expect(ret).toBe(3);
+        expect(trace.metrics.toJSON()).toEqual({
+            "/test/test.1/i.1": [0, 2],
+            "/test/test.2/i.2": 1,
+        });
+        const childs = Array.from(trace.childs.values());
+        const exp = childs.map((v) => v.invokes());
+        expect(exp).toEqual([
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test",
+                    value: "important",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now(1).getTime(),
+                        end: refTime.Now(22).getTime(),
+                        result: "success",
+                    },
+                ],
+            },
+        ]);
+        const layered = Array.from(trace.childs.get("test")?.childs.values() || []);
+        expect(layered.map((v) => v.invokes())).toEqual([
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test.1",
+                    value: "important",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now(-2).getTime(),
+                        end: refTime.Now().getTime(),
+                        result: "success",
+                    },
+                    {
+                        start: refTime.Now(-9).getTime(),
+                        end: refTime.Now().getTime(),
+                        result: "error",
+                    },
+                    {
+                        start: refTime.Now(-16).getTime(),
+                        end: refTime.Now().getTime(),
+                        result: "success",
+                    },
+                ],
+                metricRefs: {
+                    "/test/test.1/i.1": [0, 2],
+                },
+            },
+            {
+                ctx: {
+                    module: "trace",
+                    spanId: "test.2",
+                    value: "important",
+                },
+                invokations: [
+                    {
+                        start: refTime.Now(-4).getTime(),
+                        end: refTime.Now(4).getTime(),
+                        result: "error",
+                    },
+                    {
+                        start: refTime.Now(-11).getTime(),
+                        end: refTime.Now(4).getTime(),
+                        result: "success",
+                    },
+                    {
+                        start: refTime.Now(-18).getTime(),
+                        end: refTime.Now(4).getTime(),
+                        result: "error",
+                    },
+                ],
+                metricRefs: {
+                    "/test/test.2/i.2": 1,
+                },
+            },
+        ]);
+    });
+});
+describe("metrics", () => {
+    let time;
+    let trace;
+    beforeEach(() => {
+        time = (0, cement_1.BasicSysAbstractionFactory)({ TimeMode: cement_1.TimeMode.STEP }).Time();
+        trace = cement_1.TraceNode.root(time);
+    });
+    it("a simple metrics", () => {
+        ["/test", "test", "/test/wurst", "bla"].forEach((path) => {
+            const abs = path.startsWith("/") ? path : "/" + path;
+            expect(trace.metrics.get(path).path).toBe(abs);
+            expect(trace.metrics.get(path).value).toBeFalsy();
+            trace.metrics.get(path).add(4711);
+            expect(trace.metrics.get(path).value).toBe(4711);
+            trace.metrics.get(path).set(undefined);
+        });
+    });
+    it("create metrics path", () => {
+        trace.span("test", (trace) => {
+            trace.span("test.1", (trace) => {
+                trace.metrics.get("m1.1").add(1);
+                trace.metrics.get("/test/test.1/m1.1").add(1);
+                expect(trace.metrics.get("m1.1").path).toBe("/test/test.1/m1.1");
+                expect(trace.metrics.get("m1.1").value).toBe(2);
+            });
+        });
+    });
+    it("typed span promise or literal", async () => {
+        expect(trace.span("test", () => "1")).toBe("1");
+        expect(await trace.span("test", () => Promise.resolve(1))).toBe(1);
+    });
+});
+//# sourceMappingURL=tracer.test.js.map

package/ts/cjs/tracer.test.js.map

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

package/ts/cjs/txt-en-decoder.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TxtEnDecoderSingleton = TxtEnDecoderSingleton;
+const resolve_once_js_1 = require("./resolve-once.js");
+const result_js_1 = require("./result.js");
+const coerce_uint8_js_1 = require("./utils/coerce-uint8.js");
+class TxtOps {
+    constructor() {
+        this.encoder = new TextEncoder();
+        this.decoder = new TextDecoder();
+    }
+    encode(str) {
+        return this.encoder.encode(str);
+    }
+    decode(data) {
+        if (result_js_1.Result.Is(data)) {
+            if (data.isErr()) {
+                throw data.Err();
+            }
+            const unwrapped = data.unwrap();
+            if (typeof unwrapped === "string") {
+                return this.decode(unwrapped);
+            }
+        }
+        if (typeof data === "string") {
+            return data;
+        }
+        return this.decoder.decode((0, coerce_uint8_js_1.coerceIntoUint8)(data).Ok());
+    }
+    async asyncDecode(data) {
+        let resolved = await data;
+        if (resolved instanceof Blob) {
+            resolved = await resolved.arrayBuffer();
+        }
+        return this.decode(resolved);
+    }
+}
+const txtEnDecoder = new resolve_once_js_1.ResolveOnce();
+function TxtEnDecoderSingleton() {
+    return txtEnDecoder.once(() => new TxtOps());
+}
+//# sourceMappingURL=txt-en-decoder.js.map

package/ts/cjs/txt-en-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"txt-en-decoder.js","sourceRoot":"","sources":["../../../src/txt-en-decoder.ts"],"names":[],"mappings":";;AA+CA,sDAEC;AAjDD,uDAAgD;AAChD,2CAAqC;AACrC,6DAAmE;AAWnE,MAAM,MAAM;IAAZ;QACW,YAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAC5B,YAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IA6BvC,CAAC;IA3BC,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,CAAC,IAAiB;QACtB,IAAI,kBAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,iCAAe,EAAC,IAAe,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAsB;QACtC,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC;QAC1B,IAAI,QAAQ,YAAY,IAAI,EAAE,CAAC;YAC7B,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,YAAY,GAAG,IAAI,6BAAW,EAAgB,CAAC;AACrD,SAAgB,qBAAqB;IACnC,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/ts/cjs/txt-en-decoder.test.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const result_js_1 = require("./result.js");
+const txt_en_decoder_js_1 = require("./txt-en-decoder.js");
+const utf8 = (0, txt_en_decoder_js_1.TxtEnDecoderSingleton)();
+it("there should be one Utf8EnDecoder", () => {
+    expect(utf8).toBe((0, txt_en_decoder_js_1.TxtEnDecoderSingleton)());
+});
+it("should encode", () => {
+    expect(utf8.encode("abc")).toEqual(new Uint8Array([97, 98, 99]));
+});
+it("should decode uint8", () => {
+    expect(utf8.decode(new Uint8Array([97, 98, 99]))).toEqual("abc");
+});
+it("should decode string", () => {
+    expect(utf8.decode("abc")).toEqual("abc");
+});
+it("should decode ArrayBuffer", () => {
+    expect(utf8.decode(new Uint8Array([97, 98, 99]).buffer)).toEqual("abc");
+});
+it("should decode ArrayBufferView", () => {
+    expect(utf8.decode(new DataView(new Uint8Array([97, 98, 99]).buffer))).toEqual("abc");
+});
+it("should decode Blob", async () => {
+    expect(await utf8.asyncDecode(new Blob([new Uint8Array([97, 98, 99])]))).toEqual("abc");
+});
+it("should decode coercePromise Uint8Array", async () => {
+    expect(await utf8.asyncDecode(new Uint8Array([97, 98, 99]))).toEqual("abc");
+});
+it("should decode Promise.Uint8Array", async () => {
+    expect(await utf8.asyncDecode(Promise.resolve(new Uint8Array([97, 98, 99])))).toEqual("abc");
+});
+it("should decode Promise.Result.Uint8Array", async () => {
+    expect(await utf8.asyncDecode(Promise.resolve(result_js_1.Result.Ok(new Uint8Array([97, 98, 99]))))).toEqual("abc");
+});
+it("should decode Buffer", () => {
+    if (!globalThis.Buffer)
+        return;
+    expect(utf8.decode(Buffer.from("abc"))).toEqual("abc");
+});
+it("should decode Result<Uint8Array>", () => {
+    expect(utf8.decode(result_js_1.Result.Ok(new Uint8Array([97, 98, 99])))).toEqual("abc");
+});
+it("should decode Result<String>", () => {
+    expect(utf8.decode(result_js_1.Result.Ok("abc"))).toEqual("abc");
+});
+it("should decode Result.Error -> exception", () => {
+    expect(() => utf8.decode(result_js_1.Result.Err("x"))).toThrow("x");
+});
+//# sourceMappingURL=txt-en-decoder.test.js.map

package/ts/cjs/txt-en-decoder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"txt-en-decoder.test.js","sourceRoot":"","sources":["../../../src/txt-en-decoder.test.ts"],"names":[],"mappings":";;AAAA,2CAAqC;AACrC,2DAA4D;AAE5D,MAAM,IAAI,GAAG,IAAA,yCAAqB,GAAE,CAAC;AACrC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAA,yCAAqB,GAAE,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE;IACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;IAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACnC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;IACvC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACxF,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;IAClC,MAAM,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;IACtD,MAAM,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;IAChD,MAAM,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/F,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;IACvD,MAAM,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAM,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1G,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,OAAO;IAC/B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAM,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;IACtC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACjD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAM,CAAC,GAAG,CAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC"}

package/ts/cjs/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.param = void 0;
+class _Required {
+    constructor() {
+        this.type = "REQUIRED";
+    }
+}
+class _Optional {
+    constructor() {
+        this.type = "OPTIONAL";
+    }
+}
+exports.param = {
+    REQUIRED: new _Required(),
+    OPTIONAL: new _Optional(),
+};
+//# sourceMappingURL=types.js.map

package/ts/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":";;;AAGA,MAAM,SAAS;IAAf;QACW,SAAI,GAAG,UAAU,CAAC;IAC7B,CAAC;CAAA;AAED,MAAM,SAAS;IAAf;QACW,SAAI,GAAG,UAAU,CAAC;IAC7B,CAAC;CAAA;AAEY,QAAA,KAAK,GAGd;IACF,QAAQ,EAAE,IAAI,SAAS,EAAE;IACzB,QAAQ,EAAE,IAAI,SAAS,EAAE;CAC1B,CAAC"}