@graph-knowledge/api 0.1.5 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph-knowledge/api",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "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

@@ -9,7 +9,7 @@ export type { IBatchOperations, BatchUpdateElementInput } from "./lib/interfaces
 export type { ITemplateOperations } from "./lib/interfaces/template-operations.interface";
 export type { IElementTypeValidator, IElementValidatorRegistry } from "./lib/interfaces/element-validator.interface";
 export type { CreateDocumentInput, UpdateDocumentInput, DocumentResult, CreateNodeInput, UpdateNodeInput, NodeResult } from "./lib/types/api-types";
-export type { BaseElementInput, RectangleInput, TextInput, ConnectorInput, ConnectorAnchor, LineStyle, MarkerType, UmlClassInput, UmlInterfaceInput, UmlComponentInput, UmlPackageInput, UmlArtifactInput, UmlNoteInput, CustomShapeInput, AnyElementInput, UpdateElementInput } from "./lib/types/element-input-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 { 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/constants/element-defaults.js

@@ -14,7 +14,13 @@ exports.DEFAULT_ELEMENT_DIMENSIONS = {
     "uml-component": { width: 150, height: 100 },
     "uml-package": { width: 200, height: 150 },
     "uml-artifact": { width: 100, height: 80 },
-    "uml-note": { width: 150, height: 100 }
+    "uml-note": { width: 150, height: 100 },
+    triangle: { width: 120, height: 100 },
+    diamond: { width: 100, height: 100 },
+    hexagon: { width: 120, height: 104 },
+    ellipse: { width: 150, height: 100 },
+    line: { width: 150, height: 0 },
+    "block-arrow": { width: 150, height: 80 }
 };
 /**
  * Default dimensions for custom shapes.

package/src/lib/types/element-input-types.d.ts

@@ -201,6 +201,84 @@ export interface UmlNoteInput extends BaseElementInput {
     /** Stroke width in pixels */
     strokeWidth?: number;
 }
+/**
+ * Input for creating a triangle element.
+ */
+export interface TriangleInput extends BaseElementInput {
+    type: "triangle";
+    /** Fill color (hex, e.g., "#FF5733") */
+    fillColor?: string;
+    /** Stroke color (hex) */
+    strokeColor?: string;
+    /** Stroke width in pixels */
+    strokeWidth?: number;
+}
+/**
+ * Input for creating a diamond element.
+ */
+export interface DiamondInput extends BaseElementInput {
+    type: "diamond";
+    /** Fill color (hex, e.g., "#FF5733") */
+    fillColor?: string;
+    /** Stroke color (hex) */
+    strokeColor?: string;
+    /** Stroke width in pixels */
+    strokeWidth?: number;
+}
+/**
+ * Input for creating a hexagon element.
+ */
+export interface HexagonInput extends BaseElementInput {
+    type: "hexagon";
+    /** Fill color (hex, e.g., "#FF5733") */
+    fillColor?: string;
+    /** Stroke color (hex) */
+    strokeColor?: string;
+    /** Stroke width in pixels */
+    strokeWidth?: number;
+}
+/**
+ * Input for creating an ellipse element.
+ */
+export interface EllipseInput extends BaseElementInput {
+    type: "ellipse";
+    /** Fill color (hex, e.g., "#FF5733") */
+    fillColor?: string;
+    /** Stroke color (hex) */
+    strokeColor?: string;
+    /** Stroke width in pixels */
+    strokeWidth?: number;
+}
+/**
+ * Input for creating a line element.
+ */
+export interface LineInput extends BaseElementInput {
+    type: "line";
+    /** Stroke color (hex) */
+    strokeColor?: string;
+    /** Stroke width in pixels */
+    strokeWidth?: number;
+    /** Line style (reuses LineStyle from connectors) */
+    lineStyle?: LineStyle;
+}
+/**
+ * Direction for block arrow elements.
+ */
+export type BlockArrowDirection = "right" | "left" | "up" | "down";
+/**
+ * Input for creating a block arrow element.
+ */
+export interface BlockArrowInput extends BaseElementInput {
+    type: "block-arrow";
+    /** Fill color (hex, e.g., "#FF5733") */
+    fillColor?: string;
+    /** Stroke color (hex) */
+    strokeColor?: string;
+    /** Stroke width in pixels */
+    strokeWidth?: number;
+    /** Arrow direction */
+    direction?: BlockArrowDirection;
+}
 /**
  * Input for creating a custom shape element.
  */
