@femtomc/mu-forum 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @femtomc/mu-forum
+
+Forum/message store backed by a JSONL store, with helpers for posting, reading, and listing topics.
+
+## Install
+
+After publishing:
+
+```bash
+npm install @femtomc/mu-forum
+# or: bun add @femtomc/mu-forum
+```
+
+From this repo:
+
+```bash
+cd mu
+bun install
+bun run build
+```
+
+## Usage
+
+```ts
+import { InMemoryJsonlStore } from "@femtomc/mu-core";
+import { ForumStore } from "@femtomc/mu-forum";
+
+const forum = new ForumStore(new InMemoryJsonlStore());
+
+await forum.post("issue:demo", "hello", "worker");
+console.log(await forum.read("issue:demo"));
+console.log(await forum.topics("issue:"));
+```
+
+## Tests / Typecheck
+
+From the `mu/` repo root:
+
+```bash
+bun test packages/forum
+bun run typecheck
+```
+
+## Runtime
+
+- Runtime-agnostic: works in Node or the browser.
+- You provide a `JsonlStore` implementation (see `@femtomc/mu-core/node` for `FsJsonlStore`, or `@femtomc/mu-core/browser` for IndexedDB/localStorage stores).

package/dist/forum_store.d.ts

@@ -0,0 +1,18 @@
+import type { ForumMessage, JsonlStore } from "@femtomc/mu-core";
+import { EventLog } from "@femtomc/mu-core";
+export type ForumTopicSummary = {
+    topic: string;
+    messages: number;
+    last_at: number;
+};
+export declare class ForumStore {
+    #private;
+    readonly events: EventLog;
+    constructor(forum: JsonlStore<unknown>, opts?: {
+        events?: EventLog;
+    });
+    post(topic: string, body: string, author?: string): Promise<ForumMessage>;
+    read(topic: string, limit?: number): Promise<ForumMessage[]>;
+    topics(prefix?: string | null): Promise<ForumTopicSummary[]>;
+}
+//# sourceMappingURL=forum_store.d.ts.map

package/dist/forum_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forum_store.d.ts","sourceRoot":"","sources":["../src/forum_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAA4C,MAAM,kBAAkB,CAAC;AAEtF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBAAa,UAAU;;IACtB,SAAgB,MAAM,EAAE,QAAQ,CAAC;gBAGd,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAO;IAoBlE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA6BnF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAMhE,MAAM,CAAC,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAgC/E"}

package/dist/forum_store.js

@@ -0,0 +1,80 @@
+import { EventLog, ForumMessageSchema, NullEventSink, nowTs } from "@femtomc/mu-core";
+export class ForumStore {
+    events;
+    #forum;
+    constructor(forum, opts = {}) {
+        this.#forum = forum;
+        this.events = opts.events ?? new EventLog(new NullEventSink());
+    }
+    async #load() {
+        const rows = await this.#forum.read();
+        return rows.map((row, idx) => {
+            const parsed = ForumMessageSchema.safeParse(row);
+            if (!parsed.success) {
+                throw new Error(`invalid forum row ${idx}: ${parsed.error.message}`);
+            }
+            return parsed.data;
+        });
+    }
+    async #save(rows) {
+        await this.#forum.write(rows);
+    }
+    async post(topic, body, author = "system") {
+        let issueId;
+        if (topic.startsWith("issue:")) {
+            const candidate = topic.slice("issue:".length).trim();
+            if (candidate.length > 0) {
+                issueId = candidate;
+            }
+        }
+        const msg = ForumMessageSchema.parse({
+            topic,
+            body,
+            author,
+            created_at: nowTs(),
+        });
+        const rows = await this.#load();
+        rows.push(msg);
+        await this.#save(rows);
+        await this.events.emit("forum.post", {
+            source: "forum_store",
+            issueId,
+            payload: { message: msg },
+        });
+        return msg;
+    }
+    async read(topic, limit = 50) {
+        const rows = await this.#load();
+        const matching = rows.filter((row) => row.topic === topic);
+        return matching.slice(-limit);
+    }
+    async topics(prefix = null) {
+        const rows = await this.#load();
+        const byTopic = new Map();
+        for (const row of rows) {
+            const topic = row.topic;
+            if (prefix && !topic.startsWith(prefix)) {
+                continue;
+            }
+            const entry = byTopic.get(topic) ?? { topic, messages: 0, last_at: 0 };
+            entry.messages += 1;
+            entry.last_at = Math.max(entry.last_at, Math.trunc(row.created_at ?? 0));
+            byTopic.set(topic, entry);
+        }
+        // Match Python's `sorted(..., key=(last_at, topic), reverse=True)`.
+        const out = [...byTopic.values()];
+        out.sort((a, b) => {
+            if (a.last_at !== b.last_at) {
+                return b.last_at - a.last_at;
+            }
+            if (a.topic < b.topic) {
+                return 1;
+            }
+            if (a.topic > b.topic) {
+                return -1;
+            }
+            return 0;
+        });
+        return out;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { ForumTopicSummary } from "./forum_store.js";
+export { ForumStore } from "./forum_store.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,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { ForumStore } from "./forum_store.js";

package/package.json

@@ -0,0 +1,17 @@
+{
+	"name": "@femtomc/mu-forum",
+	"version": "0.1.0",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": ["dist/**"],
+	"dependencies": {
+		"@femtomc/mu-core": "0.1.0"
+	}
+}