driftdetect-galaxy 0.4.2

package/dist/types/index.d.ts

@@ -0,0 +1,337 @@
+/**
+ * Galaxy Visualization Types
+ *
+ * Core type definitions for the 3D database galaxy visualization.
+ * All types are immutable and follow strict typing conventions.
+ */
+/**
+ * Data sensitivity classification levels
+ */
+export type SensitivityLevel = 'critical' | 'high' | 'medium' | 'low' | 'public';
+/**
+ * Security priority tiers (P0 = most critical)
+ */
+export type SecurityTier = 'P0' | 'P1' | 'P2' | 'P3' | 'P4';
+/**
+ * Data operation types
+ */
+export type DataOperation = 'read' | 'write' | 'delete' | 'unknown';
+/**
+ * Authentication level for entry points
+ */
+export type AuthLevel = 'public' | 'authenticated' | 'admin' | 'internal';
+/**
+ * A database table represented as a planet in the galaxy
+ */
+export interface TableNode {
+    /** Unique identifier */
+    readonly id: string;
+    /** Table name */
+    readonly name: string;
+    /** Schema/database name if applicable */
+    readonly schema?: string;
+    /** Estimated row count (affects size) */
+    readonly rowCount: number;
+    /** Access frequency (affects importance) */
+    readonly accessCount: number;
+    /** Highest sensitivity level of any field */
+    readonly sensitivity: SensitivityLevel;
+    /** Security tier based on data exposure */
+    readonly securityTier: SecurityTier;
+    /** Fields in this table */
+    readonly fields: readonly FieldNode[];
+    /** 3D position in galaxy (computed by layout engine) */
+    position?: Vector3D;
+    /** Domain cluster this table belongs to */
+    readonly cluster?: string;
+}
+/**
+ * A database field represented as a moon orbiting a table
+ */
+export interface FieldNode {
+    /** Unique identifier */
+    readonly id: string;
+    /** Field/column name */
+    readonly name: string;
+    /** Parent table ID */
+    readonly tableId: string;
+    /** Data type */
+    readonly dataType: string;
+    /** Sensitivity classification */
+    readonly sensitivity: SensitivityLevel;
+    /** Is this a primary key */
+    readonly isPrimaryKey: boolean;
+    /** Is this a foreign key */
+    readonly isForeignKey: boolean;
+    /** Foreign key target if applicable */
+    readonly foreignKeyTarget?: string;
+    /** Access count for this specific field */
+    readonly accessCount: number;
+    /** Is this field tested */
+    readonly isTested: boolean;
+}
+/**
+ * An API entry point represented as a space station
+ */
+export interface EntryPointNode {
+    /** Unique identifier */
+    readonly id: string;
+    /** Route path (e.g., /api/users) */
+    readonly path: string;
+    /** HTTP method */
+    readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'ALL';
+    /** Authentication level required */
+    readonly authLevel: AuthLevel;
+    /** Security tier */
+    readonly securityTier: SecurityTier;
+    /** Source file */
+    readonly file: string;
+    /** Line number */
+    readonly line: number;
+    /** Framework (Express, FastAPI, etc.) */
+    readonly framework: string;
+    /** Tables this entry point can reach */
+    readonly reachableTables: readonly string[];
+    /** 3D position (computed) */
+    position?: Vector3D;
+}
+/**
+ * A code function that accesses data
+ */
+export interface FunctionNode {
+    /** Unique identifier */
+    readonly id: string;
+    /** Function name */
+    readonly name: string;
+    /** Qualified name (Class.method) */
+    readonly qualifiedName: string;
+    /** Source file */
+    readonly file: string;
+    /** Line number */
+    readonly line: number;
+    /** Tables this function accesses directly */
+    readonly directAccess: readonly string[];
+    /** Is this function tested */
+    readonly isTested: boolean;
+}
+/**
+ * A data access path (hyperspace lane) connecting entry points to tables
+ */
+export interface DataPath {
+    /** Unique identifier */
+    readonly id: string;
+    /** Source node (entry point or function) */
+    readonly sourceId: string;
+    /** Source type */
+    readonly sourceType: 'entryPoint' | 'function';
+    /** Target table */
+    readonly targetTableId: string;
+    /** Target field (optional, for field-level access) */
+    readonly targetFieldId?: string;
+    /** Operation type */
+    readonly operation: DataOperation;
+    /** Access frequency */
+    readonly frequency: number;
+    /** Call chain depth */
+    readonly depth: number;
+    /** Is this path tested */
+    readonly isTested: boolean;
+    /** Intermediate functions in the path */
+    readonly callChain: readonly string[];
+    /** Sensitivity of data accessed */
+    readonly sensitivity: SensitivityLevel;
+}
+/**
+ * A foreign key relationship between tables
+ */
+export interface TableRelationship {
+    /** Unique identifier */
+    readonly id: string;
+    /** Source table */
+    readonly sourceTableId: string;
+    /** Source field */
+    readonly sourceFieldId: string;
+    /** Target table */
+    readonly targetTableId: string;
+    /** Target field */
+    readonly targetFieldId: string;
+    /** Relationship type */
+    readonly type: 'one-to-one' | 'one-to-many' | 'many-to-many';
+}
+/**
+ * Complete galaxy data model
+ */
+export interface GalaxyData {
+    /** All tables (planets) */
+    readonly tables: readonly TableNode[];
+    /** All entry points (space stations) */
+    readonly entryPoints: readonly EntryPointNode[];
+    /** All data access paths (hyperspace lanes) */
+    readonly dataPaths: readonly DataPath[];
+    /** Table relationships (gravitational links) */
+    readonly relationships: readonly TableRelationship[];
+    /** Statistics */
+    readonly stats: GalaxyStats;
+    /** Last updated timestamp */
+    readonly lastUpdated: string;
+}
+/**
+ * Galaxy statistics
+ */
+export interface GalaxyStats {
+    /** Total tables */
+    readonly tableCount: number;
+    /** Total fields */
+    readonly fieldCount: number;
+    /** Total entry points */
+    readonly entryPointCount: number;
+    /** Total data paths */
+    readonly pathCount: number;
+    /** Sensitive field count by level */
+    readonly sensitiveFields: Record<SensitivityLevel, number>;
+    /** Untested paths count */
+    readonly untestedPaths: number;
+    /** Dead code functions */
+    readonly deadCodeCount: number;
+    /** Health score (0-100) */
+    readonly healthScore: number;
+}
+/**
+ * 3D vector for positions
+ */
+export interface Vector3D {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+}
+/**
+ * Camera state
+ */
+export interface CameraState {
+    /** Camera position */
+    readonly position: Vector3D;
+    /** Look-at target */
+    readonly target: Vector3D;
+    /** Zoom level (1 = default) */
+    readonly zoom: number;
+}
+/**
+ * Selection state
+ */
+export interface SelectionState {
+    /** Selected table ID */
+    readonly selectedTable: string | null;
+    /** Selected field ID */
+    readonly selectedField: string | null;
+    /** Selected entry point ID */
+    readonly selectedEntryPoint: string | null;
+    /** Selected data path ID */
+    readonly selectedPath: string | null;
+    /** Hovered node ID */
+    readonly hoveredNode: string | null;
+    /** Hovered node type */
+    readonly hoveredType: 'table' | 'field' | 'entryPoint' | 'path' | null;
+}
+/**
+ * View mode for the galaxy
+ */
+export type ViewMode = 'overview' | 'security' | 'coverage' | 'blast-radius' | 'timeline';
+/**
+ * Filter state
+ */
+export interface FilterState {
+    /** Show only tables with this sensitivity or higher */
+    readonly minSensitivity: SensitivityLevel | null;
+    /** Show only paths with this operation */
+    readonly operationType: DataOperation | null;
+    /** Show only untested paths */
+    readonly untestedOnly: boolean;
+    /** Show only public entry points */
+    readonly publicOnly: boolean;
+    /** Search query */
+    readonly searchQuery: string;
+    /** Selected clusters */
+    readonly clusters: readonly string[];
+}
+/**
+ * Display settings
+ */
+export interface DisplaySettings {
+    /** Show field moons */
+    readonly showFields: boolean;
+    /** Show data paths */
+    readonly showPaths: boolean;
+    /** Show relationships */
+    readonly showRelationships: boolean;
+    /** Show labels */
+    readonly showLabels: boolean;
+    /** Enable bloom effect */
+    readonly enableBloom: boolean;
+    /** Animation speed (0-1) */
+    readonly animationSpeed: number;
+    /** Path opacity (0-1) */
+    readonly pathOpacity: number;
+}
+/**
+ * Real-time access event
+ */
+export interface AccessEvent {
+    /** Event ID */
+    readonly id: string;
+    /** Timestamp */
+    readonly timestamp: string;
+    /** Table accessed */
+    readonly tableId: string;
+    /** Field accessed (optional) */
+    readonly fieldId?: string;
+    /** Operation type */
+    readonly operation: DataOperation;
+    /** Source entry point */
+    readonly entryPointId?: string;
+    /** Source file */
+    readonly sourceFile: string;
+    /** Source line */
+    readonly sourceLine: number;
+}
+/**
+ * Galaxy event for animations/effects
+ */
+export interface GalaxyEvent {
+    /** Event type */
+    readonly type: 'access' | 'violation' | 'alert';
+    /** Target node ID */
+    readonly targetId: string;
+    /** Event data */
+    readonly data: AccessEvent | ViolationEvent | AlertEvent;
+    /** Timestamp */
+    readonly timestamp: string;
+}
+/**
+ * Violation event
+ */
+export interface ViolationEvent {
+    /** Violation ID */
+    readonly id: string;
+    /** Severity */
+    readonly severity: 'critical' | 'high' | 'medium' | 'low';
+    /** Message */
+    readonly message: string;
+    /** Affected table */
+    readonly tableId: string;
+    /** Affected path */
+    readonly pathId?: string;
+}
+/**
+ * Alert event
+ */
+export interface AlertEvent {
+    /** Alert ID */
+    readonly id: string;
+    /** Alert type */
+    readonly type: 'security' | 'coverage' | 'drift';
+    /** Message */
+    readonly message: string;
+    /** Affected nodes */
+    readonly affectedNodes: readonly string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,MAAM,GACN,QAAQ,GACR,KAAK,GACL,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,eAAe,GAAG,OAAO,GAAG,UAAU,CAAC;AAM1E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrE,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,UAAU,CAAC;IAC/C,mBAAmB;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mBAAmB;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mBAAmB;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mBAAmB;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;CAC9D;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC3D,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAMD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,wBAAwB;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,8BAA8B;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,wBAAwB;IACxB,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,UAAU,GACV,UAAU,GACV,cAAc,GACd,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjD,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,mBAAmB;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yBAAyB;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,yBAAyB;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IAChD,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,UAAU,CAAC;IACzD,gBAAgB;IAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1D,cAAc;IACd,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oBAAoB;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,eAAe;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IACjD,cAAc;IACd,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Galaxy Visualization Types
+ *
+ * Core type definitions for the 3D database galaxy visualization.
+ * All types are immutable and follow strict typing conventions.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/color-utils.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Color Utilities
+ *
+ * Color manipulation and mapping functions for galaxy visualization.
+ */
+import * as THREE from 'three';
+import type { SensitivityLevel, SecurityTier, AuthLevel, DataOperation } from '../types/index.js';
+/**
+ * Convert hex color to THREE.Color
+ */
+export declare function hexToThreeColor(hex: string): THREE.Color;
+/**
+ * Convert hex to RGB object
+ */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+};
+/**
+ * Interpolate between two colors
+ */
+export declare function lerpColor(color1: string, color2: string, t: number): string;
+/**
+ * Brighten a color
+ */
+export declare function brightenColor(hex: string, factor: number): string;
+/**
+ * Darken a color
+ */
+export declare function darkenColor(hex: string, factor: number): string;
+/**
+ * Get color for sensitivity level
+ */
+export declare function getSensitivityColor(level: SensitivityLevel): string;
+/**
+ * Get THREE.Color for sensitivity level
+ */
+export declare function getSensitivityThreeColor(level: SensitivityLevel): THREE.Color;
+/**
+ * Get emissive intensity for sensitivity level
+ */
+export declare function getSensitivityEmissive(level: SensitivityLevel): number;
+/**
+ * Get sensitivity level from numeric score (0-100)
+ */
+export declare function scoreToSensitivity(score: number): SensitivityLevel;
+/**
+ * Get color for security tier
+ */
+export declare function getSecurityTierColor(tier: SecurityTier): string;
+/**
+ * Get THREE.Color for security tier
+ */
+export declare function getSecurityTierThreeColor(tier: SecurityTier): THREE.Color;
+/**
+ * Get color for auth level
+ */
+export declare function getAuthLevelColor(level: AuthLevel): string;
+/**
+ * Get THREE.Color for auth level
+ */
+export declare function getAuthLevelThreeColor(level: AuthLevel): THREE.Color;
+/**
+ * Get color for data operation
+ */
+export declare function getOperationColor(operation: DataOperation): string;
+/**
+ * Get THREE.Color for data operation
+ */
+export declare function getOperationThreeColor(operation: DataOperation): THREE.Color;
+/**
+ * Get color for cluster
+ */
+export declare function getClusterColor(cluster: string): string;
+/**
+ * Get THREE.Color for cluster
+ */
+export declare function getClusterThreeColor(cluster: string): THREE.Color;
+/**
+ * Generate a gradient texture for paths
+ */
+export declare function createGradientTexture(color1: string, color2: string, width?: number): THREE.DataTexture;
+/**
+ * Calculate pulse color based on time
+ */
+export declare function getPulseColor(baseColor: string, time: number, frequency?: number, intensity?: number): string;
+/**
+ * Calculate pulse opacity based on time
+ */
+export declare function getPulseOpacity(baseOpacity: number, time: number, frequency?: number, range?: number): number;
+/**
+ * Get color for health score (0-100)
+ */
+export declare function getHealthScoreColor(score: number): string;
+/**
+ * Get THREE.Color for health score
+ */
+export declare function getHealthScoreThreeColor(score: number): THREE.Color;
+//# sourceMappingURL=color-utils.d.ts.map

