@interactive-inc/docs-client 0.0.3 → 0.0.5

package/build/doc-path-system.js

@@ -0,0 +1,148 @@
+/**
+ * パス操作システム
+ */
+export class DocPathSystem {
+    separator = "/";
+    /**
+     * パスを結合
+     */
+    join(...paths) {
+        const parts = [];
+        for (const path of paths) {
+            if (path === "")
+                continue;
+            // セパレータで分割
+            const segments = path.split(this.separator).filter(Boolean);
+            parts.push(...segments);
+        }
+        // 空の場合は "." を返す
+        if (parts.length === 0) {
+            return ".";
+        }
+        // 先頭が "/" で始まっていた場合は絶対パスとして扱う
+        const isAbsolute = paths[0]?.startsWith(this.separator);
+        const joined = parts.join(this.separator);
+        return isAbsolute ? `${this.separator}${joined}` : joined;
+    }
+    /**
+     * ファイル名を取得（拡張子付き）
+     */
+    basename(path, ext) {
+        const segments = path.split(this.separator);
+        const filename = segments[segments.length - 1] || "";
+        if (ext && filename.endsWith(ext)) {
+            return filename.slice(0, -ext.length);
+        }
+        return filename;
+    }
+    /**
+     * ディレクトリ名を取得
+     */
+    dirname(path) {
+        const segments = path.split(this.separator);
+        // ルートディレクトリの場合
+        if (segments.length <= 1) {
+            return ".";
+        }
+        // 最後の要素を除いた部分を結合
+        segments.pop();
+        const dir = segments.join(this.separator);
+        // 空の場合は "." を返す
+        return dir || ".";
+    }
+    /**
+     * 拡張子を取得
+     */
+    extname(path) {
+        const basename = this.basename(path);
+        const lastDot = basename.lastIndexOf(".");
+        if (lastDot <= 0) {
+            return "";
+        }
+        return basename.slice(lastDot);
+    }
+    /**
+     * 相対パスを計算
+     */
+    relative(from, to) {
+        const fromSegments = from.split(this.separator).filter(Boolean);
+        const toSegments = to.split(this.separator).filter(Boolean);
+        // 共通の親ディレクトリを見つける
+        let commonLength = 0;
+        for (let i = 0; i < Math.min(fromSegments.length, toSegments.length); i++) {
+            if (fromSegments[i] === toSegments[i]) {
+                commonLength++;
+            }
+            else {
+                break;
+            }
+        }
+        // fromから共通の親まで戻る
+        const upCount = fromSegments.length - commonLength;
+        const upSegments = Array(upCount).fill("..");
+        // 共通の親からtoへのパス
+        const downSegments = toSegments.slice(commonLength);
+        // 結合
+        const segments = [...upSegments, ...downSegments];
+        return segments.length > 0 ? segments.join(this.separator) : ".";
+    }
+    /**
+     * 絶対パスに変換
+     */
+    resolve(...paths) {
+        // 簡易実装：最後の絶対パスから開始、または現在のパスから開始
+        let resolved = "";
+        for (const path of paths) {
+            if (path.startsWith(this.separator)) {
+                // 絶対パスの場合はリセット
+                resolved = path;
+            }
+            else if (path !== "") {
+                // 相対パスの場合は結合
+                resolved = resolved ? this.join(resolved, path) : path;
+            }
+        }
+        return resolved || ".";
+    }
+    /**
+     * パスを正規化
+     */
+    normalize(path) {
+        const isAbsolute = path.startsWith(this.separator);
+        const segments = path.split(this.separator).filter(Boolean);
+        const normalized = [];
+        for (const segment of segments) {
+            if (segment === "..") {
+                // 親ディレクトリへ
+                if (normalized.length > 0 &&
+                    normalized[normalized.length - 1] !== "..") {
+                    normalized.pop();
+                }
+                else if (!isAbsolute) {
+                    normalized.push("..");
+                }
+            }
+            else if (segment !== ".") {
+                // "." は無視、それ以外は追加
+                normalized.push(segment);
+            }
+        }
+        if (normalized.length === 0) {
+            return isAbsolute ? this.separator : ".";
+        }
+        const result = normalized.join(this.separator);
+        return isAbsolute ? `${this.separator}${result}` : result;
+    }
+    /**
+     * パスが絶対パスかどうか
+     */
+    isAbsolute(path) {
+        return path.startsWith(this.separator);
+    }
+    /**
+     * パスのセパレータ
+     */
+    get sep() {
+        return this.separator;
+    }
+}

