studiograph 1.1.3 → 1.2.0-beta.10

package/dist/core/graph.d.ts

@@ -27,6 +27,16 @@ export interface EntityFile {
     entityType: string;
     data: EntityData;
     document: MarkdownDocument;
+    /** True when entity folder contains files/folders beyond main.md */
+    hasSubContent?: boolean;
+    /** Number of sub-content files (non-main.md) in entity folder */
+    subContentCount?: number;
+}
+export interface ContentEntry {
+    name: string;
+    type: 'file' | 'directory';
+    count?: number;
+    children?: ContentEntry[];
 }
 export interface SearchOptions {
     entityType?: EntityType;
@@ -47,6 +57,7 @@ export interface CreateEntityOptions {
     data: Record<string, any>;
     content?: string;
     commitMessage?: string;
+    skipCommit?: boolean;
 }
 export interface UpdateEntityOptions {
     entityType: EntityType;
@@ -54,6 +65,7 @@ export interface UpdateEntityOptions {
     data?: Record<string, any>;
     content?: string;
     commitMessage?: string;
+    skipCommit?: boolean;
 }
 export declare class BaseGraphManager {
     private repoPath;
@@ -73,16 +85,13 @@ export declare class BaseGraphManager {
     private ensureRepo;
     /**
      * Get entity file path
+     *
+     * Checks three layouts:
+     *   1. Flat folder:       {repo}/{entityId}/main.md
+     *   2. Type subfolder:    {repo}/{entityType}/{entityId}/main.md
+     *   3. Collection (flat): {repo}/{entityId}.md
      */
     private getEntityPath;
-    /**
-     * Get entity folder path
-     */
-    private getEntityFolder;
-    /**
-     * Public alias for getEntityPath (used internally by dataset methods)
-     */
-    private getEntityPathPublic;
     /**
      * Validate entity data against schema
      */
@@ -95,6 +104,25 @@ export declare class BaseGraphManager {
      * Get an entity by type and ID
      */
     get(entityType: EntityType, entityId: string): EntityFile;
+    /**
+     * Get an entity by ID only (type resolved from frontmatter)
+     */
+    getById(entityId: string): EntityFile;
+    /**
+     * List files and folders alongside main.md in an entity folder.
+     * Returns a recursive tree. Collection-mode entities return [].
+     */
+    listEntityContents(entityType: EntityType, entityId: string): ContentEntry[];
+    /**
+     * Read a sub-content file from within an entity folder.
+     * Returns the raw file content as a string, or null if not found.
+     */
+    readEntityContent(entityType: EntityType, entityId: string, filePath: string): string | null;
+    /**
+     * Write a sub-content file inside an entity folder.
+     * Creates parent directories as needed. Prevents path traversal.
+     */
+    writeEntityContent(entityType: EntityType, entityId: string, filePath: string, content: string): void;
     /**
      * Update an existing entity
      */
@@ -135,19 +163,19 @@ export declare class BaseGraphManager {
     /**
      * Upload asset for an entity
      */
-    uploadAsset(repoName: string, entityType: EntityType, entityId: string, filename: string, buffer: Buffer): Promise<AssetInfo>;
+    uploadAsset(entityType: EntityType, entityId: string, filename: string, buffer: Buffer, keyPrefix?: string): Promise<AssetInfo>;
     /**
      * List assets for an entity
      */
-    listAssets(repoName: string, entityType: EntityType, entityId: string): Promise<AssetInfo[]>;
+    listAssets(entityType: EntityType, entityId: string, keyPrefix?: string): Promise<AssetInfo[]>;
     /**
      * Delete an asset
      */
-    deleteAsset(repoName: string, entityType: EntityType, entityId: string, filename: string): Promise<void>;
+    deleteAsset(entityType: EntityType, entityId: string, filename: string, keyPrefix?: string): Promise<void>;
     /**
      * Delete all assets for an entity (when entity is deleted)
      */
-    deleteAllAssets(repoName: string, entityType: EntityType, entityId: string): Promise<number>;
+    deleteAllAssets(entityType: EntityType, entityId: string, keyPrefix?: string): Promise<number>;
     /**
      * Get dataset rows, optionally filtered
      */