package/dist/utils/color-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.d.ts","sourceRoot":"","sources":["../../src/utils/color-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAclG;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAUzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO/D;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAE7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAMlE;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,GAAG,KAAK,CAAC,KAAK,CAEzE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAAC,KAAK,CAEpE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,aAAa,GAAG,KAAK,CAAC,KAAK,CAE5E;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAEjE;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAY,GAClB,KAAK,CAAC,WAAW,CAkBnB;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAY,GACtB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAU,EACrB,KAAK,GAAE,MAAY,GAClB,MAAM,CAGR;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAEnE"}

package/dist/utils/color-utils.js

@@ -0,0 +1,217 @@
+/**
+ * Color Utilities
+ *
+ * Color manipulation and mapping functions for galaxy visualization.
+ */
+import * as THREE from 'three';
+import { SENSITIVITY_COLORS, SENSITIVITY_EMISSIVE, SECURITY_TIER_COLORS, AUTH_LEVEL_COLORS, OPERATION_COLORS, CLUSTER_COLORS, } from '../constants/index.js';
+// ============================================================================
+// Color Conversion
+// ============================================================================
+/**
+ * Convert hex color to THREE.Color
+ */
+export function hexToThreeColor(hex) {
+    return new THREE.Color(hex);
+}
+/**
+ * Convert hex to RGB object
+ */
+export function hexToRgb(hex) {
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    if (!result || !result[1] || !result[2] || !result[3]) {
+        return { r: 0, g: 0, b: 0 };
+    }
+    return {
+        r: parseInt(result[1], 16) / 255,
+        g: parseInt(result[2], 16) / 255,
+        b: parseInt(result[3], 16) / 255,
+    };
+}
+/**
+ * Interpolate between two colors
+ */
+export function lerpColor(color1, color2, t) {
+    const c1 = hexToRgb(color1);
+    const c2 = hexToRgb(color2);
+    const r = Math.round((c1.r + (c2.r - c1.r) * t) * 255);
+    const g = Math.round((c1.g + (c2.g - c1.g) * t) * 255);
+    const b = Math.round((c1.b + (c2.b - c1.b) * t) * 255);
+    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+}
+/**
+ * Brighten a color
+ */
+export function brightenColor(hex, factor) {
+    const rgb = hexToRgb(hex);
+    const r = Math.min(255, Math.round(rgb.r * 255 * (1 + factor)));
+    const g = Math.min(255, Math.round(rgb.g * 255 * (1 + factor)));
+    const b = Math.min(255, Math.round(rgb.b * 255 * (1 + factor)));
+    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+}
+/**
+ * Darken a color
+ */
+export function darkenColor(hex, factor) {
+    const rgb = hexToRgb(hex);
+    const r = Math.max(0, Math.round(rgb.r * 255 * (1 - factor)));
+    const g = Math.max(0, Math.round(rgb.g * 255 * (1 - factor)));
+    const b = Math.max(0, Math.round(rgb.b * 255 * (1 - factor)));
+    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+}
+// ============================================================================
+// Sensitivity Colors
+// ============================================================================
+/**
+ * Get color for sensitivity level
+ */
+export function getSensitivityColor(level) {
+    return SENSITIVITY_COLORS[level];
+}
+/**
+ * Get THREE.Color for sensitivity level
+ */
+export function getSensitivityThreeColor(level) {
+    return hexToThreeColor(SENSITIVITY_COLORS[level]);
+}
+/**
+ * Get emissive intensity for sensitivity level
+ */
+export function getSensitivityEmissive(level) {
+    return SENSITIVITY_EMISSIVE[level];
+}
+/**
+ * Get sensitivity level from numeric score (0-100)
+ */
+export function scoreToSensitivity(score) {
+    if (score >= 90)
+        return 'critical';
+    if (score >= 70)
+        return 'high';
+    if (score >= 50)
+        return 'medium';
+    if (score >= 20)
+        return 'low';
+    return 'public';
+}
+// ============================================================================
+// Security Colors
+// ============================================================================
+/**
+ * Get color for security tier
+ */
+export function getSecurityTierColor(tier) {
+    return SECURITY_TIER_COLORS[tier];
+}
+/**
+ * Get THREE.Color for security tier
+ */
+export function getSecurityTierThreeColor(tier) {
+    return hexToThreeColor(SECURITY_TIER_COLORS[tier]);
+}
+// ============================================================================
+// Auth Level Colors
+// ============================================================================
+/**
+ * Get color for auth level
+ */
+export function getAuthLevelColor(level) {
+    return AUTH_LEVEL_COLORS[level];
+}
+/**
+ * Get THREE.Color for auth level
+ */
+export function getAuthLevelThreeColor(level) {
+    return hexToThreeColor(AUTH_LEVEL_COLORS[level]);
+}
+// ============================================================================
+// Operation Colors
+// ============================================================================
+/**
+ * Get color for data operation
+ */
+export function getOperationColor(operation) {
+    return OPERATION_COLORS[operation];
+}
+/**
+ * Get THREE.Color for data operation
+ */
+export function getOperationThreeColor(operation) {
+    return hexToThreeColor(OPERATION_COLORS[operation]);
+}
+// ============================================================================
+// Cluster Colors
+// ============================================================================
+/**
+ * Get color for cluster
+ */
+export function getClusterColor(cluster) {
+    return CLUSTER_COLORS[cluster] ?? CLUSTER_COLORS['other'] ?? '#7f8c8d';
+}
+/**
+ * Get THREE.Color for cluster
+ */
+export function getClusterThreeColor(cluster) {
+    return hexToThreeColor(getClusterColor(cluster));
+}
+// ============================================================================
+// Gradient Generation
+// ============================================================================
+/**
+ * Generate a gradient texture for paths
+ */
+export function createGradientTexture(color1, color2, width = 256) {
+    const data = new Uint8Array(width * 4);
+    const c1 = hexToRgb(color1);
+    const c2 = hexToRgb(color2);
+    for (let i = 0; i < width; i++) {
+        const t = i / (width - 1);
+        const idx = i * 4;
+        data[idx] = Math.round((c1.r + (c2.r - c1.r) * t) * 255);
+        data[idx + 1] = Math.round((c1.g + (c2.g - c1.g) * t) * 255);
+        data[idx + 2] = Math.round((c1.b + (c2.b - c1.b) * t) * 255);
+        data[idx + 3] = 255;
+    }
+    const texture = new THREE.DataTexture(data, width, 1, THREE.RGBAFormat);
+    texture.needsUpdate = true;
+    return texture;
+}
+// ============================================================================
+// Pulse Effect Colors
+// ============================================================================
+/**
+ * Calculate pulse color based on time
+ */
+export function getPulseColor(baseColor, time, frequency = 2, intensity = 0.3) {
+    const pulse = (Math.sin(time * frequency * Math.PI * 2) + 1) / 2;
+    return brightenColor(baseColor, pulse * intensity);
+}
+/**
+ * Calculate pulse opacity based on time
+ */
+export function getPulseOpacity(baseOpacity, time, frequency = 2, range = 0.3) {
+    const pulse = (Math.sin(time * frequency * Math.PI * 2) + 1) / 2;
+    return baseOpacity + pulse * range;
+}
+// ============================================================================
+// Health Score Colors
+// ============================================================================
+/**
+ * Get color for health score (0-100)
+ */
+export function getHealthScoreColor(score) {
+    if (score >= 80)
+        return '#22c55e'; // Green
+    if (score >= 60)
+        return '#eab308'; // Yellow
+    if (score >= 40)
+        return '#f97316'; // Orange
+    return '#ef4444'; // Red
+}
+/**
+ * Get THREE.Color for health score
+ */
+export function getHealthScoreThreeColor(score) {
+    return hexToThreeColor(getHealthScoreColor(score));
+}
+//# sourceMappingURL=color-utils.js.map