feat: add user job listing and summary helpers for dashboard flows

src/lib/engine.js

@@ -120,6 +120,29 @@ class XArtAudioEngine {
     return this.jobs.get(jobId) || null;
   }
 
+  listJobsForUser(userId) {
+    if (!userId) {
+      return [];
+    }
+
+    return Array.from(this.jobs.values())
+      .filter((job) => job.callerUserId === userId)
+      .sort((a, b) => Number(b.id) - Number(a.id));
+  }
+
+  getUserSummary(userId) {
+    const jobs = this.listJobsForUser(userId);
+    const completed = jobs.filter((job) => job.status === "completed").length;
+    const totalCreditsSpent = jobs.reduce((sum, job) => sum + job.creditsCharged, 0);
+
+    return {
+      balance: this.getWalletBalance(userId),
+      totalJobs: jobs.length,
+      completedJobs: completed,
+      totalCreditsSpent,
+    };
+  }
+
   getAsset(assetId) {
     return this.assets.get(String(assetId)) || null;
   }

test/engine.test.js

@@ -118,3 +118,39 @@ test("non-owner must pay same credits to unlock, then has permanent access", ()
   engine.unlockAudio(result.job.assetId, "u2");
   assert.equal(engine.getWalletBalance("u2"), 4);
 });
+
+test("lists jobs for user newest first and provides summary", () => {
+  const engine = createEngine();
+  engine.topUpCredits("u1", 10, "topup-5");
+
+  engine.processMention({
+    mentionPostId: "m5a",
+    callerUserId: "u1",
+    parentPost: {
+      id: "p5a",
+      authorId: "author-a",
+      article: { id: "a5a", title: "One", body: "x" },
+    },
+  });
+
+  engine.processMention({
+    mentionPostId: "m5b",
+    callerUserId: "u1",
+    parentPost: {
+      id: "p5b",
+      authorId: "author-b",
+      article: { id: "a5b", title: "Two", body: "y" },
+    },
+  });
+
+  const jobs = engine.listJobsForUser("u1");
+  assert.equal(jobs.length, 2);
+  assert.equal(jobs[0].mentionPostId, "m5b");
+  assert.equal(jobs[1].mentionPostId, "m5a");
+
+  const summary = engine.getUserSummary("u1");
+  assert.equal(summary.totalJobs, 2);
+  assert.equal(summary.completedJobs, 2);
+  assert.equal(summary.totalCreditsSpent, 2);
+  assert.equal(summary.balance, 8);
+});