@rool-dev/client 0.1.0-dev.1a6a7a3

package/dist/graph.d.ts

@@ -0,0 +1,240 @@
+import { EventEmitter } from './event-emitter.js';
+import type { GraphQLClient } from './graphql.js';
+import type { MediaClient } from './media.js';
+import type { RoolGraphData, RoolNode, RoolEdge, JSONPatchOp, GraphEvents, RoolGraphRole, RoolGraphUser, PromptOptions, ImageResult, ImageAspectRatio, MediaItem } from './types.js';
+export declare function generateEntityId(): string;
+interface GraphConfig {
+    id: string;
+    name: string;
+    role: RoolGraphRole;
+    initialData: RoolGraphData;
+    graphqlClient: GraphQLClient;
+    mediaClient: MediaClient;
+    onRegisterForEvents: (graphId: string, graph: RoolGraph) => void;
+    onUnregisterFromEvents: (graphId: string) => void;
+}
+/**
+ * First-class Graph object.
+ *
+ * Features:
+ * - High-level node/edge operations
+ * - Built-in undo/redo with checkpoints
+ * - Metadata management
+ * - Event emission for state changes
+ * - Real-time subscription support
+ */
+export declare class RoolGraph extends EventEmitter<GraphEvents> {
+    private _id;
+    private _name;
+    private _role;
+    private _data;
+    private graphqlClient;
+    private mediaClient;
+    private onRegisterForEvents;
+    private onUnregisterFromEvents;
+    private undoStack;
+    private redoStack;
+    private pendingPatch;
+    private patchScheduled;
+    private _isSubscribed;
+    constructor(config: GraphConfig);
+    get id(): string;
+    get name(): string;
+    get role(): RoolGraphRole;
+    get isReadOnly(): boolean;
+    get isSubscribed(): boolean;
+    /**
+     * Rename this graph.
+     */
+    rename(newName: string): Promise<void>;
+    /**
+     * Subscribe to real-time updates for this graph.
+     * Registers with the client for event routing.
+     */
+    subscribe(): void;
+    /**
+     * Unsubscribe from real-time updates.
+     */
+    unsubscribe(): void;
+    /**
+     * Close this graph and clean up resources.
+     */
+    close(): void;
+    /**
+     * Create a checkpoint for undo.
+     * Call this before a user action to capture the current state.
+     */
+    checkpoint(label?: string): void;
+    /**
+     * Check if undo is available.
+     */
+    canUndo(): boolean;
+    /**
+     * Check if redo is available.
+     */
+    canRedo(): boolean;
+    /**
+     * Undo to the previous checkpoint.
+     * @returns true if undo was performed
+     */
+    undo(): Promise<boolean>;
+    /**
+     * Redo a previously undone action.
+     * @returns true if redo was performed
+     */
+    redo(): Promise<boolean>;
+    /**
+     * Clear undo/redo history.
+     * Called when external changes invalidate local history.
+     */
+    clearHistory(): void;
+    /**
+     * Get a node by ID.
+     * @throws Error if node not found
+     */
+    getNode(nodeId: string): RoolNode;
+    /**
+     * Get a node by ID, or undefined if not found.
+     */
+    getNodeOrUndefined(nodeId: string): RoolNode | undefined;
+    /**
+     * Get all nodes of a specific type.
+     */
+    getNodesByType(type: string): RoolNode[];
+    /**
+     * Get all node IDs.
+     */
+    getNodeIds(): string[];
+    /**
+     * Add a new node.
+     */
+    addNode(nodeId: string, node: RoolNode): void;
+    /**
+     * Update an existing node.
+     * @param updates - Partial node data to merge
+     * @param persist - If false, update local state only (for drag/animation)
+     */
+    updateNode(nodeId: string, updates: Partial<RoolNode>, persist?: boolean): void;
+    /**
+     * Delete nodes by IDs.
+     * Also removes any edges connected to the deleted nodes.
+     */
+    deleteNodes(nodeIds: string[]): void;
+    /**
+     * Create an edge between nodes.
+     * @returns The generated edge ID
+     */
+    linkNodes(sourceId: string, targetId: string, edgeType: string): string;
+    /**
+     * Remove edges between two nodes.
+     * @returns true if any edges were removed
+     */
+    unlinkNodes(sourceId: string, targetId: string): boolean;
+    /**
+     * Get parent node IDs (nodes that have edges pointing TO this node).
+     * @param edgeType - Optional filter by edge type
+     */
+    getParents(nodeId: string, edgeType?: string): string[];
+    /**
+     * Get child node IDs (nodes that this node has edges pointing TO).
+     * @param edgeType - Optional filter by edge type
+     */
+    getChildren(nodeId: string, edgeType?: string): string[];
+    /**
+     * Get an edge by ID.
+     */
+    getEdge(edgeId: string): RoolEdge | undefined;
+    /**
+     * Get all edge IDs.
+     */
+    getEdgeIds(): string[];
+    /**
+     * Set a metadata value.
+     * Metadata is stored in _meta and hidden from AI operations.
+     */
+    setMetadata(key: string, value: unknown): void;
+    /**
+     * Get a metadata value.
+     */
+    getMetadata(key: string): unknown;
+    /**
+     * Get all metadata.
+     */
+    getAllMetadata(): Record<string, unknown>;
+    /**
+     * Send a prompt to the AI agent for graph manipulation.
+     */
+    prompt(prompt: string, options?: PromptOptions): Promise<string | null>;
+    /**
+     * Generate an AI image.
+     */
+    generateImage(prompt: string, aspectRatio?: ImageAspectRatio): Promise<ImageResult>;
+    /**
+     * Edit an existing image using AI.
+     */
+    editImage(prompt: string, url: string): Promise<ImageResult>;
+    /**
+     * List users with access to this graph.
+     */
+    listUsers(): Promise<RoolGraphUser[]>;
+    /**
+     * Add a user to this graph with specified role.
+     */
+    addUser(userId: string, role: RoolGraphRole): Promise<void>;
+    /**
+     * Remove a user from this graph.
+     */
+    removeUser(userId: string): Promise<void>;
+    /**
+     * List all media files for this graph.
+     */
+    listMedia(): Promise<MediaItem[]>;
+    /**
+     * Upload a file to this graph.
+     */
+    uploadMedia(file: File | Blob | {
+        data: string;
+        contentType: string;
+    }): Promise<MediaItem>;
+    /**
+     * Get the URL for a media file.
+     */
+    getMediaUrl(uuid: string): string;
+    /**
+     * Download a media file as a Blob.
+     */
+    downloadMedia(uuid: string): Promise<Blob>;
+    /**
+     * Delete a media file.
+     */
+    deleteMedia(uuid: string): Promise<void>;
+    /**
+     * Get the full graph data.
+     * Use sparingly - prefer specific operations.
+     */
+    getData(): RoolGraphData;
+    /**
+     * Apply a raw JSON patch.
+     * Use sparingly - prefer semantic operations.
+     */
+    patch(operations: JSONPatchOp[]): void;
+    /**
+     * Handle a patch event from another client.
+     * @internal
+     */
+    handleRemotePatch(patch: JSONPatchOp[]): void;
+    /**
+     * Handle a full graph reload from server.
+     * @internal
+     */
+    handleRemoteChange(newData: RoolGraphData): void;
+    /**
+     * Update the name from external source.
+     * @internal
+     */
+    handleRemoteRename(newName: string): void;
+    private sendPatch;
+    private resyncFromServer;
+}
+export {};
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}