@esaio/esa-mcp-server 0.2.0 → 0.2.2

package/src/transformers/__tests__/query-normalizer.test.ts

@@ -1,98 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { normalizeSearchQuery } from "../query-normalizer.js";
-
-describe("normalizeSearchQuery", () => {
-  describe("wildcard normalization", () => {
-    it("should convert * to empty string", () => {
-      expect(normalizeSearchQuery("*")).toBe("");
-    });
-
-    it("should not convert * when part of a larger query", () => {
-      expect(normalizeSearchQuery("user:* tag:release")).toBe(
-        "user:* tag:release",
-      );
-    });
-  });
-
-  describe("date syntax normalization", () => {
-    it("should convert after: to created:>", () => {
-      expect(normalizeSearchQuery("after:2025-08-16")).toBe(
-        "created:>2025-08-16",
-      );
-    });
-
-    it("should convert before: to created:<", () => {
-      expect(normalizeSearchQuery("before:2025-08-16")).toBe(
-        "created:<2025-08-16",
-      );
-    });
-
-    it("should convert since: to created:>", () => {
-      expect(normalizeSearchQuery("since:2025-08-16")).toBe(
-        "created:>2025-08-16",
-      );
-    });
-
-    it("should convert until: to created:<", () => {
-      expect(normalizeSearchQuery("until:2025-08-16")).toBe(
-        "created:<2025-08-16",
-      );
-    });
-
-    it("should handle case-insensitive matching", () => {
-      expect(normalizeSearchQuery("AFTER:2025-08-16")).toBe(
-        "created:>2025-08-16",
-      );
-      expect(normalizeSearchQuery("After:2025-08-16")).toBe(
-        "created:>2025-08-16",
-      );
-    });
-
-    it("should handle multiple date patterns in one query", () => {
-      expect(
-        normalizeSearchQuery(
-          "user:fukayatsu after:2025-08-16 before:2025-08-22",
-        ),
-      ).toBe("user:fukayatsu created:>2025-08-16 created:<2025-08-22");
-    });
-
-    it("should not convert partial matches", () => {
-      expect(normalizeSearchQuery("notafter:2025-08-16")).toBe(
-        "notafter:2025-08-16",
-      );
-      expect(normalizeSearchQuery("after:notadate")).toBe("after:notadate");
-    });
-
-    it("should handle complex queries with mixed syntax", () => {
-      expect(
-        normalizeSearchQuery(
-          "user:fukayatsu after:2025-08-01 tag:release wip:false",
-        ),
-      ).toBe("user:fukayatsu created:>2025-08-01 tag:release wip:false");
-    });
-  });
-
-  describe("no transformation needed", () => {
-    it("should not modify valid esa syntax", () => {
-      expect(normalizeSearchQuery("created:>2025-08-16")).toBe(
-        "created:>2025-08-16",
-      );
-      expect(normalizeSearchQuery("updated:<2025-08-16")).toBe(
-        "updated:<2025-08-16",
-      );
-    });
-
-    it("should preserve normal search queries", () => {
-      expect(normalizeSearchQuery("user:fukayatsu tag:release")).toBe(
-        "user:fukayatsu tag:release",
-      );
-      expect(normalizeSearchQuery("category:dev wip:false")).toBe(
-        "category:dev wip:false",
-      );
-    });
-
-    it("should handle empty string", () => {
-      expect(normalizeSearchQuery("")).toBe("");
-    });
-  });
-});

package/src/transformers/__tests__/team-name-normalizer.test.ts

@@ -1,21 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { normalizeTeamName } from "../team-name-normalizer.js";
-
-describe("normalizeTeamName", () => {
-  it("should extract team name from URL-like input", () => {
-    expect(normalizeTeamName("docs.example.com")).toBe("docs");
-    expect(normalizeTeamName("my-team.example.com")).toBe("my-team");
-    expect(normalizeTeamName("company.example.com")).toBe("company");
-  });
-
-  it("should leave normal team names unchanged", () => {
-    expect(normalizeTeamName("docs")).toBe("docs");
-    expect(normalizeTeamName("my-team")).toBe("my-team");
-  });
-
-  it("should handle edge cases", () => {
-    expect(normalizeTeamName("")).toBe("");
-    expect(normalizeTeamName(".")).toBe("");
-    expect(normalizeTeamName("team.")).toBe("team");
-  });
-});

