ba-memorial-lobby-wallpaper-toolkit 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# ba-memorial-lobby-wallpaper-toolkit
+
+Development and packaging tools for Blue Archive memorial-lobby Wallpaper Engine
+projects, published on npm as `ba-memorial-lobby-wallpaper-toolkit` (currently
+`0.1.0`). The initial `/vite` export provides runtime asset delivery and a
+validated local log bridge. Character projects supply the resolved runtime
+bootstrap path and remain responsible for their content assets and Wallpaper
+Engine metadata.
+
+## Install
+
+```powershell
+npm install --save-dev ba-memorial-lobby-wallpaper-toolkit
+```
+
+The toolkit is a build-time dependency of wallpaper instance projects and
+declares `vite` (`>=8.0.0 <9`) as a peer dependency. It is consumed through
+npm version ranges, so build, validation, and packaging improvements propagate
+to existing projects via dependency updates.
+
+## CLI
+
+The package exposes the `memorial-lobby-toolkit` binary:
+
+```text
+memorial-lobby-toolkit checksums --input <dir> --output <path> [--base <dir>] [--verify]
+memorial-lobby-toolkit package --input <dir> --output <path> --timestamp <ISO-8601> [--package-json <path>]
+```
+
+- `checksums` writes a SHA-256 manifest covering every file under `--input`; with
+  `--verify` it checks the manifest at `--output` instead. `--base` sets the path
+  base recorded in the manifest (defaults to the input directory).
+- `package` creates a deterministic offline ZIP archive with a fixed timestamp.
+  A `{version}` placeholder in `--output` is replaced from the version in
+  `--package-json`. The archive is re-read and verified after writing; the tool
+  prints its byte size and SHA-256.
+
+## Library API
+
+- `createChecksumManifest` / `writeChecksumManifest` / `verifyChecksumManifest` —
+  programmatic manifest generation and verification.
+- `validateDistributionFiles` — checks a distribution directory for required
+  files, allowed offline text extensions, and remote dependency patterns.
+- `createOfflinePackage` — builds the deterministic offline ZIP with an
+  embedded SHA-256 manifest and returns the archive path, checksum, and file
+  list.
+
+## Vite plugin
+
+`createMemorialLobbyVitePlugins(options)` from `ba-memorial-lobby-wallpaper-toolkit/vite`
+provides:
+
+- a dev-server route that serves the runtime logging bootstrap script, and
+- a build-time step that persists log sessions under `dist/log/` and serves
+  them through the log route.
+
+Options: `loggingBootstrapPath` (required), `outputDirectory` (default `dist`),
+`logRoute` (default `/__memorial-lobby-log`), and
+`maximumLogBodyCharacters` (default 1 MiB).

package/dist/checksums.d.ts

@@ -0,0 +1,10 @@
+export interface ChecksumManifestOptions {
+    readonly inputDirectory: string;
+    readonly manifestPath: string;
+    readonly pathBase?: string;
+    readonly ignore?: (absolutePath: string) => boolean;
+}
+export declare function createChecksumManifest(options: ChecksumManifestOptions): Promise<string>;
+export declare function writeChecksumManifest(options: ChecksumManifestOptions): Promise<number>;
+export declare function verifyChecksumManifest(options: ChecksumManifestOptions): Promise<number>;
+//# sourceMappingURL=checksums.d.ts.map

package/dist/checksums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksums.d.ts","sourceRoot":"","sources":["../src/checksums.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CACrD;AAoBD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9F;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7F;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9F"}

package/dist/checksums.js

