@hearthlog/runtime 0.2.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hearthlog/runtime",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Hearthlog's offline runtime: the local database, events and projections, commands, the outbox and sync, the Ledger client, history, and page lifecycle",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -35,8 +35,8 @@
     "date-fns": "^4.4.0",
     "sqlocal": "^0.18.0",
     "idb": "^8.0.3",
-    "@hearthlog/contracts": "0.2.0",
-    "@hearthlog/ui": "0.2.0"
+    "@hearthlog/ui": "0.3.1",
+    "@hearthlog/contracts": "0.3.1"
   },
   "peerDependencies": {
     "svelte": "^5.57.1",

package/src/commands/index.ts

@@ -25,7 +25,8 @@ export interface LocalCommandResult {
     projectionPending: boolean;
 }
 
-type CommitListener = (result: LocalCommandResult) => void | Promise<void>;
+/** Runs after a new batch commits on this device, with the events it appended (never for a duplicate submission). */
+type CommitListener = (result: LocalCommandResult, events: readonly ExtendedAppEvent[]) => void | Promise<void>;
 
 const commitListeners = new Set<CommitListener>();
 const inFlightCommands = new Map<string, { content: string; execution: Promise<LocalCommandResult> }>();
@@ -113,7 +114,7 @@ async function execute(
         projectionPending,
     };
 
-    if (!committed.duplicate) await notifyCommitted(result);
+    if (!committed.duplicate) await notifyCommitted(result, events);
     return result;
 }
 
@@ -173,10 +174,10 @@ export async function retryPendingCommandProjections(): Promise<number> {
     return completed;
 }
 
-async function notifyCommitted(result: LocalCommandResult): Promise<void> {
+async function notifyCommitted(result: LocalCommandResult, events: readonly ExtendedAppEvent[]): Promise<void> {
     for (const listener of commitListeners) {
         try {
-            await listener(result);
+            await listener(result, events);
         } catch (error) {
             console.error('[Command] Post-commit listener failed', error);
         }

package/src/commands/undo.ts

@@ -0,0 +1,32 @@
+import { ENTITY_DEFINITIONS, getEventPrefix } from '@hearthlog/contracts/event/entity-definitions';
+import type { ExtendedAppEvent } from '../event/types.js';
+
+/** A record whose removal reverses its addition. */
+export interface UndoTarget {
+    type: string;
+    id: string;
+}
+
+/** Standard entities: each adds, updates and removes through `<PREFIX>ADDED|UPDATED|REMOVED`. */
+const STANDARD_PREFIXES = new Set(ENTITY_DEFINITIONS.map(getEventPrefix));
+
+/**
+ * Undo appends the opposite of an action; history is never edited and no event is tombstoned. Only an action that
+ * just added standard records has an exact opposite, their removal, so anything else (an edit, a removal, a
+ * module's own event) returns null and offers no undo.
+ */
+export function undoTargets(events: readonly ExtendedAppEvent[]): UndoTarget[] | null {
+    const targets: UndoTarget[] = [];
+    for (const event of events) {
+        const prefix = event.type.endsWith('_ADDED') ? event.type.slice(0, -'ADDED'.length) : null;
+        const id = (event.payload as { id?: unknown } | null)?.id;
+        if (!prefix || !STANDARD_PREFIXES.has(prefix) || typeof id !== 'string' || id === '') return null;
+        targets.push({ type: `${prefix}REMOVED`, id });
+    }
+    return targets.length > 0 ? targets : null;
+}
+
+/** The removal events for an undo, stamped when it runs. */
+export function undoEvents(targets: readonly UndoTarget[], now = Date.now()): ExtendedAppEvent[] {
+    return targets.map(({ type, id }) => ({ id: crypto.randomUUID(), type, timestamp: now, payload: { id } }) as ExtendedAppEvent);
+}

package/src/store/attention.svelte.ts

@@ -1,15 +1,17 @@
 import { format } from 'date-fns';
-import type { AttentionBadge, AttentionContribution } from '@hearthlog/contracts';
+import type { AttentionBadge, AttentionContribution, NavFigure } from '@hearthlog/contracts';
 import { appClock } from '../runtime/view.js';
 
 /**
- * Navigation badges: counts of work that is late, supplied by the enabled
- * modules (`AttentionContribution.badges`). Counts come from SQL against the
- * active log and refresh whenever events change; a failed read keeps the
- * previous badges because they are advisory.
+ * Navigation badges and figures: counts of work that is late
+ * (`AttentionContribution.badges`) and one live figure per place
+ * (`AttentionContribution.figures`), supplied by the enabled modules. Both come
+ * from SQL against the active log and refresh whenever events change; a failed
+ * read keeps the previous values because they are advisory.
  */
 class AttentionStore {
     badges = $state<AttentionBadge[]>([]);
+    figures = $state<NavFigure[]>([]);
     #sources: readonly AttentionContribution[] = [];
     #run = 0;
 
@@ -27,12 +29,25 @@ class AttentionStore {
     async refresh(): Promise<void> {
         const run = ++this.#run;
         const today = format(appClock.now(), 'yyyy-MM-dd');
-        try {
-            const next = (await Promise.all(this.#sources.map((source) => source.badges?.({ today }) ?? []))).flat();
-            if (run === this.#run) this.badges = next;
-        } catch {
-            // Keep the last known badges; the page itself still shows the details.
-        }
+        // Read apart, so a failing figure never hides late work and the reverse.
+        await Promise.all([
+            (async () => {
+                try {
+                    const next = (await Promise.all(this.#sources.map((source) => source.badges?.({ today }) ?? []))).flat();
+                    if (run === this.#run) this.badges = next;
+                } catch {
+                    // Keep the last known badges; the page itself still shows the details.
+                }
+            })(),
+            (async () => {
+                try {
+                    const next = (await Promise.all(this.#sources.map((source) => source.figures?.({ today }) ?? []))).flat();
+                    if (run === this.#run) this.figures = next;
+                } catch {
+                    // Keep the last known figures.
+                }
+            })(),
+        ]);
     }
 
     /** Badge for a navigation destination or sub-page id, or null when nothing is waiting. */
@@ -40,6 +55,11 @@ class AttentionStore {
         return this.badges.find((badge) => badge.count > 0 && badge.ids.includes(id)) ?? null;
     }
 
+    /** Live figure for a navigation destination or sub-page id, or null when the module shows none. */
+    figure(id: string): NavFigure | null {
+        return this.figures.find((figure) => figure.id === id) ?? null;
+    }
+
     /** Total of all badges: the native app icon's badge. */
     get total(): number {
         return this.badges.reduce((sum, badge) => sum + badge.count, 0);