@aigne/doc-smith 0.8.12-beta.7 → 0.8.12-beta.9

package/tests/agents/utils/save-docs.test.mjs

@@ -1,109 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdir, readdir, rm, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import saveDocs from "../../../agents/utils/save-docs.mjs";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-describe("save-docs", () => {
-  let testDir;
-
-  beforeEach(async () => {
-    // Set test environment variable to prevent actual config file modification
-    process.env.NODE_ENV = "test";
-
-    // Create a temporary test directory
-    testDir = join(__dirname, "test-docs");
-    await mkdir(testDir, { recursive: true });
-
-    // Create some test files
-    const testFiles = [
-      "overview.md",
-      "getting-started.md",
-      "getting-started.zh.md",
-      "getting-started.en.md",
-      "old-file.md", // This should be deleted
-      "another-old-file.md", // This should be deleted
-      "old-translation.zh.md", // This should be deleted
-      "_sidebar.md", // This should be preserved
-    ];
-
-    for (const file of testFiles) {
-      await writeFile(join(testDir, file), `# Test content for ${file}`);
-    }
-  });
-
-  afterEach(async () => {
-    // Clean up environment variable
-    delete process.env.NODE_ENV;
-
-    // Clean up test directory
-    try {
-      await rm(testDir, { recursive: true, force: true });
-    } catch {
-      // Ignore cleanup errors since they don't affect test results
-    }
-  });
-
-  test("should clean up invalid files and maintain valid ones", async () => {
-    const initialFiles = await readdir(testDir);
-    expect(initialFiles).toContain("overview.md");
-    expect(initialFiles).toContain("getting-started.md");
-    expect(initialFiles).toContain("old-file.md");
-
-    // Test documentation structure
-    const documentStructure = [
-      {
-        path: "/overview",
-        title: "Overview",
-        description: "Overview page",
-      },
-      {
-        path: "/getting-started",
-        title: "Getting Started",
-        description: "Getting started guide",
-      },
-    ];
-
-    // Test with translation languages
-    const translateLanguages = ["zh", "en"];
-
-    const result = await saveDocs({
-      documentExecutionStructure: documentStructure,
-      docsDir: testDir,
-      translateLanguages,
-    });
-
-    expect(result).toBeDefined();
-
-    const remainingFiles = await readdir(testDir);
-
-    // Expected files after cleanup:
-    // - overview.md (existing)
-    // - getting-started.md (existing)
-    // - getting-started.zh.md (existing)
-    // - _sidebar.md (generated)
-    // Note: getting-started.en.md may be cleaned up if not needed
-    // Note: overview.zh.md and overview.en.md are not created by saveDocs,
-    // they would be created by saveDocWithTranslations when content is generated
-    const expectedFiles = [
-      "overview.md",
-      "getting-started.md",
-      "getting-started.zh.md",
-      "_sidebar.md",
-    ];
-
-    const missingFiles = expectedFiles.filter((file) => !remainingFiles.includes(file));
-    const extraFiles = remainingFiles.filter((file) => !expectedFiles.includes(file));
-
-    expect(missingFiles).toHaveLength(0);
-    expect(extraFiles).toHaveLength(0);
-
-    // Verify that invalid files were deleted
-    const deletedFiles = ["old-file.md", "another-old-file.md", "old-translation.zh.md"];
-    const stillExist = deletedFiles.filter((file) => remainingFiles.includes(file));
-
-    expect(stillExist).toHaveLength(0);
-  });
-});

package/tests/agents/utils/save-output.test.mjs