@@ -0,0 +1,52 @@
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { readFile, readdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+async function walk(directory, ignore) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const absolutePath = path.join(directory, entry.name);
+        if (ignore(absolutePath))
+            continue;
+        if (entry.isDirectory())
+            files.push(...await walk(absolutePath, ignore));
+        else if (entry.isFile())
+            files.push(absolutePath);
+    }
+    return files;
+}
+async function sha256(file) {
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(file))
+        hash.update(chunk);
+    return hash.digest("hex");
+}
+export async function createChecksumManifest(options) {
+    const inputDirectory = path.resolve(options.inputDirectory);
+    const pathBase = path.resolve(options.pathBase ?? inputDirectory);
+    const ignore = options.ignore ?? ((absolutePath) => absolutePath.endsWith(".part"));
+    const files = (await walk(inputDirectory, ignore)).sort((left, right) => left.localeCompare(right, "en"));
+    const lines = await Promise.all(files.map(async (file) => {
+        const relative = path.relative(pathBase, file).replace(/\\/g, "/");
+        if (relative.startsWith("../") || path.isAbsolute(relative)) {
+            throw new Error(`Checksum file is outside path base: ${file}`);
+        }
+        return `${await sha256(file)}  ${relative}`;
+    }));
+    return `${lines.join("\n")}\n`;
+}
+export async function writeChecksumManifest(options) {
+    const content = await createChecksumManifest(options);
+    await writeFile(options.manifestPath, content, "utf8");
+    return content === "\n" ? 0 : content.trimEnd().split("\n").length;
+}
+export async function verifyChecksumManifest(options) {
+    const [actual, expected] = await Promise.all([
+        createChecksumManifest(options), readFile(options.manifestPath, "utf8"),
+    ]);
+    if (actual !== expected)
+        throw new Error(`Checksum verification failed: ${options.manifestPath}`);
+    return actual === "\n" ? 0 : actual.trimEnd().split("\n").length;
+}
+//# sourceMappingURL=checksums.js.map

package/dist/checksums.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { verifyChecksumManifest, writeChecksumManifest } from "./checksums.js";
+import { createOfflinePackage } from "./offline-package.js";
+function option(name) {
+    const index = process.argv.indexOf(name);
+    return index < 0 ? undefined : process.argv[index + 1];
+}
+const command = process.argv[2];
+const input = option("--input");
+const output = option("--output");
+if (!input || !output)
+    throw new Error(`${command ?? "command"} requires --input and --output`);
+if (command === "checksums") {
+    const options = {
+        inputDirectory: path.resolve(input),
+        manifestPath: path.resolve(output),
+        pathBase: path.resolve(option("--base") ?? input),
+    };
+    const verify = process.argv.includes("--verify");
+    const count = verify ? await verifyChecksumManifest(options) : await writeChecksumManifest(options);
+    console.log(`${verify ? "Verified" : "Wrote"} ${count} SHA-256 entries.`);
+}
+else if (command === "package") {
+    const timestamp = option("--timestamp");
+    if (!timestamp || Number.isNaN(new Date(timestamp).getTime())) {
+        throw new Error("package requires a valid --timestamp");
+    }
+    const packageJsonPath = option("--package-json");
+    const resolvedOutput = packageJsonPath
+        ? output.replace("{version}", String(JSON.parse(await readFile(path.resolve(packageJsonPath), "utf8")).version))
+        : output;
+    const result = await createOfflinePackage({
+        inputDirectory: input,
+        archivePath: resolvedOutput,
+        fixedTimestamp: new Date(timestamp),
+    });
+    console.log(`Created and verified ${path.basename(result.archivePath)} (${result.size} bytes).`);
+    console.log(`SHA-256: ${result.sha256}`);
+}
+else {
+    throw new Error("Usage: memorial-lobby-toolkit <checksums|package> --input <path> --output <path>");
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/distribution-validation.d.ts

@@ -0,0 +1,8 @@
+export interface DistributionValidationOptions {
+    readonly rootDirectory: string;
+    readonly requiredFiles: readonly string[];
+    readonly offlineTextExtensions?: ReadonlySet<string>;
+    readonly remoteDependencyPattern?: RegExp;
+}
+export declare function validateDistributionFiles(options: DistributionValidationOptions): Promise<void>;
+//# sourceMappingURL=distribution-validation.d.ts.map

package/dist/distribution-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution-validation.d.ts","sourceRoot":"","sources":["../src/distribution-validation.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AAYD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBrG"}

package/dist/distribution-validation.js

@@ -0,0 +1,35 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+async function walk(directory) {
+    const files = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+        const absolute = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            files.push(...await walk(absolute));
+        else if (entry.isFile())
+            files.push(absolute);
+    }
+    return files;
+}
+export async function validateDistributionFiles(options) {
+    const root = path.resolve(options.rootDirectory);
+    for (const relative of options.requiredFiles) {
+        const absolute = path.resolve(root, relative);
+        const prefix = `${root}${path.sep}`;
+        if (!absolute.startsWith(prefix))
+            throw new Error(`Required file escapes distribution: ${relative}`);
+        const info = await stat(absolute).catch(() => undefined);
+        if (!info?.isFile() || info.size === 0)
+            throw new Error(`Invalid distribution file: ${relative}`);
+    }
+    const extensions = options.offlineTextExtensions ?? new Set([".html", ".js", ".css", ".json"]);
+    const remotePattern = options.remoteDependencyPattern ?? /https?:\/\//i;
+    for (const file of await walk(root)) {
+        if (!extensions.has(path.extname(file).toLowerCase()))
+            continue;
+        if (remotePattern.test(await readFile(file, "utf8"))) {
+            throw new Error(`Remote dependency found in ${path.relative(root, file).replace(/\\/g, "/")}`);
+        }
+    }
+}
+//# sourceMappingURL=distribution-validation.js.map

