happy2 0.0.5

package/packages/happy2-server/dist/modules/files/quota.d.ts

@@ -0,0 +1,58 @@
+export type QuotaScope = "user" | "server";
+export declare class QuotaExceededError extends Error {
+    readonly scope: QuotaScope;
+    readonly limit: number;
+    constructor(scope: QuotaScope, limit: number);
+}
+export interface QuotaReservation {
+    id: string;
+    ownerUserId: string;
+    bytes: number;
+    state: "reserved" | "committed";
+}
+/** A distributed deployment can replace this with a transactional shared ledger. */
+export interface FileQuotaPolicy {
+    reserve(input: {
+        id: string;
+        ownerUserId: string;
+        bytes: number;
+    }): Promise<void>;
+    resizeReservation(id: string, actualBytes: number): Promise<void>;
+    commit(id: string, actualBytes: number): Promise<void>;
+    release(id: string): Promise<void>;
+    reconcileCommitted(files: Iterable<{
+        id: string;
+        ownerUserId: string;
+        bytes: number;
+    }>): Promise<void>;
+}
+export declare class LocalFileQuotaPolicy implements FileQuotaPolicy {
+    private readonly limits;
+    private readonly committedBytes;
+    private readonly metadataDirectory;
+    private readonly ledgerPath;
+    private readonly lockPath;
+    private queue;
+    constructor(directory: string, limits: {
+        perUserBytes: number;
+        serverBytes: number;
+    }, committedBytes: () => Promise<number>);
+    reserve(input: {
+        id: string;
+        ownerUserId: string;
+        bytes: number;
+    }): Promise<void>;
+    resizeReservation(id: string, actualBytes: number): Promise<void>;
+    commit(id: string, actualBytes: number): Promise<void>;
+    release(id: string): Promise<void>;
+    reconcileCommitted(files: Iterable<{
+        id: string;
+        ownerUserId: string;
+        bytes: number;
+    }>): Promise<void>;
+    private assertCapacity;
+    private update;
+    private readLedger;
+    private serialized;
+}
+//# sourceMappingURL=quota.d.ts.map

package/packages/happy2-server/dist/modules/files/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../../sources/modules/files/quota.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3C,qBAAa,kBAAmB,SAAQ,KAAK;IAErC,QAAQ,CAAC,KAAK,EAAE,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAF1B,YACa,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EAIzB;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,GAAG,WAAW,CAAC;CACnC;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,kBAAkB,CACd,KAAK,EAAE,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GACpE,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAOD,qBAAa,oBAAqB,YAAW,eAAe;IAQpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IARnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAAoC;IAEjD,YACI,SAAS,EAAE,MAAM,EACA,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EACrD,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAKzD;IAEK,OAAO,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtF;IAEK,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtE;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3D;IAEK,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvC;IAEK,kBAAkB,CACpB,KAAK,EAAE,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GACpE,OAAO,CAAC,IAAI,CAAC,CAiBf;YAEa,cAAc;YAyBd,MAAM;YAiBN,UAAU;YAwBV,UAAU;CAa3B"}

package/packages/happy2-server/dist/modules/files/quota.js