package/src/transformers/category-transformer.ts

@@ -1,36 +0,0 @@
-import type { components } from "../generated/api-types.js";
-
-export function transformCategory(category: components["schemas"]["Category"]) {
-  return {
-    full_name: category.full_name,
-    count: category.count,
-    has_child: category.has_child || false,
-  };
-}
-
-export function transformCategoryList(
-  categoryList: components["schemas"]["CategoryList"],
-) {
-  return {
-    current_category: categoryList.current_category,
-    categories: categoryList.categories?.map(transformCategory) || [],
-    parent_categories: categoryList.parent_categories?.map(
-      (parentCategory) => ({
-        current_category: parentCategory.current_category,
-        categories: parentCategory.categories?.map(transformCategory) || [],
-      }),
-    ),
-    readme: categoryList.readme,
-    no_category: categoryList.no_category
-      ? transformCategory(categoryList.no_category)
-      : undefined,
-    descendant_posts: categoryList.descendant_posts,
-    posts: categoryList.posts,
-    total_count: categoryList.total_count,
-    per_page: categoryList.per_page,
-    page: categoryList.page,
-    prev_page: categoryList.prev_page,
-    next_page: categoryList.next_page,
-    max_per_page: categoryList.max_per_page,
-  };
-}

package/src/transformers/comment-transformer.ts

@@ -1,34 +0,0 @@
-import type { components } from "../generated/api-types.js";
-
-export interface CommentTransformOptions {
-  truncateBody?: number;
-}
-
-export function transformComment(
-  comment: components["schemas"]["Comment"],
-  options: CommentTransformOptions = {},
-) {
-  const { truncateBody } = options;
-
-  let bodyMd = comment.body_md;
-  if (truncateBody && bodyMd && bodyMd.length > truncateBody) {
-    bodyMd = `${bodyMd.slice(0, truncateBody)}...`;
-  }
-
-  return {
-    id: comment.id,
-    post_number: comment.post_number,
-    url: comment.url,
-    body_md: bodyMd,
-    created_at: comment.created_at,
-    updated_at: comment.updated_at,
-    created_by: comment.created_by,
-    stats: {
-      stargazers_count: comment.stargazers_count,
-      star: comment.star,
-    },
-    stargazers: comment.stargazers,
-  };
-}
-
-export type TransformedComment = ReturnType<typeof transformComment>;

package/src/transformers/post-name-normalizer.ts

@@ -1,30 +0,0 @@
-export interface PostNameParts {
-  name?: string;
-  category?: string;
-}
-
-export function normalizePostName(
-  name?: string,
-  category?: string,
-): PostNameParts {
-  if (!name) {
-    return { name, category };
-  }
-
-  if (category !== undefined) {
-    return { name, category };
-  }
-
-  if (name.includes("/")) {
-    const parts = name.split("/");
-    const extractedName = parts.pop();
-    const extractedCategory = parts.join("/");
-
-    return {
-      name: extractedName || undefined,
-      category: extractedCategory,
-    };
-  }
-
-  return { name, category };
-}

package/src/transformers/post-transformer.ts

