studiograph 1.0.0

package/dist/core/graph.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Base Graph Manager
+ *
+ * Provides unified entity management across any repo type.
+ * Integrates Git, Markdown, and Asset services.
+ */
+import { GitUser } from '../services/git.js';
+import { MarkdownDocument } from '../services/markdown.js';
+import { AssetInfo, AssetConfig } from '../services/assets/index.js';
+import { EntityType, type EntityData, type DatasetRow } from './validation.js';
+import { type DatasetFilter } from '../services/csv-service.js';
+export interface GraphConfig {
+    repoPath: string;
+    assetConfig?: AssetConfig;
+    gitUser: GitUser;
+}
+export interface EntityFile {
+    id: string;
+    path: string;
+    entityType: string;
+    data: EntityData;
+    document: MarkdownDocument;
+}
+export interface SearchOptions {
+    entityType?: EntityType;
+    query?: string;
+    filters?: Record<string, any>;
+    visibility?: Array<'public' | 'team' | 'admin' | 'restricted'>;
+    tags?: string[];
+    dateRange?: {
+        from: string;
+        to: string;
+    };
+    sortBy?: 'created_at' | 'updated_at' | 'relevance';
+    limit?: number;
+}
+export interface CreateEntityOptions {
+    entityType: EntityType;
+    entityId: string;
+    data: Record<string, any>;
+    content?: string;
+    commitMessage?: string;
+}
+export interface UpdateEntityOptions {
+    entityType: EntityType;
+    entityId: string;
+    data?: Record<string, any>;
+    content?: string;
+    commitMessage?: string;
+}
+export declare class BaseGraphManager {
+    private repoPath;
+    private gitService;
+    private markdownService;
+    private assetService?;
+    private gitUser;
+    private csvService;
+    constructor(config: GraphConfig);
+    /**
+     * Ensure repository exists
+     */
+    private ensureRepo;
+    /**
+     * Get entity file path
+     */
+    private getEntityPath;
+    /**
+     * Get entity folder path
+     */
+    private getEntityFolder;
+    /**
+     * Public alias for getEntityPath (used internally by dataset methods)
+     */
+    private getEntityPathPublic;
+    /**
+     * Validate entity data against schema
+     */
+    private validateEntity;
+    /**
+     * Create a new entity
+     */
+    create(options: CreateEntityOptions): Promise<EntityFile>;
+    /**
+     * Get an entity by type and ID
+     */
+    get(entityType: EntityType, entityId: string): EntityFile;
+    /**
+     * Update an existing entity
+     */
+    update(options: UpdateEntityOptions): Promise<EntityFile>;
+    /**
+     * Delete an entity
+     */
+    delete(entityType: EntityType, entityId: string, commitMessage?: string): Promise<void>;
+    /**
+     * List entities of a given type
+     */
+    list(entityType?: EntityType, limit?: number): EntityFile[];
+    /**
+     * Search entities
+     */
+    search(options: SearchOptions): EntityFile[];
+    /**
+     * Get entities related to a given entity (via wikilinks)
+     */
+    getRelated(entityType: EntityType, entityId: string): EntityFile[];
+    /**
+     * Get entities that link to a given entity (backlinks)
+     */
+    getBacklinks(entityType: EntityType, entityId: string): EntityFile[];
+    /**
+     * Validate wikilinks in an entity
+     */
+    validateWikilinks(entityType: EntityType, entityId: string): {
+        valid: string[];
+        broken: string[];
+    };
+    /**
+     * Refactor a wikilink (rename entity and update all references)
+     */
+    refactorWikilink(oldId: string, newId: string, commitMessage?: string): Promise<{
+        updated: number;
+    }>;
+    /**
+     * Upload asset for an entity
+     */
+    uploadAsset(repoName: string, entityType: EntityType, entityId: string, filename: string, buffer: Buffer): Promise<AssetInfo>;
+    /**
+     * List assets for an entity
+     */
+    listAssets(repoName: string, entityType: EntityType, entityId: string): Promise<AssetInfo[]>;
+    /**
+     * Delete an asset
+     */
+    deleteAsset(repoName: string, entityType: EntityType, entityId: string, filename: string): Promise<void>;
+    /**
+     * Delete all assets for an entity (when entity is deleted)
+     */
+    deleteAllAssets(repoName: string, entityType: EntityType, entityId: string): Promise<number>;
+    /**
+     * Get dataset rows, optionally filtered
+     */
+    getDatasetRows(entityId: string, filter?: DatasetFilter): DatasetRow[];
+    /**
+     * Append rows to a dataset entity
+     */
+    appendDatasetRows(entityId: string, newRows: DatasetRow[], commitMessage?: string): Promise<EntityFile>;
+    /**
+     * Get repository status
+     */
+    getStatus(): {
+        modified: string[];
+        added: string[];
+        deleted: string[];
+        untracked: string[];
+    };
+    /**
+     * Get commit history
+     */
+    getHistory(limit?: number): Array<{
+        hash: string;
+        message: string;
+        author: {
+            name: string;
+            email: string;
+        };
+        timestamp: number;
+    }>;
+}