package/build/doc-path-system.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doc-path-system.test.d.ts.map

package/build/doc-path-system.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-path-system.test.d.ts","sourceRoot":"","sources":["../lib/doc-path-system.test.ts"],"names":[],"mappings":""}

package/build/doc-path-system.test.js

@@ -0,0 +1,67 @@
+import { expect, test } from "bun:test";
+import { DocPathSystem } from "./doc-path-system";
+test("DocPathSystem - join: パスを結合", () => {
+    const system = new DocPathSystem();
+    expect(system.join("docs", "products", "index.md")).toBe("docs/products/index.md");
+    expect(system.join("/docs", "products")).toBe("/docs/products");
+    expect(system.join("docs/", "/products")).toBe("docs/products");
+    expect(system.join("", "docs", "", "index.md")).toBe("docs/index.md");
+    expect(system.join()).toBe(".");
+});
+test("DocPathSystem - basename: ファイル名を取得", () => {
+    const system = new DocPathSystem();
+    expect(system.basename("docs/index.md")).toBe("index.md");
+    expect(system.basename("docs/index.md", ".md")).toBe("index");
+    expect(system.basename("/path/to/file.txt")).toBe("file.txt");
+    expect(system.basename("file")).toBe("file");
+    expect(system.basename("")).toBe("");
+});
+test("DocPathSystem - dirname: ディレクトリ名を取得", () => {
+    const system = new DocPathSystem();
+    expect(system.dirname("docs/products/index.md")).toBe("docs/products");
+    expect(system.dirname("docs/index.md")).toBe("docs");
+    expect(system.dirname("index.md")).toBe(".");
+    expect(system.dirname("/")).toBe(".");
+    expect(system.dirname("")).toBe(".");
+});
+test("DocPathSystem - extname: 拡張子を取得", () => {
+    const system = new DocPathSystem();
+    expect(system.extname("index.md")).toBe(".md");
+    expect(system.extname("file.test.ts")).toBe(".ts");
+    expect(system.extname("README")).toBe("");
+    expect(system.extname(".gitignore")).toBe("");
+    expect(system.extname("file.")).toBe(".");
+});
+test("DocPathSystem - relative: 相対パスを計算", () => {
+    const system = new DocPathSystem();
+    expect(system.relative("docs/products", "docs/features")).toBe("../features");
+    expect(system.relative("docs", "docs/products/app")).toBe("products/app");
+    expect(system.relative("docs/products/app", "docs")).toBe("../..");
+    expect(system.relative("docs", "docs")).toBe(".");
+});
+test("DocPathSystem - resolve: 絶対パスに変換", () => {
+    const system = new DocPathSystem();
+    expect(system.resolve("/docs", "products", "index.md")).toBe("/docs/products/index.md");
+    expect(system.resolve("docs", "/products", "index.md")).toBe("/products/index.md");
+    expect(system.resolve("", "docs")).toBe("docs");
+    expect(system.resolve()).toBe(".");
+});
+test("DocPathSystem - normalize: パスを正規化", () => {
+    const system = new DocPathSystem();
+    expect(system.normalize("docs//products/../features/./index.md")).toBe("docs/features/index.md");
+    expect(system.normalize("/docs/../products")).toBe("/products");
+    expect(system.normalize("../docs/./products")).toBe("../docs/products");
+    expect(system.normalize("./docs")).toBe("docs");
+    expect(system.normalize(".")).toBe(".");
+});
+test("DocPathSystem - isAbsolute: 絶対パスかどうか", () => {
+    const system = new DocPathSystem();
+    expect(system.isAbsolute("/docs/index.md")).toBe(true);
+    expect(system.isAbsolute("docs/index.md")).toBe(false);
+    expect(system.isAbsolute("./docs")).toBe(false);
+    expect(system.isAbsolute("")).toBe(false);
+});
+test("DocPathSystem - sep: セパレータ", () => {
+    const system = new DocPathSystem();
+    expect(system.sep).toBe("/");
+});

package/build/entities/doc-file-entity.d.ts

