@decaf-ts/core 0.8.51 → 0.8.52

package/lib/esm/fs/FilesystemAdapter.d.ts

@@ -0,0 +1,67 @@
+import { promises as defaultFs } from "node:fs";
+import { Constructor } from "@decaf-ts/decoration";
+import { Model } from "@decaf-ts/decorator-validation";
+import { PrimaryKeyType } from "@decaf-ts/db-decorators";
+import { Dispatch } from "../persistence/Dispatch";
+import { ContextualArgs } from "../utils/ContextualLoggedClass";
+import { RamAdapter } from "../ram";
+import type { RamContext, RawRamQuery } from "../ram/types";
+import type { FilesystemConfig } from "./types";
+export declare class FilesystemAdapter extends RamAdapter {
+    private readonly rootDir;
+    private readonly dbPath;
+    private readonly fs;
+    private readonly ready;
+    private readonly jsonSpacing?;
+    private readonly onHydrated?;
+    private readonly indexStore;
+    private readonly pkColumnCache;
+    private readonly indexDescriptorCache;
+    private readonly tableWatchers;
+    private rootWatcher?;
+    private watching;
+    private readonly watchDebounceMs;
+    private readonly pendingObserverRefresh;
+    constructor(conf?: FilesystemConfig, alias?: string);
+    getFs(): typeof defaultFs;
+    getStoragePath(): string;
+    getTablePath(tableName: string): string;
+    getIndexesPath(tableName: string): string;
+    protected Dispatch(): Dispatch<FilesystemAdapter>;
+    private initializeFromDisk;
+    ensureWatching(): Promise<void>;
+    stopWatching(): void;
+    private ensureReady;
+    private startRootWatcher;
+    private handleRootEvent;
+    private normalizeFilename;
+    private scheduleObserverRefresh;
+    private flushObserverRefresh;
+    private clearPendingObserverRefresh;
+    private watchTable;
+    private unwatchTable;
+    private handleTableEvent;
+    private removeRecordFromMap;
+    private applyRecord;
+    private hydrateTable;
+    private directoryExists;
+    private tablePath;
+    private recordPath;
+    private indexesPath;
+    private writeRecord;
+    private removeRecord;
+    private syncIndexesForWrite;
+    private removeIndexesForRecord;
+    private getIndexDescriptors;
+    private collectIndexMetadata;
+    private asIndexMetadata;
+    private buildColumns;
+    private columnNameOrFallback;
+    private getPkColumn;
+    private buildIndexSource;
+    create<M extends Model>(clazz: Constructor<M>, id: PrimaryKeyType, model: Record<string, any>, ...args: ContextualArgs<RamContext>): Promise<Record<string, any>>;
+    read<M extends Model>(clazz: Constructor<M>, id: PrimaryKeyType, ...args: ContextualArgs<RamContext>): Promise<Record<string, any>>;
+    update<M extends Model>(clazz: Constructor<M>, id: PrimaryKeyType, model: Record<string, any>, ...args: ContextualArgs<RamContext>): Promise<Record<string, any>>;
+    delete<M extends Model>(clazz: Constructor<M>, id: PrimaryKeyType, ...args: ContextualArgs<RamContext>): Promise<Record<string, any>>;
+    raw<R, D extends boolean>(rawInput: RawRamQuery<any>, docsOnly?: D, ...args: ContextualArgs<RamContext>): Promise<import("..").RawResult<R, D>>;
+}

package/lib/esm/fs/FilesystemAdapter.js

