@graph-knowledge/api 0.3.2 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph-knowledge/api",
-  "version": "0.3.2",
+  "version": "0.9.0",
   "description": "Headless Document API for Graph Knowledge - programmatic access to documents, nodes, and elements",
   "license": "MIT",
   "author": "Graph Knowledge Team",

package/src/index.d.ts

@@ -7,9 +7,10 @@ export type { INodeOperations } from "./lib/interfaces/node-operations.interface
 export type { IElementOperations } from "./lib/interfaces/element-operations.interface";
 export type { IBatchOperations, BatchUpdateElementInput } from "./lib/interfaces/batch-operations.interface";
 export type { ITemplateOperations } from "./lib/interfaces/template-operations.interface";
+export type { ICustomShapeOperations } from "./lib/interfaces/custom-shape-operations.interface";
 export type { IElementTypeValidator, IElementValidatorRegistry } from "./lib/interfaces/element-validator.interface";
-export type { CreateDocumentInput, UpdateDocumentInput, DocumentResult, CreateNodeInput, UpdateNodeInput, NodeResult, CreateTemplateInput } from "./lib/types/api-types";
-export type { BaseElementInput, RectangleInput, TextInput, ConnectorInput, ConnectorAnchor, LineStyle, MarkerType, UmlClassInput, UmlInterfaceInput, UmlComponentInput, UmlPackageInput, UmlArtifactInput, UmlNoteInput, TriangleInput, DiamondInput, HexagonInput, EllipseInput, LineInput, BlockArrowInput, BlockArrowDirection, CustomShapeInput, AnyElementInput, UpdateElementInput } from "./lib/types/element-input-types";
+export type { CreateDocumentInput, UpdateDocumentInput, DocumentResult, CreateNodeInput, UpdateNodeInput, NodeResult, CreateNodeWithElementsInput, CreateNodeWithElementsResult, CreateTemplateInput, UpdateTemplateInput, CreateCustomShapeInput, UpdateCustomShapeInput, CustomShapeResult, ViewBoxInput } from "./lib/types/api-types";
+export type { BaseElementInput, RectangleInput, TextInput, ConnectorInput, ConnectorAnchor, LineStyle, MarkerType, UmlClassInput, UmlInterfaceInput, UmlComponentInput, UmlPackageInput, UmlArtifactInput, UmlNoteInput, TriangleInput, DiamondInput, HexagonInput, EllipseInput, LineInput, BezierCurveInput, BlockArrowInput, BlockArrowDirection, CustomShapeInput, AnyElementInput, UpdateElementInput } from "./lib/types/element-input-types";
 export { GraphKnowledgeAPIError, AuthenticationError, NotFoundError, ValidationError, PermissionError } from "./lib/errors/api-errors";
 export type { Document, GraphNode, GraphElement } from "./lib/models";
 export { CURRENT_DOCUMENT_SCHEMA_VERSION } from "./lib/models";

package/src/lib/clients/firebase-auth-client.d.ts