@@ -1,38 +0,0 @@
-import type { components } from "../generated/api-types.js";
-
-export interface PostTransformOptions {
-  truncateBody?: number;
-}
-
-export function transformPost(
-  post: components["schemas"]["Post"],
-  options: PostTransformOptions = {},
-) {
-  const { truncateBody } = options;
-
-  let bodyMd = post.body_md;
-  if (truncateBody && bodyMd && bodyMd.length > truncateBody) {
-    bodyMd = `${bodyMd.slice(0, truncateBody)}...`;
-  }
-
-  return {
-    url: post.url,
-    wip: post.wip ? "WIP" : ("Shipped" as const),
-    kind: post.kind,
-    category_and_title_and_tags: post.full_name,
-    body_md: bodyMd,
-    created_at: post.created_at,
-    updated_at: post.updated_at,
-    created_by: post.created_by,
-    updated_by: post.updated_by,
-    stats: {
-      tasks_count: post.tasks_count,
-      done_tasks_count: post.done_tasks_count,
-      comments_count: post.comments_count,
-      stargazers_count: post.stargazers_count,
-      watchers_count: post.watchers_count,
-    },
-  };
-}
-
-export type TransformedPost = ReturnType<typeof transformPost>;

package/src/transformers/query-normalizer.ts

@@ -1,36 +0,0 @@
-export function normalizeSearchQuery(query: string): string {
-  let normalized = query;
-
-  // Convert wildcard "*" to empty string (for "all posts" queries)
-  if (normalized === "*") {
-    normalized = "";
-  }
-
-  // Convert common date syntax patterns from other services to esa format
-  // GitHub/Gmail style: after:YYYY-MM-DD -> created:>YYYY-MM-DD
-  normalized = normalized.replace(
-    /\bafter:(\d{4}-\d{2}-\d{2})\b/gi,
-    "created:>$1",
-  );
-
-  // GitHub/Gmail style: before:YYYY-MM-DD -> created:<YYYY-MM-DD
-  normalized = normalized.replace(
-    /\bbefore:(\d{4}-\d{2}-\d{2})\b/gi,
-    "created:<$1",
-  );
-
-  // Alternative patterns that might be used
-  // since:YYYY-MM-DD -> created:>YYYY-MM-DD
-  normalized = normalized.replace(
-    /\bsince:(\d{4}-\d{2}-\d{2})\b/gi,
-    "created:>$1",
-  );
-
-  // until:YYYY-MM-DD -> created:<YYYY-MM-DD
-  normalized = normalized.replace(
-    /\buntil:(\d{4}-\d{2}-\d{2})\b/gi,
-    "created:<$1",
-  );
-
-  return normalized;
-}

package/src/transformers/team-name-normalizer.ts

@@ -1,7 +0,0 @@
-export function normalizeTeamName(teamName: string): string {
-  const dotIndex = teamName.indexOf(".");
-  if (dotIndex >= 0) {
-    return teamName.substring(0, dotIndex);
-  }
-  return teamName;
-}

package/tsconfig.build.json

@@ -1,4 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "exclude": ["**/__tests__/**"]
-}

package/tsconfig.json

@@ -1,30 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "lib": ["ES2022"],
-    "moduleResolution": "nodenext",
-    "outDir": "./bin",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "removeComments": true,
-    "noImplicitAny": true,
-    "strictNullChecks": true,
-    "strictFunctionTypes": true,
-    "noImplicitThis": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "allowSyntheticDefaultImports": true,
-    "isolatedModules": true
-  },
-  "include": ["src/**/*"]
-}

package/tsdown.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "tsdown";
-
-export default defineConfig({
-  entry: "src/index.ts",
-  outDir: "bin",
-  format: "es",
-  platform: "node",
-  target: "node20",
-  clean: true,
-  dts: false,
-  tsconfig: "tsconfig.build.json",
-  minify: true,
-});

package/vitest.config.ts

@@ -1,24 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    globals: false,
-    environment: "node",
-    include: ["**/__tests__/**/*.{test,spec}.{js,ts,jsx,tsx}"],
-    coverage: {
-      provider: "v8",
-      reporter: ["text", "json", "html"],
-      exclude: [
-        "node_modules/",
-        "bin/",
-        "**/*.config.ts",
-        "**/*.config.js",
-        "**/context/**",
-        "**/generated/**",
-      ],
-    },
-  },
-  resolve: {
-    extensions: [".ts", ".js"],
-  },
-});