package/dist/distribution-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution-validation.js","sourceRoot":"","sources":["../src/distribution-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,KAAK,UAAU,IAAI,CAAC,SAAiB;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;aACxD,IAAI,KAAK,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAAsC;IACpF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;QACrG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,qBAAqB,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/F,MAAM,aAAa,GAAG,OAAO,CAAC,uBAAuB,IAAI,cAAc,CAAC;IACxE,KAAK,MAAM,IAAI,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QAChE,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./checksums.js";
+export * from "./distribution-validation.js";
+export * from "./offline-package.js";
+export * from "./vite/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./checksums.js";
+export * from "./distribution-validation.js";
+export * from "./offline-package.js";
+export * from "./vite/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/offline-package.d.ts

@@ -0,0 +1,15 @@
+export interface OfflinePackageOptions {
+    readonly inputDirectory: string;
+    readonly archivePath: string;
+    readonly fixedTimestamp: Date;
+    readonly requiredEntry?: string;
+}
+export interface OfflinePackageResult {
+    readonly archivePath: string;
+    readonly checksumPath: string;
+    readonly sha256: string;
+    readonly size: number;
+    readonly files: readonly string[];
+}
+export declare function createOfflinePackage(options: OfflinePackageOptions): Promise<OfflinePackageResult>;
+//# sourceMappingURL=offline-package.d.ts.map

package/dist/offline-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-package.d.ts","sourceRoot":"","sources":["../src/offline-package.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAkED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyCxG"}

package/dist/offline-package.js