@@ -1,315 +0,0 @@
-import { afterEach, beforeEach, describe, expect, spyOn, test } from "bun:test";
-import fs from "node:fs";
-import * as path from "node:path";
-import saveOutput from "../../../agents/utils/save-output.mjs";
-
-describe("saveOutput utility", () => {
-  let mkdirSpy;
-  let writeFileSpy;
-  let joinSpy;
-  let consoleWarnSpy;
-
-  beforeEach(() => {
-    // Spy on fs.promises methods
-    mkdirSpy = spyOn(fs.promises, "mkdir").mockResolvedValue();
-    writeFileSpy = spyOn(fs.promises, "writeFile").mockResolvedValue();
-
-    // Spy on path methods
-    joinSpy = spyOn(path, "join").mockImplementation((...paths) => paths.join("/"));
-
-    // Spy on console.warn
-    consoleWarnSpy = spyOn(console, "warn").mockImplementation(() => {});
-  });
-
-  afterEach(() => {
-    // Restore all spies
-    mkdirSpy?.mockRestore();
-    writeFileSpy?.mockRestore();
-    joinSpy?.mockRestore();
-    consoleWarnSpy?.mockRestore();
-  });
-
-  // SUCCESSFUL SAVE TESTS
-  test("should save string content successfully", async () => {
-    const result = await saveOutput({
-      savePath: "/output/dir",
-      fileName: "result.txt",
-      saveKey: "textContent",
-      textContent: "Hello, World!",
-    });
-
-    expect(mkdirSpy).toHaveBeenCalledWith("/output/dir", { recursive: true });
-    expect(joinSpy).toHaveBeenCalledWith("/output/dir", "result.txt");
-    expect(writeFileSpy).toHaveBeenCalledWith("/output/dir/result.txt", "Hello, World!", "utf8");
-    expect(result).toEqual({
-      saveOutputStatus: true,
-      saveOutputPath: "/output/dir/result.txt",
-    });
-  });
-
-  test("should save object content as formatted JSON", async () => {
-    const objectData = {
-      title: "Test Document",
-      tags: ["test", "sample"],
-      metadata: { version: 1 },
-    };
-
-    const result = await saveOutput({
-      savePath: "/data",
-      fileName: "config.json",
-      saveKey: "configData",
-      configData: objectData,
-    });
-
-    const expectedContent = JSON.stringify(objectData, null, 2);
-    expect(writeFileSpy).toHaveBeenCalledWith("/data/config.json", expectedContent, "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-    expect(result.saveOutputPath).toBe("/data/config.json");
-  });
-
-  test("should save number content as string", async () => {
-    const result = await saveOutput({
-      savePath: "/numbers",
-      fileName: "count.txt",
-      saveKey: "count",
-      count: 42,
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/numbers/count.txt", "42", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  test("should save boolean content as string", async () => {
-    const result = await saveOutput({
-      savePath: "/flags",
-      fileName: "flag.txt",
-      saveKey: "isEnabled",
-      isEnabled: true,
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/flags/flag.txt", "true", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  test("should save array content as formatted JSON", async () => {
-    const arrayData = ["item1", "item2", { nested: "object" }];
-
-    const result = await saveOutput({
-      savePath: "/arrays",
-      fileName: "list.json",
-      saveKey: "items",
-      items: arrayData,
-    });
-
-    const expectedContent = JSON.stringify(arrayData, null, 2);
-    expect(writeFileSpy).toHaveBeenCalledWith("/arrays/list.json", expectedContent, "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  // NULL AND UNDEFINED HANDLING
-  test("should handle null values by converting to JSON string", async () => {
-    const result = await saveOutput({
-      savePath: "/null-test",
-      fileName: "null.json",
-      saveKey: "nullValue",
-      nullValue: null,
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/null-test/null.json", "null", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  test("should handle undefined values by converting to string", async () => {
-    const result = await saveOutput({
-      savePath: "/undefined-test",
-      fileName: "undefined.txt",
-      saveKey: "undefinedValue",
-      undefinedValue: undefined,
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/undefined-test/undefined.txt", "undefined", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  // MISSING SAVE KEY TESTS
-  test("should warn and return false when saveKey is not found", async () => {
-    const result = await saveOutput({
-      savePath: "/output",
-      fileName: "missing.txt",
-      saveKey: "nonExistentKey",
-      existingKey: "some value",
-    });
-
-    expect(consoleWarnSpy).toHaveBeenCalledWith(
-      'saveKey "nonExistentKey" not found in input, skip saving.',
-    );
-    expect(result).toEqual({
-      saveOutputStatus: false,
-      saveOutputPath: null,
-    });
-    expect(mkdirSpy).not.toHaveBeenCalled();
-    expect(writeFileSpy).not.toHaveBeenCalled();
-  });
-
-  test("should not save when saveKey exists but is undefined", async () => {
-    const result = await saveOutput({
-      savePath: "/output",
-      fileName: "test.txt",
-      saveKey: "undefinedKey",
-      // undefinedKey is not provided, so it will be undefined
-    });
-
-    expect(consoleWarnSpy).toHaveBeenCalledWith(
-      'saveKey "undefinedKey" not found in input, skip saving.',
-    );
-    expect(result.saveOutputStatus).toBe(false);
-  });
-
-  // COMPLEX PATH HANDLING
-  test("should handle nested directory paths", async () => {
-    await saveOutput({
-      savePath: "/deep/nested/directory/structure",
-      fileName: "file.txt",
-      saveKey: "content",
-      content: "test content",
-    });
-
-    expect(mkdirSpy).toHaveBeenCalledWith("/deep/nested/directory/structure", {
-      recursive: true,
-    });
-    expect(joinSpy).toHaveBeenCalledWith("/deep/nested/directory/structure", "file.txt");
-  });
-
-  test("should handle paths with special characters", async () => {
-    await saveOutput({
-      savePath: "/path with spaces/特殊字符/symbols!@#",
-      fileName: "file-name_with-symbols.json",
-      saveKey: "data",
-      data: { test: "value" },
-    });
-
-    expect(mkdirSpy).toHaveBeenCalledWith("/path with spaces/特殊字符/symbols!@#", {
-      recursive: true,
-    });
-    expect(joinSpy).toHaveBeenCalledWith(
-      "/path with spaces/特殊字符/symbols!@#",
-      "file-name_with-symbols.json",
-    );
-  });
-
-  // EMPTY AND EDGE CASES
-  test("should save empty string content", async () => {
-    const result = await saveOutput({
-      savePath: "/empty",
-      fileName: "empty.txt",
-      saveKey: "emptyString",
-      emptyString: "",
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/empty/empty.txt", "", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  test("should save empty object as formatted JSON", async () => {
-    const result = await saveOutput({
-      savePath: "/empty",
-      fileName: "empty.json",
-      saveKey: "emptyObject",
-      emptyObject: {},
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/empty/empty.json", "{}", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  test("should save empty array as formatted JSON", async () => {
-    const result = await saveOutput({
-      savePath: "/empty",
-      fileName: "empty-array.json",
-      saveKey: "emptyArray",
-      emptyArray: [],
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/empty/empty-array.json", "[]", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  // COMPLEX OBJECT SERIALIZATION
-  test("should handle complex nested objects", async () => {
-    const complexObject = {
-      users: [
-        { id: 1, name: "Alice", settings: { theme: "dark", notifications: true } },
-        { id: 2, name: "Bob", settings: { theme: "light", notifications: false } },
-      ],
-      metadata: {
-        version: "1.0.0",
-        created: "2024-01-01",
-        features: ["auth", "api", "ui"],
-      },
-    };
-
-    const result = await saveOutput({
-      savePath: "/complex",
-      fileName: "data.json",
-      saveKey: "complexData",
-      complexData: complexObject,
-    });
-
-    const expectedContent = JSON.stringify(complexObject, null, 2);
-    expect(writeFileSpy).toHaveBeenCalledWith("/complex/data.json", expectedContent, "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  // MULTIPLE KEYS IN INPUT
-  test("should only save the specified saveKey among multiple keys", async () => {
-    const result = await saveOutput({
-      savePath: "/selective",
-      fileName: "selected.txt",
-      saveKey: "targetKey",
-      targetKey: "This should be saved",
-      otherKey: "This should be ignored",
-      anotherKey: { ignored: "data" },
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith(
-      "/selective/selected.txt",
-      "This should be saved",
-      "utf8",
-    );
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  // FUNCTION CONTENT HANDLING
-  test("should convert function to string", async () => {
-    const testFunction = function testFn() {
-      return "hello";
-    };
-
-    const result = await saveOutput({
-      savePath: "/functions",
-      fileName: "function.txt",
-      saveKey: "fn",
-      fn: testFunction,
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith(
-      "/functions/function.txt",
-      testFunction.toString(),
-      "utf8",
-    );
-    expect(result.saveOutputStatus).toBe(true);
-  });
-
-  // ZERO VALUES
-  test("should save zero values correctly", async () => {
-    const result = await saveOutput({
-      savePath: "/zeros",
-      fileName: "zero.txt",
-      saveKey: "zeroValue",
-      zeroValue: 0,
-    });
-
-    expect(writeFileSpy).toHaveBeenCalledWith("/zeros/zero.txt", "0", "utf8");
-    expect(result.saveOutputStatus).toBe(true);
-  });
-});