@graph-knowledge/api 0.4.0 → 0.9.0

package/src/lib/utils/rotation.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeRotation = normalizeRotation;
+/**
+ * Normalizes rotation to integer in range [0, 360).
+ */
+function normalizeRotation(rotation) {
+    let normalized = rotation % 360;
+    if (normalized < 0) {
+        normalized += 360;
+    }
+    return Math.round(normalized);
+}

package/src/lib/validators/custom-shape-definition-validator.d.ts

@@ -0,0 +1,17 @@
+import { CreateCustomShapeInput, UpdateCustomShapeInput } from "../types/api-types";
+/**
+ * Validator for custom shape operations.
+ */
+export declare class CustomShapeDefinitionValidator {
+    /**
+     * Validates input for custom shape creation.
+     */
+    validateCreate(input: CreateCustomShapeInput): void;
+    /**
+     * Validates input for custom shape update.
+     */
+    validateUpdate(input: UpdateCustomShapeInput): void;
+    private _validateViewBox;
+    private _validateDimension;
+    private _validateDefaultProperties;
+}

package/src/lib/validators/custom-shape-definition-validator.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomShapeDefinitionValidator = void 0;
+const api_errors_1 = require("../errors/api-errors");
+/**
+ * Validator for custom shape operations.
+ */
+class CustomShapeDefinitionValidator {
+    /**
+     * Validates input for custom shape creation.
+     */
+    validateCreate(input) {
+        if (!input.name || typeof input.name !== "string") {
+            throw new api_errors_1.ValidationError("name is required", "name");
+        }
+        if (input.name.trim().length === 0) {
+            throw new api_errors_1.ValidationError("name cannot be empty", "name");
+        }
+        if (input.name.length > 100) {
+            throw new api_errors_1.ValidationError("name must be 100 characters or less", "name");
+        }
+        if (!input.svgPathData || typeof input.svgPathData !== "string") {
+            throw new api_errors_1.ValidationError("svgPathData is required", "svgPathData");
+        }
+        if (input.svgPathData.trim().length === 0) {
+            throw new api_errors_1.ValidationError("svgPathData cannot be empty", "svgPathData");
+        }
+        if (!input.viewBox) {
+            throw new api_errors_1.ValidationError("viewBox is required", "viewBox");
+        }
+        this._validateViewBox(input.viewBox);
+        if (input.description !== undefined && typeof input.description !== "string") {
+            throw new api_errors_1.ValidationError("description must be a string", "description");
+        }
+        if (input.icon !== undefined && typeof input.icon !== "string") {
+            throw new api_errors_1.ValidationError("icon must be a string", "icon");
+        }
+        if (input.category !== undefined && typeof input.category !== "string") {
+            throw new api_errors_1.ValidationError("category must be a string", "category");
+        }
+        this._validateDimension(input.defaultWidth, "defaultWidth");
+        this._validateDimension(input.defaultHeight, "defaultHeight");
+        if (input.aspectRatioLocked !== undefined && typeof input.aspectRatioLocked !== "boolean") {
+            throw new api_errors_1.ValidationError("aspectRatioLocked must be a boolean", "aspectRatioLocked");
+        }
+        if (input.defaultProperties !== undefined) {
+            this._validateDefaultProperties(input.defaultProperties);
+        }
+    }
+    /**
+     * Validates input for custom shape update.
+     */
+    validateUpdate(input) {
+        if (input.name !== undefined) {
+            if (typeof input.name !== "string") {
+                throw new api_errors_1.ValidationError("name must be a string", "name");
+            }
+            if (input.name.trim().length === 0) {
+                throw new api_errors_1.ValidationError("name cannot be empty", "name");
+            }
+            if (input.name.length > 100) {
+                throw new api_errors_1.ValidationError("name must be 100 characters or less", "name");
+            }
+        }
+        if (input.svgPathData !== undefined) {
+            if (typeof input.svgPathData !== "string") {
+                throw new api_errors_1.ValidationError("svgPathData must be a string", "svgPathData");
+            }
+            if (input.svgPathData.trim().length === 0) {
+                throw new api_errors_1.ValidationError("svgPathData cannot be empty", "svgPathData");
+            }
+        }
+        if (input.viewBox !== undefined) {
+            this._validateViewBox(input.viewBox);
+        }
+        if (input.description !== undefined && typeof input.description !== "string") {
+            throw new api_errors_1.ValidationError("description must be a string", "description");
+        }
+        if (input.icon !== undefined && typeof input.icon !== "string") {
+            throw new api_errors_1.ValidationError("icon must be a string", "icon");
+        }
+        if (input.category !== undefined && typeof input.category !== "string") {
+            throw new api_errors_1.ValidationError("category must be a string", "category");
+        }
+        this._validateDimension(input.defaultWidth, "defaultWidth");
+        this._validateDimension(input.defaultHeight, "defaultHeight");
+        if (input.aspectRatioLocked !== undefined && typeof input.aspectRatioLocked !== "boolean") {
+            throw new api_errors_1.ValidationError("aspectRatioLocked must be a boolean", "aspectRatioLocked");
+        }
+        if (input.defaultProperties !== undefined) {
+            this._validateDefaultProperties(input.defaultProperties);
+        }
+    }
+    _validateViewBox(viewBox) {
+        if (typeof viewBox.width !== "number" || viewBox.width <= 0) {
+            throw new api_errors_1.ValidationError("viewBox.width must be a positive number", "viewBox.width");
+        }
+        if (typeof viewBox.height !== "number" || viewBox.height <= 0) {
+            throw new api_errors_1.ValidationError("viewBox.height must be a positive number", "viewBox.height");
+        }
+        if (typeof viewBox.minX !== "number" || isNaN(viewBox.minX)) {
+            throw new api_errors_1.ValidationError("viewBox.minX must be a valid number", "viewBox.minX");
+        }
+        if (typeof viewBox.minY !== "number" || isNaN(viewBox.minY)) {
+            throw new api_errors_1.ValidationError("viewBox.minY must be a valid number", "viewBox.minY");
+        }
+    }
+    _validateDimension(value, field) {
+        if (value !== undefined) {
+            if (typeof value !== "number" || isNaN(value)) {
+                throw new api_errors_1.ValidationError(`${field} must be a valid number`, field);
+            }
+            if (value < 10 || value > 2000) {
+                throw new api_errors_1.ValidationError(`${field} must be between 10 and 2000`, field);
+            }
+        }
+    }
+    _validateDefaultProperties(props) {
+        if (props.fillColor !== undefined && typeof props.fillColor !== "string") {
+            throw new api_errors_1.ValidationError("defaultProperties.fillColor must be a string", "defaultProperties.fillColor");
+        }
+        if (props.strokeColor !== undefined && typeof props.strokeColor !== "string") {
+            throw new api_errors_1.ValidationError("defaultProperties.strokeColor must be a string", "defaultProperties.strokeColor");
+        }
+        if (props.strokeWidth !== undefined) {
+            if (typeof props.strokeWidth !== "number" || isNaN(props.strokeWidth)) {
+                throw new api_errors_1.ValidationError("defaultProperties.strokeWidth must be a valid number", "defaultProperties.strokeWidth");
+            }
+            if (props.strokeWidth < 0 || props.strokeWidth > 50) {
+                throw new api_errors_1.ValidationError("defaultProperties.strokeWidth must be between 0 and 50", "defaultProperties.strokeWidth");
+            }
+        }
+    }
+}
+exports.CustomShapeDefinitionValidator = CustomShapeDefinitionValidator;