@@ -0,0 +1,5 @@
+import type { DocFileIndexEntity } from "./doc-file-index-entity";
+import type { DocFileMdEntity } from "./doc-file-md-entity";
+import type { DocFileUnknownEntity } from "./doc-file-unknown-entity";
+export type DocFileEntity = DocFileMdEntity | DocFileIndexEntity | DocFileUnknownEntity;
+//# sourceMappingURL=doc-file-entity.d.ts.map

package/build/entities/doc-file-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-file-entity.d.ts","sourceRoot":"","sources":["../../lib/entities/doc-file-entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,CAAA"}

package/build/entities/doc-file-entity.js

@@ -0,0 +1 @@
+export {};

package/build/entities/doc-file-index-entity.d.ts

@@ -0,0 +1,30 @@
+import type { DocFileIndex, DocFilePath } from "../types";
+import { DocFileContentIndexValue } from "../values/doc-file-content-index-value";
+/**
+ * ドキュメントのディレクトリ
+ */
+export declare class DocFileIndexEntity {
+    readonly value: DocFileIndex;
+    constructor(value: DocFileIndex);
+    /**
+     * コンテンツ
+     */
+    get content(): DocFileContentIndexValue;
+    /**
+     * パス情報
+     */
+    get path(): DocFilePath;
+    /**
+     * コンテンツを更新
+     */
+    withContent(content: DocFileContentIndexValue): DocFileIndexEntity;
+    /**
+     * パスを更新
+     */
+    withPath(path: DocFilePath): DocFileIndexEntity;
+    /**
+     * indexFileSchemaの形式に変換
+     */
+    toJson(): DocFileIndex;
+}
+//# sourceMappingURL=doc-file-index-entity.d.ts.map

package/build/entities/doc-file-index-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-file-index-entity.d.ts","sourceRoot":"","sources":["../../lib/entities/doc-file-index-entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AAEjF;;GAEG;AACH,qBAAa,kBAAkB;IACjB,QAAQ,CAAC,KAAK,EAAE,YAAY;IAAxC,YAAqB,KAAK,EAAE,YAAY,EAGvC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,wBAAwB,CAEtC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,kBAAkB,CAKjE;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAK9C;IAED;;OAEG;IACH,MAAM,IAAI,YAAY,CAErB;CACF"}

package/build/entities/doc-file-index-entity.js

@@ -0,0 +1,49 @@
+import { zDocFileIndex } from "../models";
+import { DocFileContentIndexValue } from "../values/doc-file-content-index-value";
+/**
+ * ドキュメントのディレクトリ
+ */
+export class DocFileIndexEntity {
+    value;
+    constructor(value) {
+        this.value = value;
+        zDocFileIndex.parse(value);
+        Object.freeze(this);
+    }
+    /**
+     * コンテンツ
+     */
+    get content() {
+        return new DocFileContentIndexValue(this.value.content);
+    }
+    /**
+     * パス情報
+     */
+    get path() {
+        return this.value.path;
+    }
+    /**
+     * コンテンツを更新
+     */
+    withContent(content) {
+        return new DocFileIndexEntity({
+            ...this.value,
+            content: content.value,
+        });
+    }
+    /**
+     * パスを更新
+     */
+    withPath(path) {
+        return new DocFileIndexEntity({
+            ...this.value,
+            path: path,
+        });
+    }
+    /**
+     * indexFileSchemaの形式に変換
+     */
+    toJson() {
+        return this.value;
+    }
+}

package/build/entities/doc-file-index-entity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doc-file-index-entity.test.d.ts.map

package/build/entities/doc-file-index-entity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-file-index-entity.test.d.ts","sourceRoot":"","sources":["../../lib/entities/doc-file-index-entity.test.ts"],"names":[],"mappings":""}

package/build/entities/doc-file-index-entity.test.js

