@rabby-wallet/rabby-logger 0.2.1-alpha

package/README.md

@@ -0,0 +1,191 @@
+# @rabby-wallet/rabby-logger
+
+Platform-agnostic Rabby log parsing and writing primitives.
+
+This package provides:
+
+- parsing for Rabby `.log` files and exported `.zip` archives
+- `@rabby-log/v1` line formatting
+- a generic rolling zip writer
+- a generic logger core
+
+It does **not** ship platform-specific storage or lifecycle adapters.
+
+## Install
+
+```bash
+npm install @rabby-wallet/rabby-logger
+```
+
+## Parse logs
+
+```ts
+import {
+  mergeParsedLogInputs,
+  parseRabbyLogInputBytes,
+} from "@rabby-wallet/rabby-logger";
+
+const inputs = await Promise.all(
+  files.map(async (file) =>
+    parseRabbyLogInputBytes(file.name, await file.arrayBuffer()),
+  ),
+);
+
+const dataset = mergeParsedLogInputs(inputs);
+console.log(dataset.records[0]?.message);
+```
+
+## Write logs
+
+Most hosts should **not** implement a new writer from scratch.
+
+Recommended path:
+
+1. implement `LoggingFileSystemAdapter`
+2. use the built-in `RollingZipLogWriter`
+3. pass it to `AppLogger`
+
+```ts
+import {
+  AppLogger,
+  RollingZipLogWriter,
+  type LoggingFileSystemAdapter,
+} from "@rabby-wallet/rabby-logger";
+
+const myFsAdapter: LoggingFileSystemAdapter = {
+  mkdir: async (path) => {},
+  readFile: async (path, encoding) => "...",
+  writeFile: async (path, contents, encoding) => {},
+  appendFile: async (path, contents, encoding) => {},
+  moveFile: async (from, to) => {},
+  listFiles: async (path) => [],
+  unlink: async (path) => {},
+};
+
+const writer = new RollingZipLogWriter({
+  fs: myFsAdapter,
+  rootDir: "/applogs",
+  archivePrefix: "rabby-mobile-logs",
+});
+
+const logger = new AppLogger({
+  runtimeEnv: "production",
+  platform: "ios",
+  writer,
+  shouldWriteToFile: () => true,
+  shouldCaptureConsole: () => true,
+});
+
+logger.installConsoleCapture();
+logger.info("app boot");
+await logger.flush();
+await logger.finalizeArchive();
+```
+
+## Bring Your Own Writer
+
+If your host already owns archive layout, rotation, or native zip writing,
+implement `AppLogWriter` instead of `LoggingFileSystemAdapter`.
+
+```ts
+import { AppLogger, type AppLogWriter } from "@rabby-wallet/rabby-logger";
+
+class NativeArchiveWriter implements AppLogWriter {
+  async writeLine(line: string) {
+    await nativeLogger.appendUtf8Line(line);
+  }
+
+  async flush() {
+    await nativeLogger.flush();
+  }
+
+  async finalizeArchive() {
+    return nativeLogger.finalizeZip();
+  }
+
+  getState() {
+    return {
+      rootDir: "/native/applogs",
+      activeArchivePath: nativeLogger.currentArchivePath(),
+    };
+  }
+}
+
+const logger = new AppLogger({
+  runtimeEnv: "production",
+  platform: "android",
+  writer: new NativeArchiveWriter(),
+  shouldWriteToFile: () => true,
+});
+```
+
+## React Native Example
+
+This is the same integration shape used by Rabby Mobile: `react-native-fs`
+provides the file operations, while `RollingZipLogWriter` keeps ownership of
+formatting, entry rotation, and archive finalization.
+
+```ts
+import { Platform } from "react-native";
+import RNFS from "react-native-fs";
+import {
+  AppLogger,
+  RollingZipLogWriter,
+  type LoggingFileSystemAdapter,
+} from "@rabby-wallet/rabby-logger";
+
+const rnfsLoggingAdapter: LoggingFileSystemAdapter = {
+  mkdir(path) {
+    return RNFS.mkdir(path, { NSURLIsExcludedFromBackupKey: true });
+  },
+  readFile(path, encoding) {
+    return RNFS.readFile(path, encoding);
+  },
+  writeFile(path, contents, encoding) {
+    return RNFS.writeFile(path, contents, encoding);
+  },
+  appendFile(path, contents, encoding) {
+    return RNFS.appendFile(path, contents, encoding);
+  },
+  moveFile(from, to) {
+    return RNFS.moveFile(from, to);
+  },
+  async listFiles(path) {
+    const entries = await RNFS.readDir(path);
+    return entries.filter(item => item.isFile()).map(item => ({
+      name: item.name,
+      path: item.path,
+      size: item.size,
+      mtimeMs: item.mtime ? item.mtime.getTime() : undefined,
+    }));
+  },
+  unlink(path) {
+    return RNFS.unlink(path);
+  },
+};
+
+const writer = new RollingZipLogWriter({
+  fs: rnfsLoggingAdapter,
+  rootDir: `${RNFS.DocumentDirectoryPath}/applogs`,
+  archivePrefix: "rabby-mobile-logs",
+});
+
+export const logger = new AppLogger({
+  runtimeEnv: "production",
+  platform: Platform.OS,
+  writer,
+  shouldWriteToFile: () => true,
+  shouldCaptureConsole: () => true,
+});
+```
+
+## Host responsibilities
+
+The host application must provide:
+
+- either a `LoggingFileSystemAdapter` for `RollingZipLogWriter`, or an
+  `AppLogWriter`
+- its own app lifecycle integration
+- any platform-specific file sharing or export flow
+
+Repository-only development notes live under `packages/rabby-logger/docs/`.

