@decaf-ts/core 0.8.50 → 0.8.52

package/lib/fs/FilesystemAdapter.cjs

@@ -0,0 +1,437 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesystemAdapter = void 0;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = __importDefault(require("node:path"));
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const constants_1 = require("./../persistence/constants.cjs");
+const ram_1 = require("./../ram/index.cjs");
+const helpers_1 = require("./helpers.cjs");
+const FilesystemMultiLock_1 = require("./locks/FilesystemMultiLock.cjs");
+const FsDispatch_1 = require("./FsDispatch.cjs");
+const indexStore_1 = require("./indexStore.cjs");
+class FilesystemAdapter extends ram_1.RamAdapter {
+    constructor(conf = {}, alias = "fs") {
+        const fsImpl = conf.fs ?? node_fs_1.promises;
+        const aliasName = alias || "fs";
+        const rootDir = conf.rootDir ?? node_path_1.default.join((0, node_os_1.tmpdir)(), "decaf-fs-adapter");
+        const dbPath = node_path_1.default.join(rootDir, aliasName);
+        const lockDir = conf.lockDir ?? node_path_1.default.join(dbPath, "locks");
+        const lock = conf.lock ??
+            new FilesystemMultiLock_1.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 indexStore_1.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_1.FsDispatch();
+    }
+    async initializeFromDisk() {
+        await (0, helpers_1.ensureDir)(this.fs, this.dbPath);
+        const tables = await (0, helpers_1.readDirSafe)(this.fs, this.dbPath);
+        for (const entry of tables) {
+            if (!entry.isDirectory())
+                continue;
+            const tableName = entry.name;
+            const tableDir = node_path_1.default.join(this.dbPath, tableName);
+            const map = this.client.get(tableName) ?? new Map();
+            this.client.set(tableName, map);
+            const rows = await (0, helpers_1.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 (0, helpers_1.readJsonFile)(this.fs, node_path_1.default.join(tableDir, row.name));
+                if (!payload)
+                    continue;
+                map.set((0, helpers_1.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 (0, helpers_1.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 = (0, node_fs_1.watch)(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 = (0, node_fs_1.watch)(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 = node_path_1.default.join(this.tablePath(tableName), fileName);
+        if (!(await (0, helpers_1.fileExists)(this.fs, targetPath))) {
+            const removedId = this.removeRecordFromMap(tableName, fileName);
+            if (removedId !== undefined) {
+                this.scheduleObserverRefresh(tableName, db_decorators_1.OperationKeys.DELETE, removedId);
+            }
+            return;
+        }
+        const payload = await (0, helpers_1.readJsonFile)(this.fs, targetPath);
+        if (!payload)
+            return;
+        const id = (0, helpers_1.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 ((0, helpers_1.encodeId)(candidate) === encoded) {
+                table.delete(candidate);
+                return candidate;
+            }
+        }
+        return undefined;
+    }
+    applyRecord(tableName, payload) {
+        const map = this.client.get(tableName) ?? new Map();
+        const id = (0, helpers_1.deserializeId)(payload.id);
+        const existed = map.has(id);
+        map.set(id, payload.record);
+        this.client.set(tableName, map);
+        return existed ? db_decorators_1.OperationKeys.UPDATE : db_decorators_1.OperationKeys.CREATE;
+    }
+    async hydrateTable(tableName) {
+        const tableDir = this.tablePath(tableName);
+        if (!(await this.directoryExists(tableDir)))
+            return;
+        const map = new Map();
+        const rows = await (0, helpers_1.readDirSafe)(this.fs, tableDir);
+        for (const row of rows) {
+            if (row.isDirectory())
+                continue;
+            if (!row.name.endsWith(".json"))
+                continue;
+            const payload = await (0, helpers_1.readJsonFile)(this.fs, node_path_1.default.join(tableDir, row.name));
+            if (!payload)
+                continue;
+            map.set((0, helpers_1.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 node_path_1.default.join(this.dbPath, tableName);
+    }
+    recordPath(tableName, id) {
+        return node_path_1.default.join(this.tablePath(tableName), `${(0, helpers_1.encodeId)(id)}.json`);
+    }
+    indexesPath(tableName) {
+        return node_path_1.default.join(this.tablePath(tableName), "indexes");
+    }
+    async writeRecord(tableName, id, record) {
+        const tableDir = this.tablePath(tableName);
+        await (0, helpers_1.ensureDir)(this.fs, tableDir);
+        await (0, helpers_1.ensureDir)(this.fs, this.indexesPath(tableName));
+        const payload = {
+            id: (0, helpers_1.serializeId)(id),
+            record,
+        };
+        const filePath = this.recordPath(tableName, id);
+        await (0, helpers_1.writeJsonAtomic)(this.fs, filePath, payload, this.jsonSpacing);
+    }
+    async removeRecord(tableName, id) {
+        const filePath = this.recordPath(tableName, id);
+        await (0, helpers_1.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 = decorator_validation_1.Model.indexes(clazz) || {};
+        const tableName = decorator_validation_1.Model.tableName(clazz);
+        const descriptors = [];
+        Object.entries(indexes).forEach(([property, metadata]) => {
+            const rawMeta = metadata?.[constants_1.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: (0, indexStore_1.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 decorator_validation_1.Model.columnName(clazz, property);
+        }
+        catch {
+            return property;
+        }
+    }
+    getPkColumn(clazz) {
+        const cached = this.pkColumnCache.get(clazz);
+        if (cached)
+            return cached;
+        const pkProp = decorator_validation_1.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 = decorator_validation_1.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 = decorator_validation_1.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 = decorator_validation_1.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);
+    }
+}
+exports.FilesystemAdapter = FilesystemAdapter;
+//# sourceMappingURL=FilesystemAdapter.js.map

package/lib/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/fs/FilesystemAdapter.js.map

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

package/lib/fs/FsDispatch.cjs

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsDispatch = void 0;
+const Dispatch_1 = require("./../persistence/Dispatch.cjs");
+class FsDispatch extends Dispatch_1.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}`);
+        }
+    }
+}
+exports.FsDispatch = FsDispatch;
+//# sourceMappingURL=FsDispatch.js.map

package/lib/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/fs/FsDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsDispatch.js","sourceRoot":"","sources":["../../src/fs/FsDispatch.ts"],"names":[],"mappings":";;;AAAA,4DAAmD;AAKnD,MAAa,UAEX,SAAQ,mBAAW;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;AAlBD,gCAkBC"}

package/lib/fs/helpers.cjs

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

package/lib/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[]>;