@@ -0,0 +1,116 @@
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream } from "node:fs";
+import { mkdir, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { once } from "node:events";
+import yauzl from "yauzl";
+import yazl from "yazl";
+import { createChecksumManifest } from "./checksums.js";
+async function walk(directory, root = directory) {
+    const files = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+        const absolute = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            files.push(...await walk(absolute, root));
+        else if (entry.isFile())
+            files.push({ absolute, relative: path.relative(root, absolute).replace(/\\/g, "/") });
+    }
+    return files;
+}
+async function fileSha256(file) {
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(file))
+        hash.update(chunk);
+    return hash.digest("hex");
+}
+async function verifyArchive(archivePath, inputDirectory, expectedFiles) {
+    const zip = await new Promise((resolve, reject) => yauzl.open(archivePath, { lazyEntries: true }, (error, value) => error || !value ? reject(error ?? new Error("Failed to open ZIP archive")) : resolve(value)));
+    const actualFiles = [];
+    try {
+        zip.readEntry();
+        while (true) {
+            const event = await new Promise((resolve, reject) => {
+                const cleanup = () => {
+                    zip.off("entry", onEntry);
+                    zip.off("end", onEnd);
+                    zip.off("error", onError);
+                };
+                const onEntry = (entry) => { cleanup(); resolve({ entry }); };
+                const onEnd = () => { cleanup(); resolve({}); };
+                const onError = (error) => { cleanup(); reject(error); };
+                zip.once("entry", onEntry);
+                zip.once("end", onEnd);
+                zip.once("error", onError);
+            });
+            if (!event.entry)
+                break;
+            const entry = event.entry;
+            if (/\/$/.test(entry.fileName)) {
+                zip.readEntry();
+                continue;
+            }
+            actualFiles.push(entry.fileName);
+            const sourcePath = path.resolve(inputDirectory, ...entry.fileName.split("/"));
+            const prefix = `${path.resolve(inputDirectory)}${path.sep}`;
+            if (!sourcePath.startsWith(prefix))
+                throw new Error(`Archive entry escapes input directory: ${entry.fileName}`);
+            const stream = await new Promise((resolve, reject) => zip.openReadStream(entry, (error, value) => error ? reject(error) : resolve(value)));
+            const hash = createHash("sha256");
+            for await (const chunk of stream)
+                hash.update(chunk);
+            if (hash.digest("hex") !== await fileSha256(sourcePath)) {
+                throw new Error(`Archive checksum mismatch: ${entry.fileName}`);
+            }
+            zip.readEntry();
+        }
+    }
+    finally {
+        zip.close();
+    }
+    if (actualFiles.join("\n") !== expectedFiles.join("\n")) {
+        throw new Error("Archive file list does not match input directory");
+    }
+}
+export async function createOfflinePackage(options) {
+    const inputDirectory = path.resolve(options.inputDirectory);
+    const archivePath = path.resolve(options.archivePath);
+    const requiredEntry = options.requiredEntry ?? "index.html";
+    const required = path.join(inputDirectory, requiredEntry);
+    if (!(await stat(required).catch(() => undefined))?.isFile()) {
+        throw new Error(`${requiredEntry} is missing from package input`);
+    }
+    const manifestPath = path.join(inputDirectory, "MANIFEST.sha256");
+    const manifest = await createChecksumManifest({
+        inputDirectory,
+        manifestPath,
+        pathBase: inputDirectory,
+        ignore: (file) => path.resolve(file) === manifestPath,
+    });
+    await writeFile(manifestPath, manifest, "utf8");
+    const files = (await walk(inputDirectory)).sort((left, right) => left.relative.localeCompare(right.relative, "en"));
+    await mkdir(path.dirname(archivePath), { recursive: true });
+    const temporaryArchive = `${archivePath}.tmp`;
+    await rm(temporaryArchive, { force: true });
+    const zip = new yazl.ZipFile();
+    for (const file of files) {
+        zip.addFile(file.absolute, file.relative, { mtime: options.fixedTimestamp, mode: 0o100644 });
+    }
+    zip.end();
+    const output = createWriteStream(temporaryArchive, { flags: "wx" });
+    zip.outputStream.pipe(output);
+    await once(output, "close");
+    await verifyArchive(temporaryArchive, inputDirectory, files.map((file) => file.relative));
+    await rm(archivePath, { force: true });
+    await rename(temporaryArchive, archivePath);
+    const sha256 = await fileSha256(archivePath);
+    const checksumPath = `${archivePath}.sha256`;
+    await writeFile(checksumPath, `${sha256}  ${path.basename(archivePath)}\n`, "utf8");
+    return {
+        archivePath,
+        checksumPath,
+        sha256,
+        size: (await stat(archivePath)).size,
+        files: files.map((file) => file.relative),
+    };
+}
+//# sourceMappingURL=offline-package.js.map

package/dist/offline-package.js.map

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

package/dist/vite/index.d.ts

@@ -0,0 +1,3 @@
+export { createMemorialLobbyVitePlugins } from "./plugins.js";
+export type { MemorialLobbyVitePluginOptions } from "./plugins.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC"}

package/dist/vite/index.js

@@ -0,0 +1,2 @@
+export { createMemorialLobbyVitePlugins } from "./plugins.js";
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC"}

package/dist/vite/plugins.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from "vite";
+export interface MemorialLobbyVitePluginOptions {
+    readonly loggingBootstrapPath: string;
+    readonly outputDirectory?: string;
+    readonly logRoute?: string;
+    readonly maximumLogBodyCharacters?: number;
+}
+export declare function createMemorialLobbyVitePlugins(options: MemorialLobbyVitePluginOptions): Plugin[];
+//# sourceMappingURL=plugins.d.ts.map

package/dist/vite/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/vite/plugins.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAC5C;AAID,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM,EAAE,CAwEhG"}