@@ -0,0 +1,430 @@
+import { promises as defaultFs, watch as fsWatch } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { Model } from "@decaf-ts/decorator-validation";
+import { OperationKeys } from "@decaf-ts/db-decorators";
+import { PersistenceKeys } from "./../persistence/constants.js";
+import { RamAdapter } from "./../ram/index.js";
+import { deserializeId, encodeId, ensureDir, readDirSafe, readJsonFile, removeFile, serializeId, writeJsonAtomic, fileExists, } from "./helpers.js";
+import { FilesystemMultiLock } from "./locks/FilesystemMultiLock.js";
+import { FsDispatch } from "./FsDispatch.js";
+import { FsIndexStore, toIndexFileName } from "./indexStore.js";
+export class FilesystemAdapter extends RamAdapter {
+    constructor(conf = {}, alias = "fs") {
+        const fsImpl = conf.fs ?? defaultFs;
+        const aliasName = alias || "fs";
+        const rootDir = conf.rootDir ?? path.join(tmpdir(), "decaf-fs-adapter");
+        const dbPath = path.join(rootDir, aliasName);
+        const lockDir = conf.lockDir ?? path.join(dbPath, "locks");
+        const lock = conf.lock ??
+            new FilesystemMultiLock(lockDir, fsImpl);
+        const normalizedConfig = Object.assign({}, conf, {
+            fs: fsImpl,
+            rootDir,
+            lockDir,
+            lock,
+        });
+        super(normalizedConfig, alias);
+        this.pkColumnCache = new WeakMap();
+        this.indexDescriptorCache = new WeakMap();
+        this.tableWatchers = new Map();
+        this.watching = false;
+        this.pendingObserverRefresh = new Map();
+        this.fs = fsImpl;
+        this.jsonSpacing = conf.jsonSpacing;
+        this.onHydrated = conf.onHydrated;
+        this.rootDir = rootDir;
+        this.dbPath = dbPath;
+        this.indexStore = new FsIndexStore(this.fs, (tableName) => this.indexesPath(tableName), this.jsonSpacing);
+        this.watchDebounceMs = conf.watchDebounceMs ?? 50;
+        this.ready = this.initializeFromDisk();
+        this.ready.then(() => this.ensureWatching().catch((error) => this.log
+            .for(this.ensureWatching)
+            .error(`Filesystem watcher setup failed: ${error}`)));
+    }
+    getFs() {
+        return this.fs;
+    }
+    getStoragePath() {
+        return this.dbPath;
+    }
+    getTablePath(tableName) {
+        return this.tablePath(tableName);
+    }
+    getIndexesPath(tableName) {
+        return this.indexesPath(tableName);
+    }
+    Dispatch() {
+        return new FsDispatch();
+    }
+    async initializeFromDisk() {
+        await ensureDir(this.fs, this.dbPath);
+        const tables = await readDirSafe(this.fs, this.dbPath);
+        for (const entry of tables) {
+            if (!entry.isDirectory())
+                continue;
+            const tableName = entry.name;
+            const tableDir = path.join(this.dbPath, tableName);
+            const map = this.client.get(tableName) ?? new Map();
+            this.client.set(tableName, map);
+            const rows = await readDirSafe(this.fs, tableDir);
+            let hydrated = 0;
+            for (const row of rows) {
+                if (row.isDirectory())
+                    continue;
+                if (!row.name.endsWith(".json"))
+                    continue;
+                const payload = await readJsonFile(this.fs, path.join(tableDir, row.name));
+                if (!payload)
+                    continue;
+                map.set(deserializeId(payload.id), payload.record);
+                hydrated += 1;
+            }
+            if (hydrated) {
+                this.onHydrated?.({ table: tableName, records: hydrated });
+            }
+        }
+    }
+    async ensureWatching() {
+        if (this.watching)
+            return;
+        await this.ensureReady();
+        this.watching = true;
+        this.startRootWatcher();
+        const tables = await readDirSafe(this.fs, this.dbPath);
+        for (const entry of tables) {
+            if (!entry.isDirectory())
+                continue;
+            await this.watchTable(entry.name);
+        }
+    }
+    stopWatching() {
+        if (!this.watching)
+            return;
+        this.watching = false;
+        this.rootWatcher?.close();
+        this.rootWatcher = undefined;
+        for (const watcher of this.tableWatchers.values()) {
+            watcher.close();
+        }
+        this.tableWatchers.clear();
+        this.clearPendingObserverRefresh();
+    }
+    async ensureReady() {
+        await this.ready;
+    }
+    startRootWatcher() {
+        if (this.rootWatcher)
+            return;
+        this.rootWatcher = fsWatch(this.dbPath, { persistent: false }, (event, filename) => void this.handleRootEvent(event, filename));
+        this.rootWatcher.on("error", (error) => this.log.for(this.startRootWatcher).error(`Filesystem root watcher error: ${error}`));
+    }
+    async handleRootEvent(event, filename) {
+        if (event !== "rename")
+            return;
+        const tableName = this.normalizeFilename(filename);
+        if (!tableName)
+            return;
+        const tableDir = this.tablePath(tableName);
+        if (await this.directoryExists(tableDir)) {
+            await this.watchTable(tableName);
+        }
+        else {
+            this.unwatchTable(tableName);
+        }
+    }
+    normalizeFilename(filename) {
+        if (!filename)
+            return undefined;
+        return typeof filename === "string"
+            ? filename
+            : filename.toString("utf8");
+    }
+    scheduleObserverRefresh(tableName, event, id) {
+        if (!this.dispatch)
+            return;
+        const pending = this.pendingObserverRefresh.get(tableName);
+        if (pending) {
+            clearTimeout(pending.timer);
+            pending.event = event;
+            pending.id = id;
+            pending.timer = setTimeout(() => this.flushObserverRefresh(tableName), this.watchDebounceMs);
+            return;
+        }
+        const timer = setTimeout(() => this.flushObserverRefresh(tableName), this.watchDebounceMs);
+        this.pendingObserverRefresh.set(tableName, { timer, event, id });
+    }
+    flushObserverRefresh(tableName) {
+        const pending = this.pendingObserverRefresh.get(tableName);
+        if (!pending)
+            return;
+        this.pendingObserverRefresh.delete(tableName);
+        const { event, id } = pending;
+        const { ctxArgs } = this.logCtx([], this.flushObserverRefresh);
+        this.refresh(tableName, event, id, ...ctxArgs).catch((error) => this.log
+            .for(this.flushObserverRefresh)
+            .error(`Failed to refresh observers for ${tableName}: ${error}`));
+    }
+    clearPendingObserverRefresh(tableName) {
+        if (tableName) {
+            const pending = this.pendingObserverRefresh.get(tableName);
+            if (!pending)
+                return;
+            clearTimeout(pending.timer);
+            this.pendingObserverRefresh.delete(tableName);
+            return;
+        }
+        for (const pending of this.pendingObserverRefresh.values()) {
+            clearTimeout(pending.timer);
+        }
+        this.pendingObserverRefresh.clear();
+    }
+    async watchTable(tableName) {
+        if (!this.watching)
+            return;
+        if (this.tableWatchers.has(tableName))
+            return;
+        const tableDir = this.tablePath(tableName);
+        if (!(await this.directoryExists(tableDir)))
+            return;
+        const watcher = fsWatch(tableDir, { persistent: false }, (event, filename) => void this.handleTableEvent(tableName, event, filename));
+        watcher.on("error", (error) => this.log.for(this.watchTable).error(`Watcher error for ${tableName}: ${error}`));
+        this.tableWatchers.set(tableName, watcher);
+    }
+    unwatchTable(tableName) {
+        const watcher = this.tableWatchers.get(tableName);
+        if (watcher) {
+            watcher.close();
+            this.tableWatchers.delete(tableName);
+        }
+        this.client.delete(tableName);
+    }
+    async handleTableEvent(tableName, event, filename) {
+        const fileName = this.normalizeFilename(filename);
+        if (!fileName || !fileName.endsWith(".json"))
+            return;
+        if (fileName === "indexes" || fileName.startsWith("indexes"))
+            return;
+        const targetPath = path.join(this.tablePath(tableName), fileName);
+        if (!(await fileExists(this.fs, targetPath))) {
+            const removedId = this.removeRecordFromMap(tableName, fileName);
+            if (removedId !== undefined) {
+                this.scheduleObserverRefresh(tableName, OperationKeys.DELETE, removedId);
+            }
+            return;
+        }
+        const payload = await readJsonFile(this.fs, targetPath);
+        if (!payload)
+            return;
+        const id = deserializeId(payload.id);
+        const refreshEvent = this.applyRecord(tableName, payload);
+        this.scheduleObserverRefresh(tableName, refreshEvent, id);
+    }
+    removeRecordFromMap(tableName, fileName) {
+        const table = this.client.get(tableName);
+        if (!table)
+            return;
+        const encoded = fileName.replace(/\.json$/, "");
+        for (const key of table.keys()) {
+            const candidate = key;
+            if (encodeId(candidate) === encoded) {
+                table.delete(candidate);
+                return candidate;
+            }
+        }
+        return undefined;
+    }
+    applyRecord(tableName, payload) {
+        const map = this.client.get(tableName) ?? new Map();
+        const id = deserializeId(payload.id);
+        const existed = map.has(id);
+        map.set(id, payload.record);
+        this.client.set(tableName, map);
+        return existed ? OperationKeys.UPDATE : OperationKeys.CREATE;
+    }
+    async hydrateTable(tableName) {
+        const tableDir = this.tablePath(tableName);
+        if (!(await this.directoryExists(tableDir)))
+            return;
+        const map = new Map();
+        const rows = await readDirSafe(this.fs, tableDir);
+        for (const row of rows) {
+            if (row.isDirectory())
+                continue;
+            if (!row.name.endsWith(".json"))
+                continue;
+            const payload = await readJsonFile(this.fs, path.join(tableDir, row.name));
+            if (!payload)
+                continue;
+            map.set(deserializeId(payload.id), payload.record);
+        }
+        this.client.set(tableName, map);
+    }
+    async directoryExists(dir) {
+        try {
+            const stats = await this.fs.stat(dir);
+            return stats.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    tablePath(tableName) {
+        return path.join(this.dbPath, tableName);
+    }
+    recordPath(tableName, id) {
+        return path.join(this.tablePath(tableName), `${encodeId(id)}.json`);
+    }
+    indexesPath(tableName) {
+        return path.join(this.tablePath(tableName), "indexes");
+    }
+    async writeRecord(tableName, id, record) {
+        const tableDir = this.tablePath(tableName);
+        await ensureDir(this.fs, tableDir);
+        await ensureDir(this.fs, this.indexesPath(tableName));
+        const payload = {
+            id: serializeId(id),
+            record,
+        };
+        const filePath = this.recordPath(tableName, id);
+        await writeJsonAtomic(this.fs, filePath, payload, this.jsonSpacing);
+    }
+    async removeRecord(tableName, id) {
+        const filePath = this.recordPath(tableName, id);
+        await removeFile(this.fs, filePath);
+    }
+    async syncIndexesForWrite(clazz, tableName, id, record, previous) {
+        const descriptors = this.getIndexDescriptors(clazz);
+        if (!descriptors.length)
+            return;
+        await this.indexStore.upsert(tableName, descriptors, id, this.buildIndexSource(clazz, record, id), previous ? this.buildIndexSource(clazz, previous, id) : undefined);
+    }
+    async removeIndexesForRecord(clazz, tableName, id, record) {
+        const descriptors = this.getIndexDescriptors(clazz);
+        if (!descriptors.length)
+            return;
+        await this.indexStore.remove(tableName, descriptors, id, record ? this.buildIndexSource(clazz, record, id) : undefined);
+    }
+    getIndexDescriptors(clazz) {
+        const cached = this.indexDescriptorCache.get(clazz);
+        if (cached)
+            return cached;
+        const indexes = Model.indexes(clazz) || {};
+        const tableName = Model.tableName(clazz);
+        const descriptors = [];
+        Object.entries(indexes).forEach(([property, metadata]) => {
+            const rawMeta = metadata?.[PersistenceKeys.INDEX];
+            if (!rawMeta)
+                return;
+            const flattened = this.collectIndexMetadata(property, rawMeta);
+            flattened.forEach(({ property: targetProp, meta }) => {
+                const columns = this.buildColumns(clazz, targetProp, meta.compositions);
+                const baseName = meta.name ||
+                    [tableName, targetProp, ...(meta.compositions ?? [])].join("_");
+                descriptors.push({
+                    name: baseName,
+                    fileName: toIndexFileName(baseName),
+                    columns,
+                    directions: meta.directions,
+                });
+            });
+        });
+        this.indexDescriptorCache.set(clazz, descriptors);
+        return descriptors;
+    }
+    collectIndexMetadata(property, raw) {
+        if (!raw)
+            return [];
+        const entries = [];
+        const directMeta = this.asIndexMetadata(raw);
+        if (directMeta) {
+            entries.push({ property, meta: directMeta });
+        }
+        Object.entries(raw).forEach(([key, value]) => {
+            if (["directions", "compositions", "name"].includes(key) ||
+                value === undefined ||
+                value === null) {
+                return;
+            }
+            if (typeof value === "object") {
+                entries.push(...this.collectIndexMetadata(key, value));
+            }
+        });
+        return entries;
+    }
+    asIndexMetadata(raw) {
+        const hasMeta = Object.prototype.hasOwnProperty.call(raw, "directions") ||
+            Object.prototype.hasOwnProperty.call(raw, "compositions") ||
+            Object.prototype.hasOwnProperty.call(raw, "name");
+        if (!hasMeta)
+            return undefined;
+        const { directions, compositions, name } = raw;
+        return {
+            directions: directions,
+            compositions: compositions,
+            name: name,
+        };
+    }
+    buildColumns(clazz, property, compositions) {
+        const main = this.columnNameOrFallback(clazz, property);
+        const extras = (compositions ?? []).map((comp) => this.columnNameOrFallback(clazz, comp));
+        return [main, ...extras];
+    }
+    columnNameOrFallback(clazz, property) {
+        try {
+            return Model.columnName(clazz, property);
+        }
+        catch {
+            return property;
+        }
+    }
+    getPkColumn(clazz) {
+        const cached = this.pkColumnCache.get(clazz);
+        if (cached)
+            return cached;
+        const pkProp = Model.pk(clazz);
+        const column = this.columnNameOrFallback(clazz, String(pkProp));
+        this.pkColumnCache.set(clazz, column);
+        return column;
+    }
+    buildIndexSource(clazz, record, id) {
+        const pkColumn = this.getPkColumn(clazz);
+        if (!pkColumn || pkColumn in record)
+            return record;
+        return Object.assign({}, record, { [pkColumn]: id });
+    }
+    async create(clazz, id, model, ...args) {
+        await this.ensureReady();
+        const tableName = Model.tableName(clazz);
+        const record = await super.create(clazz, id, model, ...args);
+        await this.writeRecord(tableName, id, record);
+        await this.syncIndexesForWrite(clazz, tableName, id, record);
+        return record;
+    }
+    async read(clazz, id, ...args) {
+        await this.ensureReady();
+        return super.read(clazz, id, ...args);
+    }
+    async update(clazz, id, model, ...args) {
+        await this.ensureReady();
+        const tableName = Model.tableName(clazz);
+        const previous = this.client.get(tableName)?.get(id);
+        const record = await super.update(clazz, id, model, ...args);
+        await this.writeRecord(tableName, id, record);
+        await this.syncIndexesForWrite(clazz, tableName, id, record, previous);
+        return record;
+    }
+    async delete(clazz, id, ...args) {
+        await this.ensureReady();
+        const tableName = Model.tableName(clazz);
+        const record = await super.delete(clazz, id, ...args);
+        await this.removeRecord(tableName, id);
+        await this.removeIndexesForRecord(clazz, tableName, id, record);
+        return record;
+    }
+    async raw(rawInput, docsOnly = true, ...args) {
+        await this.ensureReady();
+        return super.raw(rawInput, docsOnly, ...args);
+    }
+}
+//# sourceMappingURL=FilesystemAdapter.js.map

package/lib/esm/fs/FilesystemAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilesystemAdapter.js","sourceRoot":"","sources":["../../../src/fs/FilesystemAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,KAAK,IAAI,OAAO,EAAa,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,aAAa,EAAkB,MAAM,yBAAyB,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,sCAAiC;AAE3D,OAAO,EAAE,UAAU,EAAE,0BAAe;AAGpC,OAAO,EAGL,aAAa,EACb,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,GACX,qBAAkB;AACnB,OAAO,EAAE,mBAAmB,EAAE,uCAAoC;AAClE,OAAO,EAAE,UAAU,EAAE,wBAAqB;AAC1C,OAAO,EAAE,YAAY,EAAmB,eAAe,EAAE,wBAAqB;AAQ9E,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAsB/C,YAAY,OAAyB,EAAsB,EAAE,QAAgB,IAAI;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC;QACpC,MAAM,SAAS,GAAG,KAAK,IAAI,IAAI,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,IAAI,GACR,IAAI,CAAC,IAAI;YACT,IAAI,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,gBAAgB,GAAqB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE;YACjE,EAAE,EAAE,MAAM;YACV,OAAO;YACP,OAAO;YACP,IAAI;SACL,CAAC,CAAC;QACH,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QA7BhB,kBAAa,GAAG,IAAI,OAAO,EAA8B,CAAC;QAC1D,yBAAoB,GAAG,IAAI,OAAO,EAGhD,CAAC;QACa,kBAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;QAEtD,aAAQ,GAAG,KAAK,CAAC;QAER,2BAAsB,GAAG,IAAI,GAAG,EAG9C,CAAC;QAkBF,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,YAAY,CAChC,IAAI,CAAC,EAAE,EACP,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAC1C,IAAI,CAAC,WAAW,CACjB,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CACnB,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACpC,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC;aACxB,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CACtD,CACF,CAAC;IACJ,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEM,YAAY,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEM,cAAc,CAAC,SAAiB;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAEkB,QAAQ;QACzB,OAAO,IAAI,UAAU,EAAE,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACnD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,GAAG,CAAC,WAAW,EAAE;oBAAE,SAAS;gBAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,SAAS;gBAC1C,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAC9B,CAAC;gBACF,IAAI,CAAC,OAAO;oBAAE,SAAS;gBACvB,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnD,QAAQ,IAAI,CAAC,CAAC;YAChB,CAAC;YACD,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,cAAc;QACzB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAEM,YAAY;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,2BAA2B,EAAE,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,MAAM,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAEO,gBAAgB;QACtB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,WAAW,GAAG,OAAO,CACxB,IAAI,CAAC,MAAM,EACX,EAAE,UAAU,EAAE,KAAK,EAAE,EACrB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAChE,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,KAAK,CACvC,kCAAkC,KAAK,EAAE,CAC1C,CACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,KAAa,EACb,QAAiC;QAEjC,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,iBAAiB,CACvB,QAAiC;QAEjC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,OAAO,OAAO,QAAQ,KAAK,QAAQ;YACjC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAEO,uBAAuB,CAC7B,SAAiB,EACjB,KAAoB,EACpB,EAAkB;QAElB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;YACtB,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAC1C,IAAI,CAAC,eAAe,CACrB,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAC1C,IAAI,CAAC,eAAe,CACrB,CAAC;QACF,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IAEO,oBAAoB,CAAC,SAAiB;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;QAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CACtE,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC;aAC9B,KAAK,CAAC,mCAAmC,SAAS,KAAK,KAAK,EAAE,CAAC,CACnE,CAAC;IACJ,CAAC;IAEO,2BAA2B,CAAC,SAAkB;QACpD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3D,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,SAAiB;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAAE,OAAO;QACpD,MAAM,OAAO,GAAG,OAAO,CACrB,QAAQ,EACR,EAAE,UAAU,EAAE,KAAK,EAAE,EACrB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAC5E,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,CACjC,qBAAqB,SAAS,KAAK,KAAK,EAAE,CAC3C,CACF,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAEO,YAAY,CAAC,SAAiB;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,SAAiB,EACjB,KAAa,EACb,QAAiC;QAEjC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO;QACrD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAChE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,uBAAuB,CAC1B,SAAS,EACT,aAAa,CAAC,MAAM,EACpB,SAAS,CACV,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAe,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAEO,mBAAmB,CACzB,SAAiB,EACjB,QAAgB;QAEhB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,GAAqB,CAAC;YACxC,IAAI,QAAQ,CAAC,SAAS,CAAC,KAAK,OAAO,EAAE,CAAC;gBACpC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACxB,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,WAAW,CACjB,SAAiB,EACjB,OAAqB;QAErB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAuC,CAAC;QACzF,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC;IAC/D,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,SAAiB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAAE,OAAO;QACpD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuC,CAAC;QAC3D,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,WAAW,EAAE;gBAAE,SAAS;YAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YAC1C,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAC9B,CAAC;YACF,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,GAAW;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,CAAC;IAEO,UAAU,CAAC,SAAiB,EAAE,EAAkB;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;IAEO,WAAW,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,SAAiB,EACjB,EAAkB,EAClB,MAA2B;QAE3B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACnC,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAAiB;YAC5B,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC;YACnB,MAAM;SACP,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,EAAkB;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,KAAqB,EACrB,SAAiB,EACjB,EAAkB,EAClB,MAA2B,EAC3B,QAA8B;QAE9B,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,CAAC,MAAM;YAAE,OAAO;QAChC,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAC1B,SAAS,EACT,WAAW,EACX,EAAE,EACF,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EACxC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,KAAqB,EACrB,SAAiB,EACjB,EAAkB,EAClB,MAA4B;QAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,CAAC,MAAM;YAAE,OAAO;QAChC,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAC1B,SAAS,EACT,WAAW,EACX,EAAE,EACF,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAC9D,CAAC;IACJ,CAAC;IAEO,mBAAmB,CACzB,KAAqB;QAErB,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAA2B,CAAC,CAAC;QAC1E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,WAAW,GAAsB,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE;YACvD,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC,eAAe,CAAC,KAAK,CAEnC,CAAC;YACd,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/D,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;gBACnD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;gBACxE,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI;oBACT,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClE,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC;oBACnC,OAAO;oBACP,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAA2B,EAAE,WAAW,CAAC,CAAC;QACxE,OAAO,WAAW,CAAC;IACrB,CAAC;IAEO,oBAAoB,CAC1B,QAAgB,EAChB,GAAyB;QAEzB,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAqD,EAAE,CAAC;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC3C,IACE,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACpD,KAAK,KAAK,SAAS;gBACnB,KAAK,KAAK,IAAI,EACd,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CACV,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,KAA4B,CAAC,CAChE,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,eAAe,CAAC,GAAwB;QAC9C,MAAM,OAAO,GACX,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC;YACzD,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;QAC/C,OAAO;YACL,UAAU,EAAE,UAAyC;YACrD,YAAY,EAAE,YAA6C;YAC3D,IAAI,EAAE,IAA6B;SACpC,CAAC;IACJ,CAAC;IAEO,YAAY,CAClB,KAAqB,EACrB,QAAgB,EAChB,YAAgC;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAI,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/C,IAAI,CAAC,oBAAoB,CAAI,KAAK,EAAE,IAAI,CAAC,CAC1C,CAAC;QACF,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;IAC3B,CAAC;IAEO,oBAAoB,CAC1B,KAAqB,EACrB,QAAgB;QAEhB,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,QAAmB,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,WAAW,CAAkB,KAAqB;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAA2B,CAAC,CAAC;QACnE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,CAAY,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAI,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAA2B,EAAE,MAAM,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,gBAAgB,CACtB,KAAqB,EACrB,MAA2B,EAC3B,EAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QACnD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAEQ,KAAK,CAAC,MAAM,CACnB,KAAqB,EACrB,EAAkB,EAClB,KAA0B,EAC1B,GAAG,IAAgC;QAEnC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC;IAChB,CAAC;IAEQ,KAAK,CAAC,IAAI,CACjB,KAAqB,EACrB,EAAkB,EAClB,GAAG,IAAgC;QAEnC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAEQ,KAAK,CAAC,MAAM,CACnB,KAAqB,EACrB,EAAkB,EAClB,KAA0B,EAC1B,GAAG,IAAgC;QAEnC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAS,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAEQ,KAAK,CAAC,MAAM,CACnB,KAAqB,EACrB,EAAkB,EAClB,GAAG,IAAgC;QAEnC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC;IAEQ,KAAK,CAAC,GAAG,CAChB,QAA0B,EAC1B,WAAc,IAAS,EACvB,GAAG,IAAgC;QAEnC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAO,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;CACF"}

package/lib/esm/fs/FsDispatch.d.ts

@@ -0,0 +1,7 @@
+import { Dispatch } from "../persistence/Dispatch";
+import type { Adapter } from "../persistence/Adapter";
+import { ContextOf } from "../persistence/types";
+import { MaybeContextualArg } from "../utils/ContextualLoggedClass";
+export declare class FsDispatch<A extends Adapter<any, any, any, any> = Adapter<any, any, any, any>> extends Dispatch<A> {
+    protected initialize(...args: MaybeContextualArg<ContextOf<A>>): Promise<void>;
+}

package/lib/esm/fs/FsDispatch.js

@@ -0,0 +1,20 @@
+import { Dispatch } from "./../persistence/Dispatch.js";
+export class FsDispatch extends Dispatch {
+    async initialize(...args) {
+        await super.initialize(...args);
+        if (!this.adapter)
+            return;
+        const ensureWatching = this.adapter["ensureWatching"];
+        if (typeof ensureWatching !== "function")
+            return;
+        try {
+            await ensureWatching.call(this.adapter);
+        }
+        catch (error) {
+            this.log
+                .for(this.initialize)
+                .error(`Failed to enable filesystem watchers: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=FsDispatch.js.map

package/lib/esm/fs/FsDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsDispatch.js","sourceRoot":"","sources":["../../../src/fs/FsDispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,qCAAgC;AAKnD,MAAM,OAAO,UAEX,SAAQ,QAAW;IACA,KAAK,CAAC,UAAU,CACjC,GAAG,IAAsC;QAEzC,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,cAAc,GAAI,IAAI,CAAC,OAAe,CAAC,gBAAgB,CAAC,CAAC;QAC/D,IAAI,OAAO,cAAc,KAAK,UAAU;YAAE,OAAO;QACjD,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG;iBACL,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC;iBACpB,KAAK,CAAC,yCAAyC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF"}

package/lib/esm/fs/helpers.d.ts

@@ -0,0 +1,17 @@
+import type { Dirent, promises as FsPromises } from "node:fs";
+import { PrimaryKeyType } from "@decaf-ts/db-decorators";
+export type JsonSpacing = number | string | undefined;
+export type SerializedId = {
+    type: "string" | "number" | "bigint";
+    value: string;
+};
+export declare function encodeId(id: PrimaryKeyType): string;
+export declare function serializeId(id: PrimaryKeyType): SerializedId;
+export declare function deserializeId(id: SerializedId): PrimaryKeyType;
+export declare function ensureDir(fs: typeof FsPromises, dir: string): Promise<void>;
+export declare function readJsonFile<T>(fs: typeof FsPromises, filePath: string): Promise<T | undefined>;
+export declare function fileExists(fs: typeof FsPromises, filePath: string): Promise<boolean>;
+export declare function writeJsonAtomic(fs: typeof FsPromises, filePath: string, payload: unknown, spacing?: JsonSpacing): Promise<void>;
+export declare function atomicWrite(fs: typeof FsPromises, filePath: string, contents: string): Promise<void>;
+export declare function removeFile(fs: typeof FsPromises, filePath: string): Promise<void>;
+export declare function readDirSafe(fs: typeof FsPromises, dir: string): Promise<Dirent[]>;

package/lib/esm/fs/helpers.js

@@ -0,0 +1,64 @@
+export function encodeId(id) {
+    return encodeURIComponent(String(id));
+}
+export function serializeId(id) {
+    if (typeof id === "number") {
+        return { type: "number", value: id.toString() };
+    }
+    if (typeof id === "bigint") {
+        return { type: "bigint", value: id.toString() };
+    }
+    return { type: "string", value: String(id) };
+}
+export function deserializeId(id) {
+    switch (id.type) {
+        case "number":
+            return Number(id.value);
+        case "bigint":
+            return BigInt(id.value);
+        default:
+            return id.value;
+    }
+}
+export async function ensureDir(fs, dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+export async function readJsonFile(fs, filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function fileExists(fs, filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function writeJsonAtomic(fs, filePath, payload, spacing) {
+    const contents = JSON.stringify(payload, null, spacing);
+    await atomicWrite(fs, filePath, contents);
+}
+export async function atomicWrite(fs, filePath, contents) {
+    const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    await fs.writeFile(tmp, contents);
+    await fs.rename(tmp, filePath);
+}
+export async function removeFile(fs, filePath) {
+    await fs.rm(filePath, { force: true });
+}
+export async function readDirSafe(fs, dir) {
+    try {
+        return await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/lib/esm/fs/helpers.js.map

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

package/lib/esm/fs/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./FilesystemAdapter";
+export * from "./types";
+export * from "./helpers";
+export * from "./indexStore";

package/lib/esm/fs/index.js

@@ -0,0 +1,5 @@
+export * from "./FilesystemAdapter.js";
+export * from "./types.js";
+export * from "./helpers.js";
+export * from "./indexStore.js";
+//# sourceMappingURL=index.js.map