@adviser/cement 0.4.7 → 0.4.9

package/ts/esm/tracer.js

@@ -0,0 +1,174 @@
+import { isPromise } from "./is-promise.js";
+export class Metric {
+    value;
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    set(value) {
+        this.value = value;
+    }
+    add(value) {
+        if (typeof value === "number") {
+            if (this.value === undefined) {
+                this.value = 0;
+            }
+            this.value = (this.value + value);
+        }
+        else if (Array.isArray(value)) {
+            if (!Array.isArray(this.value)) {
+                this.value = [];
+            }
+            this.value.push(...value);
+        }
+        else {
+            throw new Error("add only support number or array");
+        }
+    }
+}
+export class Metrics {
+    tracenode;
+    map;
+    spanRefs = new Map();
+    constructor(tracenode) {
+        this.tracenode = tracenode;
+        this.map = tracenode.ctx.metrics;
+    }
+    toJSON() {
+        const obj = {};
+        for (const [key, value] of this.map) {
+            obj[key] = value.value;
+        }
+        return obj;
+    }
+    get(ipath) {
+        const path = ipath.replace(/[/]+/g, "/").trim();
+        if (path.startsWith("/")) {
+            if (path.slice(1).length === 0) {
+                throw new Error(`Metrics path must contain value /:${path}`);
+            }
+            let metric = this.map.get(path);
+            if (!metric) {
+                metric = new Metric(path);
+                this.map.set(path, metric);
+            }
+            this.spanRefs.set(path, metric);
+            return metric;
+        }
+        else if (path.includes("/")) {
+            throw new Error(`Metrics path must start with /:${path}`);
+        }
+        const rootPath = this.tracenode.getRootPath();
+        return this.get(`${rootPath}/${path}`);
+    }
+}
+export class TraceNode {
+    childs = new Map();
+    invokations = [];
+    spanId;
+    ctx;
+    metrics;
+    static root(time, logger) {
+        return new TraceNode({
+            spanId: "root",
+            time,
+            logger,
+            metrics: new Map(),
+            parent: undefined,
+        });
+    }
+    constructor(ctx) {
+        this.spanId = ctx.spanId;
+        this.ctx = ctx;
+        this.metrics = new Metrics(this);
+    }
+    getRootPath(rpath = []) {
+        if (!this.ctx.parent) {
+            return "/" + rpath.reverse().join("/");
+        }
+        return this.ctx.parent.getRootPath(rpath.concat(this.ctx.spanId));
+    }
+    invokes() {
+        const cleanCtx = { ...this.ctx };
+        delete cleanCtx.parent;
+        delete cleanCtx.time;
+        delete cleanCtx.logger;
+        delete cleanCtx.metrics;
+        const spanRefs = this.metrics.toJSON.call({ map: this.metrics.spanRefs });
+        const metricsRefs = Object.keys(spanRefs).length > 0 ? { metricRefs: spanRefs } : {};
+        return {
+            ctx: cleanCtx,
+            invokations: this.invokations,
+            ...metricsRefs,
+        };
+    }
+    ctxWith(spanId, logger) {
+        const ctx = {
+            ...this.ctx,
+            spanId,
+        };
+        if (logger) {
+            ctx.logger = logger;
+        }
+        return ctx;
+    }
+    span(inSpanId, fn) {
+        let ctx;
+        if (typeof inSpanId === "string") {
+            ctx = {
+                ...this.ctx,
+                spanId: inSpanId,
+                parent: this,
+            };
+        }
+        else {
+            ctx = {
+                ...this.ctx,
+                ...inSpanId,
+                parent: this,
+            };
+        }
+        if (ctx.logger) {
+            ctx = {
+                ...ctx,
+                ...ctx.logger.Attributes(),
+            };
+        }
+        const spanId = ctx.spanId;
+        let spanTrace = this.childs.get(spanId);
+        if (!spanTrace) {
+            spanTrace = new TraceNode(ctx);
+            this.childs.set(spanId.toString(), spanTrace);
+        }
+        const invokation = {
+            start: this.ctx.time.Now().getTime(),
+            end: 0,
+            result: "success",
+        };
+        spanTrace.invokations.push(invokation);
+        try {
+            const possiblePromise = fn(spanTrace);
+            if (isPromise(possiblePromise)) {
+                return possiblePromise
+                    .then((v) => {
+                    return v;
+                })
+                    .catch((e) => {
+                    invokation.result = "error";
+                    throw e;
+                })
+                    .finally(() => {
+                    invokation.end = this.ctx.time.Now().getTime();
+                });
+            }
+            invokation.end = this.ctx.time.Now().getTime();
+            return possiblePromise;
+        }
+        catch (e) {
+            invokation.result = "error";
+            invokation.end = this.ctx.time.Now().getTime();
+            throw e;
+        }
+    }
+}
+//# sourceMappingURL=tracer.js.map

package/ts/esm/tracer.js.map

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

package/ts/esm/tracer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracer.test.d.ts.map