package/src/lib/validators/element-type-validators/base-element-validator.d.ts

@@ -32,4 +32,8 @@ export declare abstract class BaseElementValidator {
      * Validates stroke width.
      */
     protected validateStrokeWidth(value: unknown, field: string): void;
+    /**
+     * Validates optional text label properties shared by basic shapes.
+     */
+    protected validateTextLabelProperties(input: Record<string, unknown>): void;
 }

package/src/lib/validators/element-type-validators/base-element-validator.js

@@ -96,5 +96,35 @@ class BaseElementValidator {
             throw new api_errors_1.ValidationError(`${field} must be non-negative`, field);
         }
     }
+    /**
+     * Validates optional text label properties shared by basic shapes.
+     */
+    validateTextLabelProperties(input) {
+        if (input["text"] !== undefined && typeof input["text"] !== "string") {
+            throw new api_errors_1.ValidationError("text must be a string", "text");
+        }
+        if (input["fontSize"] !== undefined) {
+            const fs = input["fontSize"];
+            if (typeof fs !== "number" || isNaN(fs)) {
+                throw new api_errors_1.ValidationError("fontSize must be a valid number", "fontSize");
+            }
+            if (fs < 1 || fs > 200) {
+                throw new api_errors_1.ValidationError("fontSize must be between 1 and 200", "fontSize");
+            }
+        }
+        this.validateColor(input["textColor"], "textColor");
+        if (input["textAlign"] !== undefined) {
+            const valid = ["left", "center", "right"];
+            if (!valid.includes(input["textAlign"])) {
+                throw new api_errors_1.ValidationError(`textAlign must be one of: ${valid.join(", ")}`, "textAlign");
+            }
+        }
+        if (input["verticalAlign"] !== undefined) {
+            const valid = ["top", "middle", "bottom"];
+            if (!valid.includes(input["verticalAlign"])) {
+                throw new api_errors_1.ValidationError(`verticalAlign must be one of: ${valid.join(", ")}`, "verticalAlign");
+            }
+        }
+    }
 }
 exports.BaseElementValidator = BaseElementValidator;

package/src/lib/validators/element-type-validators/basic-shape-validators.js

@@ -19,6 +19,8 @@ class BasicShapeValidator extends base_element_validator_1.BaseElementValidator
         this.validateColor(shapeInput.fillColor, "fillColor");
         this.validateColor(shapeInput.strokeColor, "strokeColor");
         this.validateStrokeWidth(shapeInput.strokeWidth, "strokeWidth");