@@ -0,0 +1,180 @@
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createId } from "@paralleldrive/cuid2";
+import { withFileLock } from "./lock.js";
+export class QuotaExceededError extends Error {
+    scope;
+    limit;
+    constructor(scope, limit) {
+        super(`${scope === "user" ? "User" : "Server"} file quota exceeded`);
+        this.scope = scope;
+        this.limit = limit;
+        this.name = "QuotaExceededError";
+    }
+}
+export class LocalFileQuotaPolicy {
+    limits;
+    committedBytes;
+    metadataDirectory;
+    ledgerPath;
+    lockPath;
+    queue = Promise.resolve();
+    constructor(directory, limits, committedBytes) {
+        this.limits = limits;
+        this.committedBytes = committedBytes;
+        this.metadataDirectory = join(directory, ".metadata");
+        this.ledgerPath = join(this.metadataDirectory, "quota.json");
+        this.lockPath = join(this.metadataDirectory, "quota.lock");
+    }
+    async reserve(input) {
+        if (!Number.isSafeInteger(input.bytes) || input.bytes < 1)
+            throw new Error("Quota reservation must contain a positive safe byte count");
+        await this.update(async (ledger) => {
+            const existing = ledger.entries[input.id];
+            if (existing) {
+                if (existing.ownerUserId === input.ownerUserId &&
+                    existing.bytes === input.bytes &&
+                    existing.state === "reserved")
+                    return false;
+                throw new Error("Quota reservation already exists");
+            }
+            await this.assertCapacity(ledger, input.ownerUserId, input.bytes);
+            ledger.entries[input.id] = { ...input, state: "reserved" };
+            return true;
+        });
+    }
+    async resizeReservation(id, actualBytes) {
+        validByteCount(actualBytes);
+        await this.update(async (ledger) => {
+            const reservation = ledger.entries[id];
+            if (!reservation || reservation.state !== "reserved")
+                throw new Error("Quota reservation does not exist");
+            const delta = actualBytes - reservation.bytes;
+            if (delta > 0)
+                await this.assertCapacity(ledger, reservation.ownerUserId, delta);
+            reservation.bytes = actualBytes;
+            return true;
+        });
+    }
+    async commit(id, actualBytes) {
+        validByteCount(actualBytes);
+        await this.update(async (ledger) => {
+            const reservation = ledger.entries[id];
+            if (!reservation || reservation.state !== "reserved")
+                throw new Error("Quota reservation does not exist");
+            const delta = actualBytes - reservation.bytes;
+            if (delta > 0)
+                await this.assertCapacity(ledger, reservation.ownerUserId, delta);
+            reservation.bytes = actualBytes;
+            reservation.state = "committed";
+            return true;
+        });
+    }
+    async release(id) {
+        await this.update(async (ledger) => {
+            if (!ledger.entries[id])
+                return false;
+            delete ledger.entries[id];
+            return true;
+        });
+    }
+    async reconcileCommitted(files) {
+        const committed = [...files];
+        for (const file of committed)
+            validByteCount(file.bytes);
+        await this.update(async (ledger) => {
+            const entries = {};
+            for (const entry of Object.values(ledger.entries))
+                if (entry.state === "reserved")
+                    entries[entry.id] = entry;
+            for (const file of committed)
+                entries[file.id] = {
+                    id: file.id,
+                    ownerUserId: file.ownerUserId,
+                    bytes: file.bytes,
+                    state: "committed",
+                };
+            ledger.entries = entries;
+            return true;
+        });
+    }
+    async assertCapacity(ledger, ownerUserId, addedBytes) {
+        if (this.limits.perUserBytes > 0) {
+            const used = Object.values(ledger.entries)
+                .filter((entry) => entry.ownerUserId === ownerUserId)
+                .reduce((sum, entry) => sum + entry.bytes, 0);
+            if (used + addedBytes > this.limits.perUserBytes)
+                throw new QuotaExceededError("user", this.limits.perUserBytes);
+        }
+        if (this.limits.serverBytes > 0) {
+            const reserved = Object.values(ledger.entries)
+                .filter((entry) => entry.state === "reserved")
+                .reduce((sum, entry) => sum + entry.bytes, 0);
+            const trackedCommitted = Object.values(ledger.entries)
+                .filter((entry) => entry.state === "committed")
+                .reduce((sum, entry) => sum + entry.bytes, 0);
+            const committed = Math.max(await this.committedBytes(), trackedCommitted);
+            if (committed + reserved + addedBytes > this.limits.serverBytes)
+                throw new QuotaExceededError("server", this.limits.serverBytes);
+        }
+    }
+    async update(operation) {
+        await this.serialized(async () => {
+            await mkdir(this.metadataDirectory, { recursive: true, mode: 0o700 });
+            await withFileLock(this.lockPath, async () => {
+                const ledger = await this.readLedger();
+                if (!(await operation(ledger)))
+                    return;
+                const temporary = join(this.metadataDirectory, `.quota.${createId()}.tmp`);
+                await writeFile(temporary, JSON.stringify(ledger), { mode: 0o600 });
+                try {
+                    await rename(temporary, this.ledgerPath);
+                }
+                finally {
+                    await rm(temporary, { force: true });
+                }
+            });
+        });
+    }
+    async readLedger() {
+        try {
+            const parsed = JSON.parse(await readFile(this.ledgerPath, "utf8"));
+            if (parsed.version !== 1 || !parsed.entries || typeof parsed.entries !== "object")
+                throw new Error("Unsupported quota ledger");
+            for (const [id, entry] of Object.entries(parsed.entries)) {
+                if (entry.id !== id ||
+                    typeof entry.ownerUserId !== "string" ||
+                    !entry.ownerUserId ||
+                    !Number.isSafeInteger(entry.bytes) ||
+                    entry.bytes < 1 ||
+                    (entry.state !== "reserved" && entry.state !== "committed"))
+                    throw new Error("Corrupt quota ledger");
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return { version: 1, entries: {} };
+            throw error;
+        }
+    }
+    async serialized(operation) {
+        const previous = this.queue;
+        let release;
+        this.queue = new Promise((resolve) => {
+            release = resolve;
+        });
+        await previous;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+        }
+    }
+}
+function validByteCount(value) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new Error("Quota byte count must be a positive safe integer");
+}
+//# sourceMappingURL=quota.js.map