@@ -0,0 +1,195 @@
+import { expect, test } from "bun:test";
+import { DocFileContentIndexValue } from "../values/doc-file-content-index-value";
+import { DocFileIndexEntity } from "./doc-file-index-entity";
+test("DocFileIndexEntity - 基本的な作成とプロパティアクセス", () => {
+    const entity = new DocFileIndexEntity({
+        type: "index",
+        content: {
+            type: "markdown-index",
+            body: "# タイトル\n\n説明文",
+            title: "タイトル",
+            description: "説明文",
+            frontMatter: {
+                type: "index-frontmatter",
+                icon: "📁",
+                schema: {},
+            },
+        },
+        path: {
+            path: "docs/index.md",
+            name: "index",
+            fullPath: "/Users/test/docs/index.md",
+            nameWithExtension: "index.md",
+        },
+        isArchived: false,
+    });
+    expect(entity.value.type).toBe("index");
+});
+test("DocFileIndexEntity - content getterが値オブジェクトを返す", () => {
+    const entity = new DocFileIndexEntity({
+        type: "index",
+        content: {
+            type: "markdown-index",
+            body: "# タイトル",
+            title: "タイトル",
+            description: "",
+            frontMatter: {
+                type: "index-frontmatter",
+                icon: "📁",
+                schema: {},
+            },
+        },
+        path: {
+            path: "docs/index.md",
+            name: "index",
+            fullPath: "/Users/test/docs/index.md",
+            nameWithExtension: "index.md",
+        },
+        isArchived: false,
+    });
+    const content = entity.content;
+    expect(content).toBeInstanceOf(DocFileContentIndexValue);
+    expect(content.title).toBe("タイトル");
+    expect(content.body).toBe("# タイトル");
+});
+test("DocFileIndexEntity - path getterがオブジェクトを返す", () => {
+    const entity = new DocFileIndexEntity({
+        type: "index",
+        content: {
+            type: "markdown-index",
+            body: "",
+            title: "",
+            description: "",
+            frontMatter: {
+                type: "index-frontmatter",
+                icon: "",
+                schema: {},
+            },
+        },
+        path: {
+            path: "docs/index.md",
+            name: "index",
+            fullPath: "/Users/test/docs/index.md",
+            nameWithExtension: "index.md",
+        },
+        isArchived: false,
+    });
+    const path = entity.path;
+    expect(path.name).toBe("index");
+    expect(path.path).toBe("docs/index.md");
+    expect(path.fullPath).toBe("/Users/test/docs/index.md");
+    expect(path.nameWithExtension).toBe("index.md");
+});
+test("DocFileIndexEntity - withContentで新しいインスタンスを作成", () => {
+    const entity = new DocFileIndexEntity({
+        type: "index",
+        content: {
+            type: "markdown-index",
+            body: "# 古いタイトル",
+            title: "古いタイトル",
+            description: "",
+            frontMatter: {
+                type: "index-frontmatter",
+                icon: "📁",
+                schema: {},
+            },
+        },
+        path: {
+            path: "docs/index.md",
+            name: "index",
+            fullPath: "/Users/test/docs/index.md",
+            nameWithExtension: "index.md",
+        },
+        isArchived: false,
+    });
+    const newContent = entity.content.withTitle("新しいタイトル");
+    const newEntity = entity.withContent(newContent);
+    expect(newEntity).not.toBe(entity); // 新しいインスタンス
+    expect(newEntity.content.title).toBe("新しいタイトル");
+    expect(entity.content.title).toBe("古いタイトル"); // 元は変更されない
+});
+test("DocFileIndexEntity - withPathで新しいインスタンスを作成", () => {
+    const entity = new DocFileIndexEntity({
+        type: "index",
+        content: {
+            type: "markdown-index",
+            body: "",
+            title: "",
+            description: "",
+            frontMatter: {
+                type: "index-frontmatter",
+                icon: "",
+                schema: {},
+            },
+        },
+        path: {
+            path: "docs/index.md",
+            name: "index",
+            fullPath: "/Users/test/docs/index.md",
+            nameWithExtension: "index.md",
+        },
+        isArchived: false,
+    });
+    const newPath = {
+        path: "docs/new-index.md",
+        name: "new-index",
+        fullPath: "/Users/test/docs/new-index.md",
+        nameWithExtension: "new-index.md",
+    };
+    const newEntity = entity.withPath(newPath);
+    expect(newEntity).not.toBe(entity); // 新しいインスタンス
+    expect(newEntity.path.path).toBe("docs/new-index.md");
+    expect(entity.path.path).toBe("docs/index.md"); // 元は変更されない
+});
+test("DocFileIndexEntity - toJsonで元のデータ構造を返す", () => {
+    const data = {
+        type: "index",
+        content: {
+            type: "markdown-index",
+            body: "# タイトル",
+            title: "タイトル",
+            description: "説明",
+            frontMatter: {
+                type: "index-frontmatter",
+                icon: "📁",
+                schema: {},
+            },
+        },
+        path: {
+            path: "docs/index.md",
+            name: "index",
+            fullPath: "/Users/test/docs/index.md",
+            nameWithExtension: "index.md",
+        },
+        isArchived: false,
+    };
+    const entity = new DocFileIndexEntity(data);
+    expect(entity.toJson()).toEqual(data);
+});
+test("DocFileIndexEntity - 不変性の確認", () => {
+    const entity = new DocFileIndexEntity({
+        type: "index",
+        content: {
+            type: "markdown-index",
+            body: "",
+            title: "",
+            description: "",
+            frontMatter: {
+                type: "index-frontmatter",
+                icon: "",
+                schema: {},
+            },
+        },
+        path: {
+            path: "docs/index.md",
+            name: "index",
+            fullPath: "/Users/test/docs/index.md",
+            nameWithExtension: "index.md",
+        },
+        isArchived: false,
+    });
+    expect(() => {
+        // @ts-expect-error - 不変性のテスト
+        entity.value = {};
+    }).toThrow();
+});