package/dist/vite/plugins.js

@@ -0,0 +1,78 @@
+import { appendFile, copyFile, mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+const SESSION_FILE_PATTERN = /^\d{4}-\d{2}-\d{2}_\d{2}-\d{2}-\d{2}-\d{3}_[a-z0-9]{6}\.log$/;
+export function createMemorialLobbyVitePlugins(options) {
+    const outputDirectory = path.resolve(options.outputDirectory ?? "dist");
+    const logDirectory = path.join(outputDirectory, "log");
+    const logRoute = options.logRoute ?? "/__memorial-lobby-log";
+    const maximumBody = options.maximumLogBodyCharacters ?? 1024 * 1024;
+    const runtimeAssets = {
+        name: "memorial-lobby-runtime-assets",
+        configureServer(server) {
+            server.middlewares.use(async (request, response, next) => {
+                const pathname = new URL(request.url ?? "/", "http://127.0.0.1").pathname;
+                if (pathname !== "/logging-bootstrap.js")
+                    return next();
+                response.setHeader("Content-Type", "text/javascript; charset=utf-8");
+                response.end(await readFile(options.loggingBootstrapPath));
+            });
+        },
+        async writeBundle() {
+            await mkdir(outputDirectory, { recursive: true });
+            await copyFile(options.loggingBootstrapPath, path.join(outputDirectory, "logging-bootstrap.js"));
+        },
+    };
+    const installLogMiddleware = (server) => {
+        server.middlewares.use((request, response, next) => {
+            const pathname = new URL(request.url ?? "/", "http://127.0.0.1").pathname;
+            if (request.method !== "POST" || pathname !== `${logRoute}/append`)
+                return next();
+            let body = "";
+            let rejected = false;
+            request.setEncoding("utf8");
+            request.on("data", (chunk) => {
+                if (rejected)
+                    return;
+                if (body.length + chunk.length > maximumBody) {
+                    rejected = true;
+                    response.statusCode = 413;
+                    response.end("Log payload too large");
+                    return;
+                }
+                body += chunk;
+            });
+            request.on("end", async () => {
+                if (rejected || response.writableEnded)
+                    return;
+                try {
+                    const payload = JSON.parse(body);
+                    if (typeof payload.sessionFile !== "string" ||
+                        !SESSION_FILE_PATTERN.test(payload.sessionFile) ||
+                        !Array.isArray(payload.lines) ||
+                        payload.lines.some((line) => typeof line !== "string")) {
+                        response.statusCode = 400;
+                        response.end("Invalid log payload");
+                        return;
+                    }
+                    await mkdir(logDirectory, { recursive: true });
+                    await appendFile(path.join(logDirectory, payload.sessionFile), `${payload.lines.join("\n")}\n`, "utf8");
+                    response.statusCode = 204;
+                    response.end();
+                }
+                catch (error) {
+                    if (response.writableEnded)
+                        return;
+                    response.statusCode = error instanceof SyntaxError ? 400 : 500;
+                    response.end(error instanceof SyntaxError ? "Invalid JSON payload" : error instanceof Error ? error.message : String(error));
+                }
+            });
+        });
+    };
+    return [runtimeAssets, {
+            name: "memorial-lobby-local-log-bridge",
+            configureServer: installLogMiddleware,
+            configurePreviewServer: installLogMiddleware,
+            async writeBundle() { await mkdir(logDirectory, { recursive: true }); },
+        }];
+}
+//# sourceMappingURL=plugins.js.map

package/dist/vite/plugins.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "ba-memorial-lobby-wallpaper-toolkit",
+  "version": "0.1.0",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "memorial-lobby-toolkit": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test --experimental-strip-types test/*.test.ts",
+    "check": "npm run build && npm run typecheck && node --test --experimental-strip-types test/*.test.ts",
+    "prepack": "npm run check"
+  },
+  "peerDependencies": {
+    "vite": ">=8.0.0 <9"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "@types/yauzl": "^3.4.0",
+    "@types/yazl": "^3.3.1",
+    "typescript": "7.0.2",
+    "vite": "8.2.1"
+  },
+  "dependencies": {
+    "yauzl": "^3.4.0",
+    "yazl": "^3.3.1"
+  }
+}