@waifucave/discord-waifus 1.5.154

package/dist/storage/storageService.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { RevisionedRecord } from "../shared/schemas/common.js";
+import { ResourceLockManager } from "./locks.js";
+export type UpdateRevisionedJsonOptions<T extends RevisionedRecord> = {
+    resourceKey: string;
+    relativePath: string;
+    schema: z.ZodType<T>;
+    fallback: T;
+    expectedRevision?: number;
+    transform: (current: T) => Promise<T> | T;
+};
+export declare class StorageService {
+    readonly dataRoot: string;
+    readonly locks: ResourceLockManager;
+    constructor(dataRoot: string, options?: {
+        locks?: ResourceLockManager;
+        lockWaitWarnThresholdMs?: number;
+        onLockWait?: (resourceKey: string, waitMs: number) => void;
+    });
+    readJson<T>(relativePath: string, schema: z.ZodType<T>, fallback?: T): Promise<T>;
+    writeJson<T>(resourceKey: string, relativePath: string, schema: z.ZodType<T>, value: T): Promise<T>;
+    updateRevisionedJson<T extends RevisionedRecord>(options: UpdateRevisionedJsonOptions<T>): Promise<T>;
+    withLocks<T>(resourceKeys: string[], task: () => Promise<T> | T): Promise<T>;
+    dataPath(...segments: string[]): string;
+}

package/dist/storage/storageService.js

@@ -0,0 +1,66 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { CURRENT_SCHEMA_VERSION, bumpRevision } from "../shared/schemas/common.js";
+import { resolveDataPath } from "../config/paths.js";
+import { atomicWriteJson, recoverAtomicWriteTemps } from "./atomic.js";
+import { StorageConflictError, StorageValidationError } from "./errors.js";
+import { ResourceLockManager } from "./locks.js";
+export class StorageService {
+    dataRoot;
+    locks;
+    constructor(dataRoot, options = {}) {
+        this.dataRoot = dataRoot;
+        this.locks =
+            options.locks ??
+                new ResourceLockManager(options.lockWaitWarnThresholdMs ?? 250, options.onLockWait);
+    }
+    async readJson(relativePath, schema, fallback) {
+        const filePath = resolveDataPath(this.dataRoot, relativePath);
+        await recoverAtomicWriteTemps(filePath);
+        try {
+            const raw = await readFile(filePath, "utf8");
+            const parsed = JSON.parse(raw);
+            return schema.parse(parsed);
+        }
+        catch (error) {
+            if (error.code === "ENOENT" && fallback !== undefined) {
+                return schema.parse(structuredClone(fallback));
+            }
+            if (error instanceof z.ZodError || error instanceof SyntaxError) {
+                throw new StorageValidationError(`Invalid JSON record at ${relativePath}`, { cause: error });
+            }
+            throw error;
+        }
+    }
+    async writeJson(resourceKey, relativePath, schema, value) {
+        return this.locks.withLock(resourceKey, async () => {
+            const parsed = schema.parse(value);
+            await atomicWriteJson(resolveDataPath(this.dataRoot, relativePath), parsed);
+            return parsed;
+        });
+    }
+    async updateRevisionedJson(options) {
+        return this.locks.withLock(options.resourceKey, async () => {
+            const current = await this.readJson(options.relativePath, options.schema, options.fallback);
+            if (options.expectedRevision !== undefined &&
+                current.revision !== options.expectedRevision) {
+                throw new StorageConflictError("Record has changed since it was read.", current);
+            }
+            const transformed = await options.transform(structuredClone(current));
+            const next = options.schema.parse(bumpRevision({
+                ...transformed,
+                schemaVersion: CURRENT_SCHEMA_VERSION
+            }));
+            await atomicWriteJson(resolveDataPath(this.dataRoot, options.relativePath), next);
+            return next;
+        });
+    }
+    async withLocks(resourceKeys, task) {
+        return this.locks.withLocks(resourceKeys, task);
+    }
+    dataPath(...segments) {
+        return path.join(this.dataRoot, ...segments);
+    }
+}
+//# sourceMappingURL=storageService.js.map

package/dist/storage/storageService.js.map

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