package/build/entities/doc-file-md-entity.d.ts

@@ -0,0 +1,30 @@
+import type { DocFileMd, DocFilePath } from "../types";
+import { DocFileContentMdValue } from "../values/doc-file-content-md-value";
+/**
+ * ドキュメントのファイル
+ */
+export declare class DocFileMdEntity {
+    readonly value: DocFileMd;
+    constructor(value: DocFileMd);
+    /**
+     * コンテンツ
+     */
+    get content(): DocFileContentMdValue;
+    /**
+     * パス情報
+     */
+    get path(): DocFilePath;
+    /**
+     * コンテンツを更新
+     */
+    withContent(content: DocFileContentMdValue): DocFileMdEntity;
+    /**
+     * パスを更新
+     */
+    withPath(path: DocFilePath): DocFileMdEntity;
+    /**
+     * JSON形式に変換
+     */
+    toJson(): DocFileMd;
+}
+//# sourceMappingURL=doc-file-md-entity.d.ts.map

package/build/entities/doc-file-md-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-file-md-entity.d.ts","sourceRoot":"","sources":["../../lib/entities/doc-file-md-entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAE3E;;GAEG;AACH,qBAAa,eAAe;IACd,QAAQ,CAAC,KAAK,EAAE,SAAS;IAArC,YAAqB,KAAK,EAAE,SAAS,EAGpC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,qBAAqB,CAEnC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAK3D;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAK3C;IAED;;OAEG;IACH,MAAM,IAAI,SAAS,CAElB;CACF"}

package/build/entities/doc-file-md-entity.js

@@ -0,0 +1,49 @@
+import { zDocFileMd } from "../models";
+import { DocFileContentMdValue } from "../values/doc-file-content-md-value";
+/**
+ * ドキュメントのファイル
+ */
+export class DocFileMdEntity {
+    value;
+    constructor(value) {
+        this.value = value;
+        zDocFileMd.parse(value);
+        Object.freeze(this);
+    }
+    /**
+     * コンテンツ
+     */
+    get content() {
+        return new DocFileContentMdValue(this.value.content);
+    }
+    /**
+     * パス情報
+     */
+    get path() {
+        return this.value.path;
+    }
+    /**
+     * コンテンツを更新
+     */
+    withContent(content) {
+        return new DocFileMdEntity({
+            ...this.value,
+            content: content.value,
+        });
+    }
+    /**
+     * パスを更新
+     */
+    withPath(path) {
+        return new DocFileMdEntity({
+            ...this.value,
+            path: path,
+        });
+    }
+    /**
+     * JSON形式に変換
+     */
+    toJson() {
+        return this.value;
+    }
+}

package/build/entities/doc-file-md-entity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doc-file-md-entity.test.d.ts.map

package/build/entities/doc-file-md-entity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-file-md-entity.test.d.ts","sourceRoot":"","sources":["../../lib/entities/doc-file-md-entity.test.ts"],"names":[],"mappings":""}