@@ -10,12 +10,19 @@ export declare class FirebaseAuthClient implements IAuthClient {
     private _currentUser;
     private _initialized;
     private _initPromise;
+    private _unsubscribe;
     constructor(auth: Auth, firestore: Firestore);
+    /**
+     * Cleans up the auth state listener.
+     * Call this when the API instance is no longer needed.
+     */
+    destroy(): void;
     /**
      * Waits for auth state to be initialized.
      */
     waitForInit(): Promise<void>;
     signIn(email: string, password: string): Promise<void>;
+    signInWithCustomToken(token: string): Promise<void>;
     signOut(): Promise<void>;
     get currentUserId(): string | null;
     requireAuth(): string;

package/src/lib/clients/firebase-auth-client.js

@@ -13,20 +13,28 @@ class FirebaseAuthClient {
     _currentUser = null;
     _initialized = false;
     _initPromise;
+    _unsubscribe = null;
     constructor(auth, firestore) {
         this.auth = auth;
         this.firestore = firestore;
         this._initPromise = new Promise((resolve) => {
-            const unsubscribe = (0, auth_1.onAuthStateChanged)(this.auth, (user) => {
+            this._unsubscribe = (0, auth_1.onAuthStateChanged)(this.auth, (user) => {
                 this._currentUser = user;
                 if (!this._initialized) {
                     this._initialized = true;
-                    unsubscribe();
                     resolve();
                 }
             });
         });
     }
+    /**
+     * Cleans up the auth state listener.
+     * Call this when the API instance is no longer needed.
+     */
+    destroy() {
+        this._unsubscribe?.();
+        this._unsubscribe = null;
+    }
     /**
      * Waits for auth state to be initialized.
      */
@@ -43,6 +51,16 @@ class FirebaseAuthClient {
             throw new api_errors_1.AuthenticationError(message);
         }
     }
+    async signInWithCustomToken(token) {
+        try {
+            const credential = await (0, auth_1.signInWithCustomToken)(this.auth, token);
+            this._currentUser = credential.user;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Custom token sign in failed";
+            throw new api_errors_1.AuthenticationError(message);
+        }
+    }
     async signOut() {
         await (0, auth_1.signOut)(this.auth);
         this._currentUser = null;

package/src/lib/clients/firebase-firestore-client.js

@@ -2,6 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FirebaseFirestoreClient = void 0;
 const firestore_1 = require("firebase/firestore");
+const api_errors_1 = require("../errors/api-errors");
+/**
+ * Maps Firebase error codes to typed API errors.
+ * @throws PermissionError for permission-denied
+ * @throws AuthenticationError for unauthenticated
+ * @throws the original error for all other cases
+ */
+function handleFirestoreError(error) {
+    if (error instanceof Error && "code" in error) {
+        const code = error.code;
+        if (code === "permission-denied") {
+            throw new api_errors_1.PermissionError("Firestore access denied: " + error.message);
+        }
+        if (code === "unauthenticated") {
+            throw new api_errors_1.AuthenticationError("Firestore authentication failed: " + error.message);
+        }
+    }
+    throw error;
+}
 /**
  * Firebase Firestore batch writer implementation.
  */
@@ -25,7 +44,12 @@ class FirestoreBatchWriter {
         this.batch.delete(docRef);
     }
     async commit() {
-        await this.batch.commit();
+        try {
+            await this.batch.commit();
+        }
+        catch (error) {
+            handleFirestoreError(error);
+        }
     }
 }
 /**
@@ -37,44 +61,74 @@ class FirebaseFirestoreClient {
         this.db = db;
     }
     async getDocument(path) {
-        const docRef = (0, firestore_1.doc)(this.db, path);
-        const snapshot = await (0, firestore_1.getDoc)(docRef);
-        if (!snapshot.exists()) {
-            return null;
-        }
-        return {
-            id: snapshot.id,
-            ...snapshot.data()
-        };
+        try {
+            const docRef = (0, firestore_1.doc)(this.db, path);
+            const snapshot = await (0, firestore_1.getDoc)(docRef);
+            if (!snapshot.exists()) {
+                return null;
+            }
+            return {
+                id: snapshot.id,
+                ...snapshot.data()
+            };
+        }
+        catch (error) {
+            handleFirestoreError(error);
+        }
     }
     async setDocument(path, data) {
-        const docRef = (0, firestore_1.doc)(this.db, path);
-        await (0, firestore_1.setDoc)(docRef, data);
+        try {
+            const docRef = (0, firestore_1.doc)(this.db, path);
+            await (0, firestore_1.setDoc)(docRef, data);
+        }
+        catch (error) {
+            handleFirestoreError(error);
+        }
     }
     async updateDocument(path, data) {
-        const docRef = (0, firestore_1.doc)(this.db, path);
-        await (0, firestore_1.updateDoc)(docRef, data);
+        try {
+            const docRef = (0, firestore_1.doc)(this.db, path);
+            await (0, firestore_1.updateDoc)(docRef, data);
+        }
+        catch (error) {
+            handleFirestoreError(error);
+        }
     }
     async deleteDocument(path) {
-        const docRef = (0, firestore_1.doc)(this.db, path);
-        await (0, firestore_1.deleteDoc)(docRef);
+        try {
+            const docRef = (0, firestore_1.doc)(this.db, path);
+            await (0, firestore_1.deleteDoc)(docRef);
+        }
+        catch (error) {
+            handleFirestoreError(error);
+        }
     }
     async getCollection(path) {
-        const collectionRef = (0, firestore_1.collection)(this.db, path);
-        const snapshot = await (0, firestore_1.getDocs)(collectionRef);
-        return snapshot.docs.map((doc) => ({
-            id: doc.id,
-            ...doc.data()
-        }));
+        try {
+            const collectionRef = (0, firestore_1.collection)(this.db, path);
+            const snapshot = await (0, firestore_1.getDocs)(collectionRef);
+            return snapshot.docs.map((doc) => ({
+                id: doc.id,
+                ...doc.data()
+            }));
+        }
+        catch (error) {
+            handleFirestoreError(error);
+        }
     }
     async queryCollection(path, field, value) {
-        const collectionRef = (0, firestore_1.collection)(this.db, path);
-        const q = (0, firestore_1.query)(collectionRef, (0, firestore_1.where)(field, "==", value));
-        const snapshot = await (0, firestore_1.getDocs)(q);
-        return snapshot.docs.map((doc) => ({
-            id: doc.id,
-            ...doc.data()
-        }));
+        try {
+            const collectionRef = (0, firestore_1.collection)(this.db, path);
+            const q = (0, firestore_1.query)(collectionRef, (0, firestore_1.where)(field, "==", value));
+            const snapshot = await (0, firestore_1.getDocs)(q);
+            return snapshot.docs.map((doc) => ({
+                id: doc.id,
+                ...doc.data()
+            }));
+        }
+        catch (error) {
+            handleFirestoreError(error);
+        }
     }
     batch() {
         return new FirestoreBatchWriter(this.db, (0, firestore_1.writeBatch)(this.db));

package/src/lib/constants/element-defaults.js

@@ -20,6 +20,7 @@ exports.DEFAULT_ELEMENT_DIMENSIONS = {
     hexagon: { width: 120, height: 104 },
     ellipse: { width: 150, height: 100 },
     line: { width: 150, height: 0 },
+    "bezier-curve": { width: 150, height: 0 },
     "block-arrow": { width: 150, height: 80 }
 };
 /**

package/src/lib/graph-knowledge-api.d.ts

@@ -5,6 +5,7 @@ import { INodeOperations } from "./interfaces/node-operations.interface";
 import { IElementOperations } from "./interfaces/element-operations.interface";
 import { IBatchOperations } from "./interfaces/batch-operations.interface";
 import { ITemplateOperations } from "./interfaces/template-operations.interface";
+import { ICustomShapeOperations } from "./interfaces/custom-shape-operations.interface";
 import { MeasureTextOptions, TextMetrics } from "./types/text-measurement-types";
 import { FitTextOptions, FitTextResult, ShapeBounds } from "./types/layout-types";
 /**
@@ -52,6 +53,7 @@ export declare class GraphKnowledgeAPI {
     private readonly _elements;
     private readonly _batch;
     private readonly _templates;
+    private readonly _customShapes;
     /**
      * Shared text measurement service for static and instance methods.
      */
@@ -86,17 +88,29 @@ export declare class GraphKnowledgeAPI {
      */
     get batch(): IBatchOperations;
     /**
-     * Template operations (list, get, clone, publish, unpublish).
+     * Template operations (create, list, get, update, delete, clone, publish, unpublish).
      * Templates are documents that can be cloned by premium users.
-     * Admins can publish/unpublish templates to control visibility.
+     * Admins can create/update/delete and publish/unpublish templates.
      */
     get templates(): ITemplateOperations;
+    /**
+     * Custom shape operations (create, list, get, update, delete, publish, unpublish, listPublished, getPublished).
+     * Custom shapes are user-created SVG path-based shapes.
+     * Premium users can create and publish shapes to the public store.
+     */
+    get customShapes(): ICustomShapeOperations;
     /**
      * Signs in with email and password.
      * @param email User email
      * @param password User password
      */
     signIn(email: string, password: string): Promise<void>;
+    /**
+     * Signs in with a Firebase custom token (for server-to-server auth).
+     * Used by remote MCP server to authenticate per-user sessions.
+     * @param token Custom token generated by Firebase Admin SDK
+     */
+    signInWithCustomToken(token: string): Promise<void>;
     /**
      * Signs out the current user.
      */
@@ -110,6 +124,11 @@ export declare class GraphKnowledgeAPI {
      * Call this before checking auth state if the API was just created.
      */
     waitForAuthInit(): Promise<void>;
+    /**
+     * Cleans up resources (auth state listeners).
+     * Call this when the API instance is no longer needed.
+     */
+    destroy(): void;
     /**
      * Checks if the current user has premium status.
      * @returns Promise resolving to true if user is premium

package/src/lib/graph-knowledge-api.js

@@ -11,12 +11,15 @@ const node_operations_1 = require("./operations/node-operations");
 const element_operations_1 = require("./operations/element-operations");
 const batch_operations_1 = require("./operations/batch-operations");
 const template_operations_1 = require("./operations/template-operations");
+const custom_shape_operations_1 = require("./operations/custom-shape-operations");
 const document_validator_1 = require("./validators/document-validator");
 const node_validator_1 = require("./validators/node-validator");
 const element_validator_registry_1 = require("./validators/element-validator-registry");
 const template_validator_1 = require("./validators/template-validator");
+const custom_shape_definition_validator_1 = require("./validators/custom-shape-definition-validator");
 const text_measurement_service_1 = require("./utils/text-measurement/text-measurement-service");
 const layout_helper_1 = require("./utils/layout/layout-helper");
+const element_builder_1 = require("./utils/element-builder");
 /**
  * Main entry point for the Graph Knowledge Headless API.
  *
@@ -62,6 +65,7 @@ class GraphKnowledgeAPI {
     _elements;
     _batch;
     _templates;
+    _customShapes;
     /**
      * Shared text measurement service for static and instance methods.
      */
@@ -86,12 +90,15 @@ class GraphKnowledgeAPI {
         const documentValidator = new document_validator_1.DocumentValidator();
         const nodeValidator = new node_validator_1.NodeValidator();
         const elementValidatorRegistry = new element_validator_registry_1.ElementValidatorRegistry();
+        // Create shared element builder (used by ElementOperations and NodeOperations)
+        const elementBuilder = new element_builder_1.ElementBuilder(elementValidatorRegistry, firestoreClient, this._authClient);
         // Create operations (dependency injection)
         this._documents = new document_operations_1.DocumentOperations(firestoreClient, this._authClient, documentValidator);
-        this._nodes = new node_operations_1.NodeOperations(firestoreClient, this._authClient, nodeValidator);
-        this._elements = new element_operations_1.ElementOperations(firestoreClient, this._authClient, elementValidatorRegistry);
-        this._batch = new batch_operations_1.BatchOperations(firestoreClient, this._authClient, elementValidatorRegistry);
+        this._nodes = new node_operations_1.NodeOperations(firestoreClient, this._authClient, nodeValidator, elementBuilder);
+        this._elements = new element_operations_1.ElementOperations(firestoreClient, this._authClient, elementBuilder);
+        this._batch = new batch_operations_1.BatchOperations(firestoreClient, this._authClient, elementBuilder);
         this._templates = new template_operations_1.TemplateOperations(firestoreClient, this._authClient, new template_validator_1.TemplateValidator());
+        this._customShapes = new custom_shape_operations_1.CustomShapeOperations(firestoreClient, this._authClient, new custom_shape_definition_validator_1.CustomShapeDefinitionValidator());
     }
     /**
      * Authentication client for sign-in/sign-out operations.
@@ -124,13 +131,21 @@ class GraphKnowledgeAPI {
         return this._batch;
     }
     /**
-     * Template operations (list, get, clone, publish, unpublish).
+     * Template operations (create, list, get, update, delete, clone, publish, unpublish).
      * Templates are documents that can be cloned by premium users.
-     * Admins can publish/unpublish templates to control visibility.
+     * Admins can create/update/delete and publish/unpublish templates.
      */
     get templates() {
         return this._templates;
     }
+    /**
+     * Custom shape operations (create, list, get, update, delete, publish, unpublish, listPublished, getPublished).
+     * Custom shapes are user-created SVG path-based shapes.
+     * Premium users can create and publish shapes to the public store.
+     */
+    get customShapes() {
+        return this._customShapes;
+    }
     // =========================================================================
     // Convenience methods delegating to authClient
     // =========================================================================
@@ -142,6 +157,14 @@ class GraphKnowledgeAPI {
     async signIn(email, password) {
         return this._authClient.signIn(email, password);
     }
+    /**
+     * Signs in with a Firebase custom token (for server-to-server auth).
+     * Used by remote MCP server to authenticate per-user sessions.
+     * @param token Custom token generated by Firebase Admin SDK
+     */
+    async signInWithCustomToken(token) {
+        return this._authClient.signInWithCustomToken(token);
+    }
     /**
      * Signs out the current user.
      */
@@ -161,6 +184,13 @@ class GraphKnowledgeAPI {
     async waitForAuthInit() {
         return this._authClient.waitForInit();
     }
+    /**
+     * Cleans up resources (auth state listeners).
+     * Call this when the API instance is no longer needed.
+     */
+    destroy() {
+        this._authClient.destroy();
+    }
     /**
      * Checks if the current user has premium status.
      * @returns Promise resolving to true if user is premium

package/src/lib/interfaces/auth-client.interface.d.ts

@@ -8,6 +8,11 @@ export interface IAuthClient {
      * @throws AuthenticationError if sign in fails
      */
     signIn(email: string, password: string): Promise<void>;
+    /**
+     * Signs in with a Firebase custom token (for server-to-server auth).
+     * @throws AuthenticationError if sign in fails
+     */
+    signInWithCustomToken(token: string): Promise<void>;
     /**
      * Signs out the current user.
      */
@@ -43,4 +48,9 @@ export interface IAuthClient {
      * @throws PermissionError if not admin
      */
     requireAdmin(): Promise<void>;
+    /**
+     * Cleans up resources (e.g., auth state listeners).
+     * Call this when the client is no longer needed.
+     */
+    destroy(): void;
 }

package/src/lib/interfaces/custom-shape-operations.interface.d.ts

@@ -0,0 +1,82 @@
+import { CreateCustomShapeInput, UpdateCustomShapeInput, CustomShapeResult } from "../types/api-types";
+/**
+ * Interface for custom shape operations.
+ *
+ * Custom shapes are user-created SVG path-based shapes stored in:
+ * - `/users/{uid}/customShapes/{shapeId}` (drafts)
+ * - `/shapeStore/{shapeId}` (published to public store)
+ */
+export interface ICustomShapeOperations {
+    /**
+     * Creates a new draft custom shape.
+     * Requires premium access.
+     *
+     * @param input Shape creation parameters
+     * @returns The newly created shape
+     * @throws AuthenticationError if not authenticated
+     * @throws PermissionError if not premium
+     */
+    create(input: CreateCustomShapeInput): Promise<CustomShapeResult>;
+    /**
+     * Lists all draft shapes for the current user.
+     * @returns Array of the user's draft shapes
+     * @throws AuthenticationError if not authenticated
+     */
+    list(): Promise<CustomShapeResult[]>;
+    /**
+     * Gets a specific draft shape by ID.
+     * @param shapeId The shape ID
+     * @returns The shape
+     * @throws AuthenticationError if not authenticated
+     * @throws NotFoundError if shape doesn't exist
+     */
+    get(shapeId: string): Promise<CustomShapeResult>;
+    /**
+     * Updates a draft shape.
+     * @param shapeId The shape ID
+     * @param input The fields to update
+     * @throws AuthenticationError if not authenticated
+     * @throws NotFoundError if shape doesn't exist
+     */
+    update(shapeId: string, input: UpdateCustomShapeInput): Promise<void>;
+    /**
+     * Deletes a draft shape.
+     * @param shapeId The shape ID
+     * @throws AuthenticationError if not authenticated
+     * @throws NotFoundError if shape doesn't exist
+     */
+    delete(shapeId: string): Promise<void>;
+    /**
+     * Publishes a draft shape to the public store.
+     * Requires premium access.
+     *
+     * @param shapeId The shape ID to publish
+     * @throws AuthenticationError if not authenticated
+     * @throws PermissionError if not premium
+     * @throws NotFoundError if shape doesn't exist
+     */
+    publish(shapeId: string): Promise<void>;
+    /**
+     * Unpublishes a shape from the public store.
+     * Reverts the draft to "draft" status.
+     *
+     * @param shapeId The shape ID to unpublish
+     * @throws AuthenticationError if not authenticated
+     * @throws NotFoundError if shape doesn't exist
+     */
+    unpublish(shapeId: string): Promise<void>;
+    /**
+     * Lists all published shapes in the public store.
+     * @returns Array of published shapes
+     * @throws AuthenticationError if not authenticated
+     */
+    listPublished(): Promise<CustomShapeResult[]>;
+    /**
+     * Gets a specific published shape from the store.
+     * @param shapeId The shape ID
+     * @returns The published shape
+     * @throws AuthenticationError if not authenticated
+     * @throws NotFoundError if shape doesn't exist in store
+     */
+    getPublished(shapeId: string): Promise<CustomShapeResult>;
+}

package/src/lib/interfaces/custom-shape-operations.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/lib/interfaces/node-operations.interface.d.ts

@@ -1,5 +1,5 @@
 import { GraphNode } from "../models";
-import { CreateNodeInput, UpdateNodeInput } from "../types/api-types";
+import { CreateNodeInput, UpdateNodeInput, CreateNodeWithElementsInput, CreateNodeWithElementsResult } from "../types/api-types";
 /**
  * Interface for node CRUD operations.
  */
@@ -59,4 +59,32 @@ export interface INodeOperations {
      * @throws AuthenticationError if not authenticated
      */
     delete(documentId: string, nodeId: string): Promise<void>;
+    /**
+     * Creates a new node with all its elements in a single atomic operation.
+     * All elements are validated before the node is created. If any element
+     * fails validation, no node or elements are created (all or nothing).
+     *
+     * @param documentId The parent document ID
+     * @param input Node creation parameters including elements array
+     * @returns The created node and all elements with their generated IDs
+     * @throws AuthenticationError if not authenticated
+     * @throws NotFoundError if document doesn't exist
+     * @throws ValidationError if node or any element input is invalid
+     *
+     * @example
+     * ```typescript
+     * const result = await api.nodes.createWithElements(docId, {
+     *     title: "Mars",
+     *     canvasWidth: 1920,
+     *     canvasHeight: 1080,
+     *     elements: [
+     *         { type: "rectangle", x: 100, y: 100, width: 200, height: 100 },
+     *         { type: "text", x: 150, y: 140, text: "Planet Mars" }
+     *     ]
+     * });
+     * // result.node — the created node
+     * // result.elements — array of created elements with IDs
+     * ```
+     */
+    createWithElements(documentId: string, input: CreateNodeWithElementsInput): Promise<CreateNodeWithElementsResult>;
 }

package/src/lib/interfaces/template-operations.interface.d.ts

@@ -1,4 +1,4 @@
-import { CreateTemplateInput, DocumentResult } from "../types/api-types";
+import { CreateTemplateInput, UpdateTemplateInput, DocumentResult } from "../types/api-types";
 /**
  * Interface for template operations.
  *
@@ -30,6 +30,27 @@ export interface ITemplateOperations {
      * @throws NotFoundError if template doesn't exist
      */
     get(templateId: string): Promise<DocumentResult>;
+    /**
+     * Updates a template's title and/or content.
+     * Requires admin access.
+     *
+     * @param templateId The template document ID
+     * @param input The fields to update
+     * @throws AuthenticationError if not authenticated
+     * @throws PermissionError if not admin
+     * @throws NotFoundError if template doesn't exist
+     */
+    update(templateId: string, input: UpdateTemplateInput): Promise<void>;
+    /**
+     * Deletes a template document.
+     * Requires admin access.
+     *
+     * @param templateId The template document ID
+     * @throws AuthenticationError if not authenticated
+     * @throws PermissionError if not admin
+     * @throws NotFoundError if template doesn't exist
+     */
+    delete(templateId: string): Promise<void>;
     /**
      * Clones a template into a new document owned by the current user.
      * Requires premium access.

package/src/lib/operations/batch-operations.d.ts

@@ -2,29 +2,17 @@ import { GraphElement } from "../models";
 import { IBatchOperations, BatchUpdateElementInput } from "../interfaces/batch-operations.interface";
 import { IFirestoreClient } from "../interfaces/firestore-client.interface";
 import { IAuthClient } from "../interfaces/auth-client.interface";
-import { IElementValidatorRegistry } from "../interfaces/element-validator.interface";
 import { AnyElementInput } from "../types/element-input-types";
+import { ElementBuilder } from "../utils/element-builder";
 /**
  * Implementation of batch element operations.
  */
 export declare class BatchOperations implements IBatchOperations {
     private readonly firestore;
     private readonly auth;
-    private readonly validatorRegistry;
-    constructor(firestore: IFirestoreClient, auth: IAuthClient, validatorRegistry: IElementValidatorRegistry);
+    private readonly elementBuilder;
+    constructor(firestore: IFirestoreClient, auth: IAuthClient, elementBuilder: ElementBuilder);
     createElements(documentId: string, nodeId: string, inputs: AnyElementInput[]): Promise<GraphElement[]>;
     updateElements(documentId: string, nodeId: string, updates: BatchUpdateElementInput[]): Promise<void>;
     deleteElements(documentId: string, nodeId: string, elementIds: string[]): Promise<void>;
-    /**
-     * Gets default dimensions for an element type.
-     */
-    private getDefaultDimensions;
-    /**
-     * Normalizes rotation to integer in range [0, 360).
-     */
-    private normalizeRotation;
-    /**
-     * Builds properties object from element input.
-     */
-    private buildProperties;
 }