Suno-style web UI for a self-hosted MiniMax-Music3 inference server
TypeScript ai-musicdiffusersdockerexpressminimaxminimax-musicmusic-generationreactself-hostedsgl-omnisunotailwindcsstext-to-musictypescriptvite
import fs from 'node:fs/promises';
import path from 'node:path';
import type { Track } from './types.js';
/** Generic append-at-front JSON array store with atomic writes. */
export class JsonStore<T extends { id: string }> {
private tracks: T[] = [];
private writing: Promise<void> = Promise.resolve();
constructor(private readonly file: string) {}
async load(): Promise<void> {
try {
const raw = await fs.readFile(this.file, 'utf8');
const parsed = JSON.parse(raw);
this.tracks = Array.isArray(parsed) ? parsed : [];
} catch (err) {
if ((err as NodeJS.ErrnoException).code === 'ENOENT') {
this.tracks = [];
return;
}
throw err;
}
}
all(): T[] {
return this.tracks;
}
get(id: string): T | undefined {
return this.tracks.find((t) => t.id === id);
}
async add(track: T): Promise<T> {
this.tracks.unshift(track);
await this.persist();
return track;
}
async update(id: string, patch: Partial<T>): Promise<T | undefined> {
const idx = this.tracks.findIndex((t) => t.id === id);
if (idx === -1) return undefined;
const current = this.tracks[idx];
this.tracks[idx] = { ...current, ...patch };
if (this.shouldPersistUpdate(current, patch)) await this.persist();
return this.tracks[idx];
}
async remove(id: string): Promise<T | undefined> {
const idx = this.tracks.findIndex((t) => t.id === id);
if (idx === -1) return undefined;
const [removed] = this.tracks.splice(idx, 1);
await this.persist();
return removed;
}
protected shouldPersistUpdate(_current: T, _patch: Partial<T>): boolean {
return true;
}
private persist(): Promise<void> {
const snapshot = JSON.stringify(this.tracks, null, 2);
const write = this.writing.then(async () => {
await fs.mkdir(path.dirname(this.file), { recursive: true });
const tmp = `${this.file}.${process.pid}.tmp`;
await fs.writeFile(tmp, snapshot, 'utf8');
await fs.rename(tmp, this.file);
});
this.writing = write.catch((err) => {
console.error(`failed to persist ${this.file}:`, err);
});
return this.writing;
}
}
export class Library extends JsonStore<Track> {
/** Render state is volatile; lifecycle transitions are the durable snapshots. */
protected override shouldPersistUpdate(current: Track, patch: Partial<Track>): boolean {
return patch.status !== undefined && patch.status !== current.status;
}
}