@@ -220,7 +298,7 @@ export interface CustomShapeInput extends BaseElementInput {
 /**
  * Union of all element input types.
  */
-export type AnyElementInput = RectangleInput | TextInput | ConnectorInput | UmlClassInput | UmlInterfaceInput | UmlComponentInput | UmlPackageInput | UmlArtifactInput | UmlNoteInput | CustomShapeInput;
+export type AnyElementInput = RectangleInput | TextInput | ConnectorInput | UmlClassInput | UmlInterfaceInput | UmlComponentInput | UmlPackageInput | UmlArtifactInput | UmlNoteInput | TriangleInput | DiamondInput | HexagonInput | EllipseInput | LineInput | BlockArrowInput | CustomShapeInput;
 /**
  * Input for updating an existing element.
  */

package/src/lib/validators/element-type-validators/basic-shape-validators.d.ts

@@ -0,0 +1,36 @@
+import { IElementTypeValidator } from "../../interfaces/element-validator.interface";
+import { AnyElementInput } from "../../types/element-input-types";
+import { BaseElementValidator } from "./base-element-validator";
+/**
+ * Base validator for basic shapes (triangle, diamond, hexagon, ellipse).
+ * All these shapes share the same properties: fillColor, strokeColor, strokeWidth.
+ */
+declare abstract class BasicShapeValidator extends BaseElementValidator implements IElementTypeValidator {
+    abstract readonly elementType: string;
+    validate(input: AnyElementInput): void;
+}
+/**
+ * Validator for triangle elements.
+ */
+export declare class TriangleValidator extends BasicShapeValidator {
+    readonly elementType = "triangle";
+}
+/**
+ * Validator for diamond elements.
+ */
+export declare class DiamondValidator extends BasicShapeValidator {
+    readonly elementType = "diamond";
+}
+/**
+ * Validator for hexagon elements.
+ */
+export declare class HexagonValidator extends BasicShapeValidator {
+    readonly elementType = "hexagon";
+}
+/**
+ * Validator for ellipse elements.
+ */
+export declare class EllipseValidator extends BasicShapeValidator {
+    readonly elementType = "ellipse";
+}
+export {};

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

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EllipseValidator = exports.HexagonValidator = exports.DiamondValidator = exports.TriangleValidator = void 0;
+const api_errors_1 = require("../../errors/api-errors");
+const base_element_validator_1 = require("./base-element-validator");
+/**
+ * Base validator for basic shapes (triangle, diamond, hexagon, ellipse).
+ * All these shapes share the same properties: fillColor, strokeColor, strokeWidth.
+ */
+class BasicShapeValidator extends base_element_validator_1.BaseElementValidator {
+    validate(input) {
+        if (input.type !== this.elementType) {
+            throw new api_errors_1.ValidationError(`Expected type "${this.elementType}", got "${input.type}"`, "type");
+        }
+        const shapeInput = input;
+        // Validate common properties
+        this.validateCommon(shapeInput);
+        // Validate shape-specific properties
+        this.validateColor(shapeInput.fillColor, "fillColor");
+        this.validateColor(shapeInput.strokeColor, "strokeColor");
+        this.validateStrokeWidth(shapeInput.strokeWidth, "strokeWidth");
+    }
+}
+/**
+ * Validator for triangle elements.
+ */
+class TriangleValidator extends BasicShapeValidator {
+    elementType = "triangle";
+}
+exports.TriangleValidator = TriangleValidator;
+/**
+ * Validator for diamond elements.
+ */
+class DiamondValidator extends BasicShapeValidator {
+    elementType = "diamond";
+}
+exports.DiamondValidator = DiamondValidator;
+/**
+ * Validator for hexagon elements.
+ */
+class HexagonValidator extends BasicShapeValidator {
+    elementType = "hexagon";
+}
+exports.HexagonValidator = HexagonValidator;
+/**
+ * Validator for ellipse elements.
+ */
+class EllipseValidator extends BasicShapeValidator {
+    elementType = "ellipse";
+}
+exports.EllipseValidator = EllipseValidator;

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

@@ -0,0 +1,11 @@
+import { IElementTypeValidator } from "../../interfaces/element-validator.interface";
+import { AnyElementInput } from "../../types/element-input-types";
+import { BaseElementValidator } from "./base-element-validator";
+/**
+ * Validator for block arrow elements.
+ */
+export declare class BlockArrowValidator extends BaseElementValidator implements IElementTypeValidator {
+    readonly elementType = "block-arrow";
+    validate(input: AnyElementInput): void;
+    private validateDirection;
+}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockArrowValidator = void 0;
+const api_errors_1 = require("../../errors/api-errors");
+const base_element_validator_1 = require("./base-element-validator");
+/**
+ * Validator for block arrow elements.
+ */
+class BlockArrowValidator extends base_element_validator_1.BaseElementValidator {
+    elementType = "block-arrow";
+    validate(input) {
+        if (input.type !== "block-arrow") {
+            throw new api_errors_1.ValidationError(`Expected type "block-arrow", got "${input.type}"`, "type");
+        }
+        const blockArrowInput = input;
+        // Validate common properties
+        this.validateCommon(blockArrowInput);
+        // Validate block-arrow-specific properties
+        this.validateColor(blockArrowInput.fillColor, "fillColor");
+        this.validateColor(blockArrowInput.strokeColor, "strokeColor");
+        this.validateStrokeWidth(blockArrowInput.strokeWidth, "strokeWidth");
+        this.validateDirection(blockArrowInput.direction);
+    }
+    validateDirection(value) {
+        if (value === undefined)
+            return;
+        if (typeof value !== "string") {
+            throw new api_errors_1.ValidationError("direction must be a string", "direction");
+        }
+        const validDirections = ["right", "left", "up", "down"];
+        if (!validDirections.includes(value)) {
+            throw new api_errors_1.ValidationError(`direction must be one of: ${validDirections.join(", ")}`, "direction");
+        }
+    }
+}
+exports.BlockArrowValidator = BlockArrowValidator;

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

@@ -0,0 +1,11 @@
+import { IElementTypeValidator } from "../../interfaces/element-validator.interface";
+import { AnyElementInput } from "../../types/element-input-types";
+import { BaseElementValidator } from "./base-element-validator";
+/**
+ * Validator for line elements.
+ */
+export declare class LineValidator extends BaseElementValidator implements IElementTypeValidator {
+    readonly elementType = "line";
+    validate(input: AnyElementInput): void;
+    private validateLineStyle;
+}

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

@@ -0,0 +1,35 @@
+"use strict";
+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");
+/**
+ * Validator for line elements.
+ */
+class LineValidator extends base_element_validator_1.BaseElementValidator {
+    elementType = "line";
+    validate(input) {
+        if (input.type !== "line") {
+            throw new api_errors_1.ValidationError(`Expected type "line", got "${input.type}"`, "type");
+        }
+        const lineInput = input;
+        // Validate common properties
+        this.validateCommon(lineInput);
+        // Validate line-specific properties
+        this.validateColor(lineInput.strokeColor, "strokeColor");
+        this.validateStrokeWidth(lineInput.strokeWidth, "strokeWidth");
+        this.validateLineStyle(lineInput.lineStyle);
+    }
+    validateLineStyle(value) {
+        if (value === undefined)
+            return;
+        if (typeof value !== "string") {
+            throw new api_errors_1.ValidationError("lineStyle must be a string", "lineStyle");
+        }
+        const validStyles = ["solid", "dashed", "dotted"];
+        if (!validStyles.includes(value)) {
+            throw new api_errors_1.ValidationError(`lineStyle must be one of: ${validStyles.join(", ")}`, "lineStyle");
+        }
+    }
+}
+exports.LineValidator = LineValidator;

package/src/lib/validators/element-validator-registry.js

@@ -6,6 +6,9 @@ const rectangle_validator_1 = require("./element-type-validators/rectangle-valid
 const text_validator_1 = require("./element-type-validators/text-validator");
 const connector_validator_1 = require("./element-type-validators/connector-validator");
 const uml_validators_1 = require("./element-type-validators/uml-validators");
+const basic_shape_validators_1 = require("./element-type-validators/basic-shape-validators");
+const line_validator_1 = require("./element-type-validators/line-validator");
+const block_arrow_validator_1 = require("./element-type-validators/block-arrow-validator");
 const custom_shape_validator_1 = require("./element-type-validators/custom-shape-validator");
 /**
  * Registry for element type validators.
@@ -31,6 +34,12 @@ class ElementValidatorRegistry {
         this.register(new uml_validators_1.UmlPackageValidator());
         this.register(new uml_validators_1.UmlArtifactValidator());
         this.register(new uml_validators_1.UmlNoteValidator());
+        this.register(new basic_shape_validators_1.TriangleValidator());
+        this.register(new basic_shape_validators_1.DiamondValidator());
+        this.register(new basic_shape_validators_1.HexagonValidator());
+        this.register(new basic_shape_validators_1.EllipseValidator());
+        this.register(new line_validator_1.LineValidator());
+        this.register(new block_arrow_validator_1.BlockArrowValidator());
     }
     register(validator) {
         this.validators.set(validator.elementType, validator);