@nexttylabs/echo 0.2.0

package/tests/api/feedback-list.test.ts

@@ -0,0 +1,234 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { describe, expect, it, mock, beforeEach } from "bun:test";
+import { NextRequest } from "next/server";
+
+const mockFeedbackData = [
+  {
+    feedbackId: 1,
+    title: "Test Feedback 1",
+    description: "Description 1",
+    type: "bug",
+    priority: "high",
+    status: "new",
+    organizationId: "org_1",
+    createdAt: new Date("2024-01-01"),
+    updatedAt: new Date("2024-01-01"),
+  },
+  {
+    feedbackId: 2,
+    title: "Test Feedback 2",
+    description: "Description 2",
+    type: "feature",
+    priority: "medium",
+    status: "in-progress",
+    organizationId: "org_1",
+    createdAt: new Date("2024-01-02"),
+    updatedAt: new Date("2024-01-02"),
+  },
+];
+
+const createMockDb = (data = mockFeedbackData, total = data.length) => ({
+  select: mock(() => ({
+    from: mock(() => ({
+      where: mock(() => {
+        const result = [{ value: total }];
+        const adminRows = [{ role: "admin" }];
+        return {
+          orderBy: mock(() => ({
+            limit: mock(() => ({
+              offset: mock(() => Promise.resolve(data)),
+            })),
+          })),
+          limit: mock(() => ({
+            then: (resolve: (value: typeof adminRows) => void) =>
+              Promise.resolve(adminRows).then(resolve),
+          })),
+          then: (resolve: (value: typeof result) => void) =>
+            Promise.resolve(result).then(resolve),
+          [Symbol.iterator]: () => result[Symbol.iterator](),
+        };
+      }),
+    })),
+  })),
+});
+
+function setupMocks() {
+  mock.module("@/lib/auth/config", () => ({
+    auth: {
+      api: {
+        getSession: mock(() => Promise.resolve({ user: { id: "user_1" } })),
+      },
+      options: {
+        session: {
+          expiresIn: 60 * 60 * 24 * 30,
+        },
+      },
+    },
+  }));
+
+  mock.module("next/headers", () => ({
+    headers: () => Promise.resolve(new Headers()),
+    cookies: () => Promise.resolve({ get: () => undefined }),
+  }));
+}
+
+// Mock getOrgContext to throw when organizationId is missing
+function setupOrgContextMock() {
+  mock.module("@/lib/auth/org-context", () => ({
+    getOrgContext: mock(async ({ request }: { request: { nextUrl: { searchParams: { get: (key: string) => string | null } } } }) => {
+      const organizationId = request.nextUrl.searchParams.get("organizationId");
+      if (!organizationId) {
+        throw new Error("Missing organization");
+      }
+      return {
+        organizationId,
+        memberRole: "admin",
+        source: "query" as const,
+      };
+    }),
+  }));
+}
+
+describe("GET /api/feedback", () => {
+  beforeEach(() => {
+    mock.restore();
+    setupMocks();
+    setupOrgContextMock();
+  });
+
+  it("returns paginated feedback list with organization isolation", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?organizationId=org_1&page=1&pageSize=20",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(data).toHaveProperty("data");
+    expect(data).toHaveProperty("total");
+    expect(data).toHaveProperty("page");
+    expect(data).toHaveProperty("pageSize");
+    expect(data).toHaveProperty("totalPages");
+  });
+
+  it("returns 400 when organizationId is missing", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?page=1&pageSize=20",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(400);
+    expect(data.code).toBe("MISSING_ORG_ID");
+  });
+
+  it("returns 400 for invalid pagination parameters", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?organizationId=org_1&page=0&pageSize=20",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(400);
+    expect(data.code).toBe("INVALID_PAGINATION");
+  });
+
+  it("returns 400 when pageSize exceeds limit", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?organizationId=org_1&page=1&pageSize=200",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(400);
+    expect(data.code).toBe("INVALID_PAGINATION");
+  });
+
+  it("supports sorting parameters", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?organizationId=org_1&sortBy=createdAt&sortOrder=asc",
+    );
+
+    const response = await GET(req);
+
+    expect(response.status).toBe(200);
+  });
+
+  it("returns 500 when database is not configured", async () => {
+    mock.module("@/lib/db", () => ({
+      db: null,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?organizationId=org_1",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(500);
+    expect(data.code).toBe("DATABASE_NOT_CONFIGURED");
+  });
+});

package/tests/api/feedback-route-assignee-condition.test.ts

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { describe, expect, it } from "bun:test";
+
+describe("Feedback route assignee condition", () => {
+  it("returns null when no assignee filters are provided", async () => {
+    const mod = await import("@/app/api/feedback/route");
+    expect(typeof mod.buildAssigneeCondition).toBe("function");
+    expect(mod.buildAssigneeCondition([])).toBe(null);
+  });
+
+  it("returns a SQL condition when filters exist", async () => {
+    const mod = await import("@/app/api/feedback/route");
+    const condition = mod.buildAssigneeCondition(["unassigned", "user-1"]);
+    expect(condition).toBeTruthy();
+  });
+});

package/tests/api/feedback-similar.test.ts

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { describe, expect, it } from "bun:test";
+import { buildSimilarResponse } from "@/lib/feedback/find-similar";
+
+const sample = [
+  {
+    feedbackId: 1,
+    title: "批量导入联系人功能请求",
+    description: "需要支持 CSV 格式导入联系人列表",
+  },
+];
+
+describe("buildSimilarResponse", () => {
+  it("returns scored suggestions", () => {
+    const result = buildSimilarResponse("批量导入联系人", "CSV 格式导入", sample);
+    expect(result.length).toBeGreaterThan(0);
+    expect(result[0]).toHaveProperty("feedbackId", 1);
+    expect(result[0]).toHaveProperty("similarity");
+  });
+
+  it("returns empty array when no matches", () => {
+    const result = buildSimilarResponse("completely unrelated", "", sample);
+    expect(result.length).toBe(0);
+  });
+
+  it("handles empty existing feedbacks", () => {
+    const result = buildSimilarResponse("test", "test", []);
+    expect(result).toEqual([]);
+  });
+});

package/tests/api/feedback-sort.test.ts

@@ -0,0 +1,261 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { describe, expect, it, mock, beforeEach } from "bun:test";
+import { NextRequest } from "next/server";
+
+const mockFeedbackData = [
+  {
+    feedbackId: 1,
+    title: "Bug Report",
+    description: "Description 1",
+    type: "bug",
+    priority: "high",
+    status: "new",
+    organizationId: "org_1",
+    createdAt: new Date("2024-01-01"),
+    updatedAt: new Date("2024-01-01"),
+    voteCount: 10,
+  },
+  {
+    feedbackId: 2,
+    title: "Feature Request",
+    description: "Description 2",
+    type: "feature",
+    priority: "medium",
+    status: "in-progress",
+    organizationId: "org_1",
+    createdAt: new Date("2024-01-02"),
+    updatedAt: new Date("2024-01-02"),
+    voteCount: 5,
+  },
+  {
+    feedbackId: 3,
+    title: "Another Bug",
+    description: "Description 3",
+    type: "bug",
+    priority: "low",
+    status: "new",
+    organizationId: "org_1",
+    createdAt: new Date("2024-01-03"),
+    updatedAt: new Date("2024-01-03"),
+    voteCount: 15,
+  },
+];
+
+const createMockDb = (data = mockFeedbackData, total = data.length) => ({
+  select: mock(() => ({
+    from: mock(() => ({
+      where: mock(() => {
+        const result = [{ value: total }];
+        const adminRows = [{ role: "admin" }];
+        return {
+          orderBy: mock(() => ({
+            limit: mock(() => ({
+              offset: mock(() => Promise.resolve(data)),
+            })),
+          })),
+          limit: mock(() => ({
+            then: (resolve: (value: typeof adminRows) => void) =>
+              Promise.resolve(adminRows).then(resolve),
+          })),
+          then: (resolve: (value: typeof result) => void) =>
+            Promise.resolve(result).then(resolve),
+          [Symbol.iterator]: () => result[Symbol.iterator](),
+        };
+      }),
+    })),
+  })),
+});
+
+mock.module("@/lib/auth/config", () => ({
+  auth: {
+    api: {
+      getSession: mock(() => Promise.resolve({ user: { id: "user_1" } })),
+    },
+    options: {
+      session: {
+        expiresIn: 60 * 60 * 24 * 30,
+      },
+    },
+  },
+}));
+
+
+
+mock.module("next/headers", () => ({
+  headers: () => Promise.resolve(new Headers()),
+  cookies: () => Promise.resolve({ get: () => undefined }),
+}));
+
+describe("GET /api/feedback - Sorting", () => {
+  beforeEach(() => {
+    mock.restore();
+  });
+
+  it("should accept sortBy=voteCount parameter", async () => {
+    const sortedData = [...mockFeedbackData].sort(
+      (a, b) => b.voteCount - a.voteCount,
+    );
+    const mockDb = createMockDb(sortedData);
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?sortBy=voteCount&sortOrder=desc&organizationId=org_1",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(data.data.length).toBe(sortedData.length);
+  });
+
+  it("should accept sortBy=voteCount ascending", async () => {
+    const sortedData = [...mockFeedbackData].sort(
+      (a, b) => a.voteCount - b.voteCount,
+    );
+    const mockDb = createMockDb(sortedData);
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?sortBy=voteCount&sortOrder=asc&organizationId=org_1",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(data.data.length).toBe(sortedData.length);
+  });
+
+  it("should accept sortBy=priority parameter", async () => {
+    const priorityWeight = { high: 3, medium: 2, low: 1 } as const;
+    const sortedData = [...mockFeedbackData].sort(
+      (a, b) =>
+        priorityWeight[b.priority as keyof typeof priorityWeight] -
+        priorityWeight[a.priority as keyof typeof priorityWeight],
+    );
+    const mockDb = createMockDb(sortedData);
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?sortBy=priority&sortOrder=desc&organizationId=org_1",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(data.data.length).toBe(sortedData.length);
+  });
+
+  it("should accept sortBy=createdAt as default", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?organizationId=org_1",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(data.data.length).toBe(mockFeedbackData.length);
+  });
+
+  it("should combine sorting with filtering", async () => {
+    const filteredData = mockFeedbackData.filter((f) => f.status === "new");
+    const sortedData = [...filteredData].sort(
+      (a, b) => b.voteCount - a.voteCount,
+    );
+    const mockDb = createMockDb(sortedData, sortedData.length);
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?status=new&sortBy=voteCount&sortOrder=desc&organizationId=org_1",
+    );
+
+    const response = await GET(req);
+    const data = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(data.data.length).toBe(sortedData.length);
+  });
+
+  it("should accept sortBy=updatedAt parameter", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?sortBy=updatedAt&sortOrder=desc&organizationId=org_1",
+    );
+
+    const response = await GET(req);
+
+    expect(response.status).toBe(200);
+  });
+
+  it("should accept sortBy=title parameter", async () => {
+    const mockDb = createMockDb();
+
+    mock.module("@/lib/db", () => ({
+      db: mockDb,
+    }));
+
+    const { GET } = await import("@/app/api/feedback/route");
+
+    const req = new NextRequest(
+      "http://localhost:3000/api/feedback?sortBy=title&sortOrder=asc&organizationId=org_1",
+    );
+
+    const response = await GET(req);
+
+    expect(response.status).toBe(200);
+  });
+});

package/tests/api/feedback-status-enum.test.ts

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { describe, expect, it } from "bun:test";
+import { FeedbackStatusEnum } from "@/lib/validations/feedback";
+import { GET } from "@/app/api/v1/spec/route";
+
+const expectedStatuses = [
+  "new",
+  "in-progress",
+  "planned",
+  "completed",
+  "closed",
+];
+
+describe("Feedback status enum", () => {
+  it("uses canonical status values in validation", () => {
+    expect(FeedbackStatusEnum.options).toEqual(expectedStatuses);
+  });
+
+  it("uses canonical status values in OpenAPI spec", async () => {
+    const response = await GET();
+    const spec = await response.json();
+
+    const feedbackStatusEnum =
+      spec.components.schemas.Feedback.properties.status.enum;
+    expect(feedbackStatusEnum).toEqual(expectedStatuses);
+
+    const updateStatusEnum =
+      spec.paths["/api/v1/feedback/{id}"].put.requestBody.content[
+        "application/json"
+      ].schema.properties.status.enum;
+    expect(updateStatusEnum).toEqual(expectedStatuses);
+  });
+});