package/dist/core.d.ts

@@ -0,0 +1,74 @@
+import { MaskedLogValue, SerializableLogValue } from "./format";
+import type { AppLogWriter, AppLogWriterState } from "./writer";
+export type ConsoleLike = {
+    log?: (...args: unknown[]) => void;
+    info?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    debug?: (...args: unknown[]) => void;
+    trace?: (...args: unknown[]) => void;
+    time?: (label?: string) => void;
+    timeLog?: (label?: string, ...args: unknown[]) => void;
+    timeEnd?: (label?: string) => void;
+    assert?: (...args: unknown[]) => void;
+};
+type InMemoryLogLevel = "info" | "warn" | "error" | "debug";
+export type AppLoggerOptions = {
+    runtimeEnv: string;
+    platform?: string;
+    writer: AppLogWriter;
+    shouldWriteToFile: () => boolean;
+    shouldCaptureConsole?: () => boolean;
+    originalConsole?: ConsoleLike;
+    sessionId?: string;
+    now?: () => Date;
+    captureInMemory?: boolean;
+    onInMemoryLog?: (entry: {
+        level: InMemoryLogLevel;
+        message: string;
+        data?: SerializableLogValue;
+    }) => void;
+};
+export type LoggerState = AppLogWriterState & {
+    runtimeEnv: string;
+    sessionId: string;
+    effectiveFileLoggingEnabled: boolean;
+    effectiveConsoleCaptureEnabled: boolean;
+};
+export declare class AppLogger {
+    readonly mask: <T>(value: T) => MaskedLogValue<T>;
+    private readonly writer;
+    private readonly runtimeEnv;
+    private readonly platform?;
+    private readonly shouldWriteToFile;
+    private readonly shouldCaptureConsole;
+    private readonly now;
+    private readonly captureInMemory;
+    private readonly onInMemoryLog?;
+    private readonly originalConsole;
+    private sequence;
+    private writeQueue;
+    private lastWriteEnabled;
+    private readonly sessionId;
+    private consoleCaptureInstalled;
+    private readonly timers;
+    constructor(options: AppLoggerOptions);
+    private enqueue;
+    private buildRecord;
+    private captureRecord;
+    private getConsoleEchoArgs;
+    log(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    trace(...args: unknown[]): void;
+    installConsoleCapture(consoleTarget?: ConsoleLike): void;
+    handlePolicyChange(): Promise<void>;
+    handleAppStateChange(nextState: string): Promise<string | null>;
+    flush(): Promise<void>;
+    finalizeArchive(): Promise<string | null>;
+    getState(): LoggerState;
+}
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

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

package/dist/core.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppLogger = void 0;
+const format_1 = require("./format");
+const noop = (..._args) => { };
+function bindConsoleMethod(thisArg, value) {
+    if (typeof value !== "function") {
+        return noop;
+    }
+    return value.bind(thisArg);
+}
+function hasMaskedValue(input, seen = new WeakSet(), depth = 0) {
+    if (input instanceof format_1.MaskedLogValue) {
+        return true;
+    }
+    if (!input || typeof input !== "object") {
+        return false;
+    }
+    if (seen.has(input)) {
+        return false;
+    }
+    seen.add(input);
+    if (depth >= 4) {
+        return false;
+    }
+    if (Array.isArray(input)) {
+        return input.some((item) => hasMaskedValue(item, seen, depth + 1));
+    }
+    return Object.values(input).some((item) => hasMaskedValue(item, seen, depth + 1));
+}
+function mapToInMemoryLevel(level) {
+    switch (level) {
+        case "warn":
+            return "warn";
+        case "error":
+            return "error";
+        case "debug":
+        case "trace":
+            return "debug";
+        default:
+            return "info";
+    }
+}
+class AppLogger {
+    constructor(options) {
+        this.mask = (value) => new format_1.MaskedLogValue(value);
+        this.sequence = 0;
+        this.writeQueue = Promise.resolve(undefined);
+        this.consoleCaptureInstalled = false;
+        this.timers = new Map();
+        this.writer = options.writer;
+        this.runtimeEnv = options.runtimeEnv;
+        this.platform = options.platform;
+        this.shouldWriteToFile = options.shouldWriteToFile;
+        this.shouldCaptureConsole =
+            options.shouldCaptureConsole || options.shouldWriteToFile;
+        this.now = options.now || (() => new Date());
+        this.captureInMemory = !!options.captureInMemory;
+        this.onInMemoryLog = options.onInMemoryLog;
+        this.lastWriteEnabled = this.shouldWriteToFile();
+        this.sessionId = options.sessionId || (0, format_1.createDefaultSessionId)(this.now());
+        const consoleLike = options.originalConsole || console;
+        this.originalConsole = {
+            log: bindConsoleMethod(consoleLike, consoleLike.log),
+            info: bindConsoleMethod(consoleLike, consoleLike.info),
+            warn: bindConsoleMethod(consoleLike, consoleLike.warn),
+            error: bindConsoleMethod(consoleLike, consoleLike.error),
+            debug: bindConsoleMethod(consoleLike, consoleLike.debug),
+            trace: bindConsoleMethod(consoleLike, consoleLike.trace),
+            time: bindConsoleMethod(consoleLike, consoleLike.time),
+            timeLog: bindConsoleMethod(consoleLike, consoleLike.timeLog),
+            timeEnd: bindConsoleMethod(consoleLike, consoleLike.timeEnd),
+            assert: bindConsoleMethod(consoleLike, consoleLike.assert),
+        };
+    }
+    enqueue(task) {
+        const run = this.writeQueue.then(task);
+        this.writeQueue = run
+            .then(() => undefined)
+            .catch((error) => {
+            this.originalConsole.error("[AppLogger] background write failed", error);
+        });
+        return run;
+    }
+    buildRecord({ level, source, method, args, meta, }) {
+        const serializedArgs = (0, format_1.serializeLogArgs)(args);
+        const serializedMeta = meta && Object.keys(meta).length
+            ? (0, format_1.serializeLogArgs)([meta])[0]
+            : undefined;
+        const record = {
+            timestamp: this.now().toISOString(),
+            level,
+            source,
+            method,
+            env: this.runtimeEnv,
+            sessionId: this.sessionId,
+            sequence: ++this.sequence,
+            platform: this.platform,
+            body: {
+                message: (0, format_1.buildInlineMessageFromArgs)(serializedArgs),
+                args: serializedArgs,
+                ...(serializedMeta ? { meta: serializedMeta } : {}),
+            },
+        };
+        return {
+            record,
+            serializedArgs,
+        };
+    }
+    captureRecord(level, source, method, args, meta) {
+        const { record, serializedArgs } = this.buildRecord({
+            level,
+            source,
+            method,
+            args,
+            meta,
+        });
+        if (this.captureInMemory && this.onInMemoryLog) {
+            const extraData = record.body.meta ||
+                (record.body.args.length > 1 ? record.body.args : record.body.args[0]);
+            this.onInMemoryLog({
+                level: mapToInMemoryLevel(level),
+                message: record.body.message || `[${method}]`,
+                data: extraData,
+            });
+        }
+        const shouldWrite = this.shouldWriteToFile();
+        if (this.lastWriteEnabled && !shouldWrite) {
+            this.enqueue(async () => {
+                await this.writer.finalizeArchive();
+            }).catch(noop);
+        }
+        this.lastWriteEnabled = shouldWrite;
+        if (shouldWrite) {
+            const line = (0, format_1.formatLogLine)(record);
+            this.enqueue(async () => {
+                await this.writer.writeLine(line);
+            }).catch(noop);
+        }
+        return serializedArgs;
+    }
+    getConsoleEchoArgs(rawArgs, serializedArgs, sanitizeAll) {
+        if (sanitizeAll || rawArgs.some((item) => hasMaskedValue(item))) {
+            return serializedArgs;
+        }
+        return rawArgs;
+    }
+    log(...args) {
+        const serializedArgs = this.captureRecord("log", "logger", "log", args);
+        this.originalConsole.log(...serializedArgs);
+    }
+    info(...args) {
+        const serializedArgs = this.captureRecord("info", "logger", "info", args);
+        this.originalConsole.info(...serializedArgs);
+    }
+    warn(...args) {
+        const serializedArgs = this.captureRecord("warn", "logger", "warn", args);
+        this.originalConsole.warn(...serializedArgs);
+    }
+    error(...args) {
+        const serializedArgs = this.captureRecord("error", "logger", "error", args);
+        this.originalConsole.error(...serializedArgs);
+    }
+    debug(...args) {
+        const serializedArgs = this.captureRecord("debug", "logger", "debug", args);
+        this.originalConsole.debug(...serializedArgs);
+    }
+    trace(...args) {
+        const traceStack = new Error("[logger.trace]").stack;
+        const serializedArgs = this.captureRecord("trace", "logger", "trace", args, {
+            traceStack,
+        });
+        this.originalConsole.trace(...serializedArgs);
+    }
+    installConsoleCapture(consoleTarget = console) {
+        if (this.consoleCaptureInstalled) {
+            return;
+        }
+        this.consoleCaptureInstalled = true;
+        consoleTarget.log = (...args) => {
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.log(...args);
+                return;
+            }
+            const serializedArgs = this.captureRecord("log", "console", "log", args);
+            this.originalConsole.log(...this.getConsoleEchoArgs(args, serializedArgs, false));
+        };
+        consoleTarget.info = (...args) => {
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.info(...args);
+                return;
+            }
+            const serializedArgs = this.captureRecord("info", "console", "info", args);
+            this.originalConsole.info(...this.getConsoleEchoArgs(args, serializedArgs, false));
+        };
+        consoleTarget.warn = (...args) => {
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.warn(...args);
+                return;
+            }
+            const serializedArgs = this.captureRecord("warn", "console", "warn", args);
+            this.originalConsole.warn(...this.getConsoleEchoArgs(args, serializedArgs, false));
+        };
+        consoleTarget.error = (...args) => {
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.error(...args);
+                return;
+            }
+            const serializedArgs = this.captureRecord("error", "console", "error", args);
+            this.originalConsole.error(...this.getConsoleEchoArgs(args, serializedArgs, false));
+        };
+        consoleTarget.debug = (...args) => {
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.debug(...args);
+                return;
+            }
+            const serializedArgs = this.captureRecord("debug", "console", "debug", args);
+            this.originalConsole.debug(...this.getConsoleEchoArgs(args, serializedArgs, false));
+        };
+        consoleTarget.trace = (...args) => {
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.trace(...args);
+                return;
+            }
+            const traceStack = new Error("[console.trace]").stack;
+            const serializedArgs = this.captureRecord("trace", "console", "trace", args, { traceStack });
+            this.originalConsole.trace(...this.getConsoleEchoArgs(args, serializedArgs, false));
+        };
+        consoleTarget.time = (label) => {
+            const timerLabel = label || "default";
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.time(timerLabel);
+                return;
+            }
+            this.timers.set(timerLabel, this.now().getTime());
+            this.captureRecord("debug", "console", "time", [`[timer:start] ${timerLabel}`], {
+                label: timerLabel,
+            });
+            this.originalConsole.time(timerLabel);
+        };
+        consoleTarget.timeLog = (label, ...args) => {
+            const timerLabel = label || "default";
+            if (!this.shouldCaptureConsole()) {
+                this.originalConsole.timeLog(timerLabel, ...args);
+                return;
+            }
+            const startedAt = this.timers.get(timerLabel);
+            const durationMs = typeof startedAt === "number" ? this.now().getTime() - startedAt : null;
+            const computedArgs = [`${timerLabel}: ${durationMs !== null && durationMs !== void 0 ? durationMs : "unknown"}ms`, ...args];
+            const serializedArgs = this.captureRecord("info", "console", "timeLog", computedArgs, {
+                label: timerLabel,
+                durationMs,
+            });
+            this.originalConsole.timeLog(timerLabel, ...this.getConsoleEchoArgs(computedArgs, serializedArgs, false).slice(1));
+        };
+        consoleTarget.timeEnd = (label) => {
+            const timerLabel = label || "default";
+            if (!this.shouldCaptureConsole()) {
+                this.timers.delete(timerLabel);
+                this.originalConsole.timeEnd(timerLabel);
+                return;
+            }
+            const startedAt = this.timers.get(timerLabel);
+            const durationMs = typeof startedAt === "number" ? this.now().getTime() - startedAt : null;
+            this.timers.delete(timerLabel);
+            const computedArgs = [`${timerLabel}: ${durationMs !== null && durationMs !== void 0 ? durationMs : "unknown"}ms`];
+            const serializedArgs = this.captureRecord("info", "console", "timeEnd", computedArgs, {
+                label: timerLabel,
+                durationMs,
+            });
+            this.originalConsole.timeEnd(timerLabel);
+            if (!startedAt) {
+                this.originalConsole.info(...serializedArgs);
+            }
+        };
+        consoleTarget.assert = (...args) => {
+            const [condition, ...restArgs] = args;
+            if (!this.shouldCaptureConsole() || condition) {
+                this.originalConsole.assert(condition, ...restArgs);
+                return;
+            }
+            const actualArgs = restArgs.length ? restArgs : ["Assertion failed"];
+            const serializedArgs = this.captureRecord("error", "console", "assert", actualArgs);
+            this.originalConsole.assert(false, ...this.getConsoleEchoArgs(actualArgs, serializedArgs, false));
+        };
+    }
+    handlePolicyChange() {
+        const nextEnabled = this.shouldWriteToFile();
+        if (this.lastWriteEnabled && !nextEnabled) {
+            this.lastWriteEnabled = nextEnabled;
+            return this.enqueue(async () => {
+                await this.writer.finalizeArchive();
+            });
+        }
+        this.lastWriteEnabled = nextEnabled;
+        return Promise.resolve();
+    }
+    handleAppStateChange(nextState) {
+        if (nextState === "active") {
+            return Promise.resolve(null);
+        }
+        return this.enqueue(async () => this.writer.finalizeArchive());
+    }
+    flush() {
+        return this.enqueue(async () => {
+            await this.writer.flush();
+        });
+    }
+    finalizeArchive() {
+        return this.enqueue(async () => this.writer.finalizeArchive());
+    }
+    getState() {
+        return {
+            ...this.writer.getState(),
+            runtimeEnv: this.runtimeEnv,
+            sessionId: this.sessionId,
+            effectiveFileLoggingEnabled: this.shouldWriteToFile(),
+            effectiveConsoleCaptureEnabled: this.shouldCaptureConsole(),
+        };
+    }
+}
+exports.AppLogger = AppLogger;
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,31 @@
+export type AppLogLevel = "log" | "info" | "warn" | "error" | "debug" | "trace";
+export declare class MaskedLogValue<T = unknown> {
+    readonly value: T;
+    constructor(value: T);
+}
+export type SerializableLogValue = null | boolean | number | string | SerializableLogValue[] | {
+    [key: string]: SerializableLogValue;
+};
+export type FormattedLogRecord = {
+    timestamp: string;
+    level: AppLogLevel;
+    source: string;
+    method: string;
+    env: string;
+    sessionId: string;
+    sequence: number;
+    platform?: string;
+    body: {
+        message: string;
+        args: SerializableLogValue[];
+        meta?: SerializableLogValue;
+    };
+};
+export declare function serializeLogValue(value: unknown, seen?: WeakSet<object>, depth?: number, maxDepth?: number): SerializableLogValue;
+export declare function buildInlineMessageFromArgs(args: SerializableLogValue[]): string;
+export declare function serializeLogArgs(args: unknown[]): SerializableLogValue[];
+export declare function formatLogLine(record: FormattedLogRecord): string;
+export declare function formatDateFolder(date: Date): string;
+export declare function formatFileTimestamp(date: Date): string;
+export declare function createDefaultSessionId(date?: Date): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhF,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAAR,KAAK,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,oBAAoB,GAC5B,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,oBAAoB,EAAE,GACtB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,oBAAoB,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,oBAAoB,CAAC;KAC7B,CAAC;CACH,CAAC;AAoLF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,OAAO,CAAC,MAAM,CAAiB,EACrC,KAAK,SAAI,EACT,QAAQ,SAAI,GACX,oBAAoB,CAmHtB;AAkBD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,oBAAoB,EAAE,UAWtE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,0BAE/C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,kBAAkB,UAiBvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,UAM1C;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,UAU7C;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,IAAiB,UAI7D"}