+        // Validate text label properties
+        this.validateTextLabelProperties(shapeInput);
     }
 }
 /**

package/src/lib/validators/element-type-validators/block-arrow-validator.js

@@ -20,6 +20,8 @@ class BlockArrowValidator extends base_element_validator_1.BaseElementValidator
         this.validateColor(blockArrowInput.strokeColor, "strokeColor");
         this.validateStrokeWidth(blockArrowInput.strokeWidth, "strokeWidth");
         this.validateDirection(blockArrowInput.direction);
+        // Validate text label properties
+        this.validateTextLabelProperties(blockArrowInput);
     }
     validateDirection(value) {
         if (value === undefined)

package/src/lib/validators/element-type-validators/line-validator.d.ts

@@ -8,4 +8,5 @@ export declare class LineValidator extends BaseElementValidator implements IElem
     readonly elementType = "line";
     validate(input: AnyElementInput): void;
     private validateLineStyle;
+    private validateMarker;
 }

package/src/lib/validators/element-type-validators/line-validator.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LineValidator = void 0;
 const api_errors_1 = require("../../errors/api-errors");
 const base_element_validator_1 = require("./base-element-validator");
+const VALID_LINE_STYLES = ["solid", "dashed", "dotted"];
+const VALID_MARKERS = ["none", "arrow", "diamond", "circle"];
 /**
  * Validator for line elements.
  */
@@ -19,16 +21,21 @@ class LineValidator extends base_element_validator_1.BaseElementValidator {
         this.validateColor(lineInput.strokeColor, "strokeColor");
         this.validateStrokeWidth(lineInput.strokeWidth, "strokeWidth");
         this.validateLineStyle(lineInput.lineStyle);
+        this.validateMarker(lineInput.startMarker, "startMarker");
+        this.validateMarker(lineInput.endMarker, "endMarker");
     }
     validateLineStyle(value) {
         if (value === undefined)
             return;
-        if (typeof value !== "string") {
-            throw new api_errors_1.ValidationError("lineStyle must be a string", "lineStyle");
+        if (!VALID_LINE_STYLES.includes(value)) {
+            throw new api_errors_1.ValidationError(`lineStyle must be one of: ${VALID_LINE_STYLES.join(", ")}`, "lineStyle");
         }
-        const validStyles = ["solid", "dashed", "dotted"];
-        if (!validStyles.includes(value)) {
-            throw new api_errors_1.ValidationError(`lineStyle must be one of: ${validStyles.join(", ")}`, "lineStyle");
+    }
+    validateMarker(value, field) {
+        if (value === undefined)
+            return;
+        if (!VALID_MARKERS.includes(value)) {
+            throw new api_errors_1.ValidationError(`${field} must be one of: ${VALID_MARKERS.join(", ")}`, field);
         }
     }
 }

package/src/lib/validators/element-type-validators/rectangle-validator.js

@@ -20,6 +20,8 @@ class RectangleValidator extends base_element_validator_1.BaseElementValidator {
         this.validateColor(rectangleInput.strokeColor, "strokeColor");
         this.validateStrokeWidth(rectangleInput.strokeWidth, "strokeWidth");
         this.validateCornerRadius(rectangleInput.cornerRadius);
+        // Validate text label properties
+        this.validateTextLabelProperties(rectangleInput);
     }
     validateCornerRadius(value) {
         if (value === undefined)

package/src/lib/validators/template-validator.d.ts

@@ -1,4 +1,4 @@
-import { CreateTemplateInput } from "../types/api-types";
+import { CreateTemplateInput, UpdateTemplateInput } from "../types/api-types";
 /**
  * Validator for template operations.
  */
@@ -9,6 +9,12 @@ export declare class TemplateValidator {
      * @throws ValidationError if validation fails
      */
     validateCreate(input: CreateTemplateInput): void;
+    /**
+     * Validates input for template update.
+     * @param input The update input to validate
+     * @throws ValidationError if validation fails
+     */
+    validateUpdate(input: UpdateTemplateInput): void;
     /**
      * Validates canvas dimensions.
      */

package/src/lib/validators/template-validator.js

@@ -26,6 +26,27 @@ class TemplateValidator {
         }
         this.validateCanvasDimensions(input.canvasWidth, input.canvasHeight);
     }
+    /**
+     * Validates input for template update.
+     * @param input The update input to validate
+     * @throws ValidationError if validation fails
+     */
+    validateUpdate(input) {
+        if (input.title !== undefined) {
+            if (typeof input.title !== "string") {
+                throw new api_errors_1.ValidationError("title must be a string", "title");
+            }
+            if (input.title.trim().length === 0) {
+                throw new api_errors_1.ValidationError("title cannot be empty", "title");
+            }
+            if (input.title.length > 200) {
+                throw new api_errors_1.ValidationError("title must be 200 characters or less", "title");
+            }
+        }
+        if (input.content !== undefined && typeof input.content !== "string") {
+            throw new api_errors_1.ValidationError("content must be a string", "content");
+        }
+    }
     /**
      * Validates canvas dimensions.
      */