package/packages/happy2-server/dist/modules/files/quota.js.map

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

package/packages/happy2-server/dist/modules/files/routes.test.d.ts

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

package/packages/happy2-server/dist/modules/files/routes.test.d.ts.map

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

package/packages/happy2-server/dist/modules/files/routes.test.js

@@ -0,0 +1,163 @@
+import { generateKeyPairSync } from "node:crypto";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import sharp from "sharp";
+import { afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
+import { buildServer } from "../../server.js";
+import { TokenService } from "../auth/tokens.js";
+import { defaultConfig } from "../config/defaults.js";
+import { Database } from "../database.js";
+describe("file pipeline HTTP API", () => {
+    let app;
+    let database;
+    let directory;
+    beforeAll(() => {
+        const pair = generateKeyPairSync("rsa", {
+            modulusLength: 2048,
+            publicKeyEncoding: { type: "spki", format: "pem" },
+            privateKeyEncoding: { type: "pkcs8", format: "pem" },
+        });
+        process.env.HAPPY2_JWT_PRIVATE_KEY_B64 = Buffer.from(pair.privateKey).toString("base64");
+        process.env.HAPPY2_JWT_PUBLIC_KEY_B64 = Buffer.from(pair.publicKey).toString("base64");
+        process.env.HAPPY2_PASSWORD_PEPPER = "file-route-test-pepper";
+    });
+    beforeEach(async () => {
+        directory = await mkdtemp(join(tmpdir(), "happy2-file-routes-"));
+        const config = defaultConfig();
+        config.database.url = `file:${join(directory, "happy2.db")}`;
+        config.files.directory = join(directory, "files");
+        config.agents.enabled = false;
+        database = new Database(config.database.url);
+        await database.migrate();
+        app = await buildServer(config, {
+            database,
+            tokens: await TokenService.create(config),
+        });
+    });
+    afterEach(async () => {
+        await app.close();
+        database.close();
+        await rm(directory, { recursive: true, force: true });
+    });
+    it("persists resumable offsets and completes the attachment", async () => {
+        const owner = await registerUser(app, "owner@example.com", "file_owner");
+        const stranger = await registerUser(app, "stranger@example.com", "file_stranger");
+        const created = await app.inject({
+            method: "POST",
+            url: "/v0/files/createUpload",
+            headers: bearer(owner.token),
+            payload: { filename: "resume.txt", contentType: "text/plain", size: 6 },
+        });
+        expect(created.statusCode).toBe(201);
+        const uploadId = created.json().upload.id;
+        const first = await appendChunk(app, owner.token, uploadId, 0, Buffer.from("abc"));
+        expect(first.statusCode).toBe(200);
+        expect(first.json().upload.offset).toBe(3);
+        const hidden = await app.inject({
+            method: "GET",
+            url: `/v0/files/${uploadId}/uploadState`,
+            headers: bearer(stranger.token),
+        });
+        expect(hidden.statusCode).toBe(404);
+        const stale = await appendChunk(app, owner.token, uploadId, 0, Buffer.from("x"));
+        expect(stale.statusCode).toBe(409);
+        expect(stale.headers["upload-offset"]).toBe("3");
+        const incomplete = await app.inject({
+            method: "POST",
+            url: `/v0/files/${uploadId}/completeUpload`,
+            headers: bearer(owner.token),
+        });
+        expect(incomplete.statusCode).toBe(409);
+        await appendChunk(app, owner.token, uploadId, 3, Buffer.from("def"));
+        const completed = await app.inject({
+            method: "POST",
+            url: `/v0/files/${uploadId}/completeUpload`,
+            headers: bearer(owner.token),
+        });
+        expect(completed.statusCode).toBe(201);
+        const fileId = completed.json().file.id;
+        const retried = await app.inject({
+            method: "POST",
+            url: `/v0/files/${uploadId}/completeUpload`,
+            headers: bearer(owner.token),
+        });
+        expect(retried.statusCode).toBe(201);
+        expect(retried.json().file.id).toBe(fileId);
+        const download = await app.inject({
+            method: "GET",
+            url: `/v0/files/${fileId}`,
+            headers: bearer(owner.token),
+        });
+        expect(download.body).toBe("abcdef");
+    });
+    it("serves generated previews only through the parent file's privacy check", async () => {
+        const owner = await registerUser(app, "photo@example.com", "photo_owner");
+        const stranger = await registerUser(app, "viewer@example.com", "photo_viewer");
+        const png = await sharp({
+            create: { width: 20, height: 10, channels: 4, background: "#336699" },
+        })
+            .png()
+            .toBuffer();
+        const uploaded = await upload(app, owner.token, "photo.png", "image/png", png);
+        const previewUrl = uploaded.json().file.previewUrl;
+        expect(previewUrl).toBe(`/v0/files/${uploaded.json().file.id}/preview`);
+        const preview = await app.inject({
+            method: "GET",
+            url: previewUrl,
+            headers: bearer(owner.token),
+        });
+        expect(preview.statusCode).toBe(200);
+        expect(preview.headers["content-type"]).toBe("image/webp");
+        const hidden = await app.inject({
+            method: "GET",
+            url: previewUrl,
+            headers: bearer(stranger.token),
+        });
+        expect(hidden.statusCode).toBe(404);
+    });
+});
+async function registerUser(app, email, username) {
+    const registered = await app.inject({
+        method: "POST",
+        url: "/v0/auth/password/register",
+        payload: { email, password: "correct horse battery staple" },
+    });
+    const token = registered.json().token;
+    const profile = await app.inject({
+        method: "POST",
+        url: "/v0/me/createProfile",
+        headers: bearer(token),
+        payload: { firstName: "Files", username, email },
+    });
+    expect(profile.statusCode).toBe(201);
+    return { token };
+}
+function appendChunk(app, token, uploadId, offset, contents) {
+    return upload(app, token, "chunk.bin", "application/octet-stream", contents, {
+        url: `/v0/files/${uploadId}/appendUpload`,
+        headers: { "upload-offset": String(offset) },
+    });
+}
+function upload(app, token, filename, contentType, contents, options = {}) {
+    const boundary = `happy2-file-${Date.now()}`;
+    const payload = Buffer.concat([
+        Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${filename}"\r\nContent-Type: ${contentType}\r\n\r\n`),
+        contents,
+        Buffer.from(`\r\n--${boundary}--\r\n`),
+    ]);
+    return app.inject({
+        method: "POST",
+        url: options.url ?? "/v0/files/upload",
+        headers: {
+            ...bearer(token),
+            "content-type": `multipart/form-data; boundary=${boundary}`,
+            ...options.headers,
+        },
+        payload,
+    });
+}
+function bearer(token) {
+    return { authorization: `Bearer ${token}` };
+}
+//# sourceMappingURL=routes.test.js.map

package/packages/happy2-server/dist/modules/files/routes.test.js.map

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

package/packages/happy2-server/dist/modules/files/scanner.d.ts

@@ -0,0 +1,27 @@
+export type MalwareScanResult = {
+    verdict: "clean";
+} | {
+    verdict: "infected";
+    threat?: string;
+} | {
+    verdict: "error";
+    message: string;
+};
+export interface MalwareScanner {
+    scan(path: string): Promise<MalwareScanResult>;
+}
+export declare class DisabledMalwareScanner implements MalwareScanner {
+    scan(): Promise<MalwareScanResult>;
+}
+/**
+ * Runs a scanner directly without a shell. Exit 0 means clean, 1 means
+ * infected, and every other exit or timeout is treated as a scanner error.
+ */
+export declare class CommandMalwareScanner implements MalwareScanner {
+    private readonly command;
+    private readonly configuredArguments;
+    private readonly timeoutMs;
+    constructor(command: string, configuredArguments: string[], timeoutMs: number);
+    scan(path: string): Promise<MalwareScanResult>;
+}
+//# sourceMappingURL=scanner.d.ts.map

package/packages/happy2-server/dist/modules/files/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../sources/modules/files/scanner.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GACvB;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACpB;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAClD;AAED,qBAAa,sBAAuB,YAAW,cAAc;IACnD,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAEvC;CACJ;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAH9B,YACqB,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,EAAE,EAC7B,SAAS,EAAE,MAAM,EAClC;IAEE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0CnD;CACJ"}

package/packages/happy2-server/dist/modules/files/scanner.js

@@ -0,0 +1,66 @@
+import { spawn } from "node:child_process";
+export class DisabledMalwareScanner {
+    async scan() {
+        return { verdict: "clean" };
+    }
+}
+/**
+ * Runs a scanner directly without a shell. Exit 0 means clean, 1 means
+ * infected, and every other exit or timeout is treated as a scanner error.
+ */
+export class CommandMalwareScanner {
+    command;
+    configuredArguments;
+    timeoutMs;
+    constructor(command, configuredArguments, timeoutMs) {
+        this.command = command;
+        this.configuredArguments = configuredArguments;
+        this.timeoutMs = timeoutMs;
+    }
+    async scan(path) {
+        const hasPlaceholder = this.configuredArguments.some((value) => value.includes("{path}"));
+        const arguments_ = this.configuredArguments.map((value) => value.replaceAll("{path}", path));
+        if (!hasPlaceholder)
+            arguments_.push(path);
+        return new Promise((resolve) => {
+            const child = spawn(this.command, arguments_, {
+                shell: false,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let output = "";
+            const collect = (chunk) => {
+                if (output.length < 16_384)
+                    output += chunk.toString("utf8").slice(0, 16_384 - output.length);
+            };
+            child.stdout.on("data", collect);
+            child.stderr.on("data", collect);
+            let settled = false;
+            let timer;
+            const finish = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timer)
+                    clearTimeout(timer);
+                resolve(result);
+            };
+            timer = setTimeout(() => {
+                child.kill("SIGKILL");
+                finish({ verdict: "error", message: "Malware scanner timed out" });
+            }, this.timeoutMs);
+            timer.unref();
+            child.once("error", (error) => finish({ verdict: "error", message: error.message }));
+            child.once("close", (code, signal) => {
+                if (code === 0)
+                    return finish({ verdict: "clean" });
+                if (code === 1)
+                    return finish({ verdict: "infected", threat: output.trim() || undefined });
+                return finish({
+                    verdict: "error",
+                    message: `Malware scanner failed (${signal ?? code ?? "unknown"})`,
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/packages/happy2-server/dist/modules/files/scanner.js.map

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

package/packages/happy2-server/dist/modules/files/storage.d.ts

@@ -0,0 +1,95 @@
+import { type Readable, type Writable } from "node:stream";
+import type { ServerConfig } from "../config/type.js";
+import type { Database, StoredFile, User } from "../database.js";
+import { type MediaProcessor } from "./media.js";
+import { type ByteRange, type FileStorageProvider, type MediaVariant, type ResumableUpload } from "./provider.js";
+import { type FileQuotaPolicy, type QuotaScope } from "./quota.js";
+import { type MalwareScanner } from "./scanner.js";
+export interface FileStorageFileSystem {
+    mkdir(path: string): Promise<unknown>;
+    readHeader(path: string, maximumBytes: number): Promise<Buffer>;
+    imageSource(path: string): Promise<string | Buffer>;
+    rename(from: string, to: string): Promise<unknown>;
+    rm(path: string): Promise<unknown>;
+    writeFile(path: string, contents: Buffer): Promise<unknown>;
+    createReadStream(path: string, range?: {
+        start: number;
+        end: number;
+    }): Readable;
+    createWriteStream(path: string): Writable;
+}
+export declare class InvalidUploadError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class UploadRejectedError extends Error {
+    readonly reason: "malware" | "scanner_unavailable";
+    constructor(reason: "malware" | "scanner_unavailable");
+}
+export declare class FileQuotaExceededError extends InvalidUploadError {
+    readonly scope: QuotaScope;
+    readonly limit: number;
+    constructor(scope: QuotaScope, limit: number);
+}
+export interface FileStorageOptions {
+    provider?: FileStorageProvider;
+    quota?: FileQuotaPolicy;
+    scanner?: MalwareScanner;
+    mediaProcessor?: MediaProcessor;
+}
+export declare class FileStorage {
+    private readonly config;
+    private readonly database;
+    private readonly provider;
+    private readonly quota;
+    private readonly scanner;
+    private readonly mediaProcessor;
+    constructor(config: ServerConfig, database: Pick<Database, "createFile" | "findFile">, optionsOrFileSystem?: FileStorageOptions | FileStorageFileSystem);
+    saveAvatarUpload(user: User, input: Buffer, isPublic: boolean): Promise<StoredFile>;
+    saveAttachmentUpload(user: User, input: Readable, upload: {
+        filename?: string;
+        contentType?: string;
+    }): Promise<StoredFile>;
+    createResumableUpload(user: User, input: {
+        filename?: string;
+        contentType?: string;
+        size: number;
+    }): Promise<ResumableUpload>;
+    resumableUploadState(userId: string, uploadId: string): Promise<ResumableUpload | undefined>;
+    appendResumableUpload(userId: string, uploadId: string, expectedOffset: number, input: Readable): Promise<ResumableUpload | undefined>;
+    completeResumableUpload(user: User, uploadId: string): Promise<StoredFile | undefined>;
+    cancelResumableUpload(userId: string, uploadId: string): Promise<boolean>;
+    open(file: StoredFile, range?: ByteRange): Readable;
+    variant(file: StoredFile, variant: MediaVariant): Promise<{
+        size: number;
+        contentType: "image/webp";
+        stream: Readable;
+    } | undefined>;
+    variantSizes(file: StoredFile): Promise<Partial<Record<MediaVariant, number>>>;
+    /** Local-only compatibility helper; consumers should prefer open(). */
+    pathFor(file: StoredFile): string;
+    /** Call only after the durable file record and references have been removed. */
+    deleteStoredFile(file: StoredFile): Promise<void>;
+    /**
+     * Maintenance is intentionally caller-driven so deployments can run it
+     * under a distributed lease. It cleans abandoned uploads/quarantine and,
+     * when given the authoritative file records, unreferenced local objects.
+     */
+    runMaintenance(input: {
+        now?: Date;
+        referencedFiles?: Iterable<StoredFile>;
+        orphanGraceMs?: number;
+    }): Promise<{
+        expiredUploadIds: string[];
+        deletedQuarantineObjects: number;
+        deletedOrphanStorageNames: string[];
+    }>;
+    private saveStagedAttachment;
+    private prepareQuota;
+    private assertSafe;
+    private commitFile;
+    createReadStream(file: StoredFile, range?: {
+        start: number;
+        end: number;
+    }): Readable;
+}
+//# sourceMappingURL=storage.d.ts.map

package/packages/happy2-server/dist/modules/files/storage.d.ts.map

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