package/ts/esm/tracer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.test.d.ts","sourceRoot":"","sources":["../../../src/tracer.test.ts"],"names":[],"mappings":""}

package/ts/esm/tracer.test.js

@@ -0,0 +1,304 @@
+import { TraceNode, MockLogger, BasicSysAbstractionFactory, TimeMode } from "@adviser/cement";
+describe("trace", () => {
+    let time;
+    let refTime;
+    let trace;
+    const logger = MockLogger().logger.With().Module("trace").Str("value", "important").Logger();
+    beforeEach(() => {
+        time = BasicSysAbstractionFactory({ TimeMode: TimeMode.STEP }).Time();
+        trace = TraceNode.root(time, logger);
+        refTime = BasicSysAbstractionFactory({ TimeMode: 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 = BasicSysAbstractionFactory({ TimeMode: 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 = BasicSysAbstractionFactory({ TimeMode: TimeMode.STEP }).Time();
+        trace = 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/esm/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/esm/txt-en-decoder.d.ts

@@ -0,0 +1,11 @@
+import { Result } from "./result.js";
+import { ToUInt8 } from "./utils/coerce-uint8.js";
+export type ToEnDecoder = ToUInt8 | string | Result<string>;
+export type AsyncToEnDecoder = ToEnDecoder | Blob | Promise<ToEnDecoder | Blob>;
+export interface TxtEnDecoder {
+    encode(input: string): Uint8Array;
+    decode(input: ToEnDecoder): string;
+    asyncDecode(input: AsyncToEnDecoder): Promise<string>;
+}
+export declare function TxtEnDecoderSingleton(): TxtEnDecoder;
+//# sourceMappingURL=txt-en-decoder.d.ts.map

package/ts/esm/txt-en-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"txt-en-decoder.d.ts","sourceRoot":"","sources":["../../../src/txt-en-decoder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAmB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvD;AAoCD,wBAAgB,qBAAqB,IAAI,YAAY,CAEpD"}

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

@@ -0,0 +1,37 @@
+import { ResolveOnce } from "./resolve-once.js";
+import { Result } from "./result.js";
+import { coerceIntoUint8 } from "./utils/coerce-uint8.js";
+class TxtOps {
+    encoder = new TextEncoder();
+    decoder = new TextDecoder();
+    encode(str) {
+        return this.encoder.encode(str);
+    }
+    decode(data) {
+        if (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(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 ResolveOnce();
+export function TxtEnDecoderSingleton() {
+    return txtEnDecoder.once(() => new TxtOps());
+}
+//# sourceMappingURL=txt-en-decoder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"txt-en-decoder.js","sourceRoot":"","sources":["../../../src/txt-en-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,eAAe,EAAW,MAAM,yBAAyB,CAAC;AAWnE,MAAM,MAAM;IACD,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAC5B,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAErC,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,CAAC,IAAiB;QACtB,IAAI,MAAM,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,eAAe,CAAC,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,WAAW,EAAgB,CAAC;AACrD,MAAM,UAAU,qBAAqB;IACnC,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/ts/esm/txt-en-decoder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=txt-en-decoder.test.d.ts.map

package/ts/esm/txt-en-decoder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"txt-en-decoder.test.d.ts","sourceRoot":"","sources":["../../../src/txt-en-decoder.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,48 @@
+import { Result } from "./result.js";
+import { TxtEnDecoderSingleton } from "./txt-en-decoder.js";
+const utf8 = TxtEnDecoderSingleton();
+it("there should be one Utf8EnDecoder", () => {
+    expect(utf8).toBe(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.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.Ok(new Uint8Array([97, 98, 99])))).toEqual("abc");
+});
+it("should decode Result<String>", () => {
+    expect(utf8.decode(Result.Ok("abc"))).toEqual("abc");
+});
+it("should decode Result.Error -> exception", () => {
+    expect(() => utf8.decode(Result.Err("x"))).toThrow("x");
+});
+//# sourceMappingURL=txt-en-decoder.test.js.map

package/ts/esm/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":"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"}

package/ts/esm/types.d.ts

@@ -0,0 +1,16 @@
+interface IType {
+    readonly type: string;
+}
+declare class _Required implements IType {
+    readonly type = "REQUIRED";
+}
+declare class _Optional implements IType {
+    readonly type = "OPTIONAL";
+}
+export declare const param: {
+    REQUIRED: _Required;
+    OPTIONAL: _Optional;
+};
+export type param = (typeof param)[keyof typeof param];
+export {};
+//# sourceMappingURL=types.d.ts.map

package/ts/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,UAAU,KAAK;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD,cAAM,SAAU,YAAW,KAAK;IAC9B,QAAQ,CAAC,IAAI,cAAc;CAC5B;AAED,cAAM,SAAU,YAAW,KAAK;IAC9B,QAAQ,CAAC,IAAI,cAAc;CAC5B;AAED,eAAO,MAAM,KAAK,EAAE;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CAIrB,CAAC;AACF,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC"}