@imayuur/contexthub-shared-types 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+export interface Session {
+    id: string;
+    repoPath: string;
+    startTime: number;
+    endTime?: number;
+    agent: string;
+    metadata: Record<string, any>;
+}
+export interface MemoryEntry {
+    id: string;
+    sessionId: string;
+    type: 'prompt' | 'response' | 'summary' | 'decision' | 'architecture' | 'bugfix' | 'manual' | 'commit';
+    content: string;
+    timestamp: number;
+    tags: string[];
+    embedding?: number[];
+    /**
+     * Up to 20 paths related to this memory.
+     * Path should be repository-relative and validated.
+     */
+    relatedPaths?: string[];
+    /**
+     * Up to 20 symbol names (functions, classes, etc.) related to this memory.
+     * Names will be sanitized and capped at 200 characters each.
+     */
+    relatedSymbols?: string[];
+    /**
+     * Git commit hash associated with this memory (7-40 hex chars).
+     */
+    commitHash?: string;
+    /**
+     * Git branch associated with this memory.
+     */
+    branch?: string;
+}
+export interface ProjectMetadata {
+    repoPath: string;
+    name: string;
+    description?: string;
+    language?: string;
+    framework?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface VectorSearchResult {
+    id: string;
+    score: number;
+    metadata: MemoryEntry;
+}
+export interface KnowledgeGraphNode {
+    id: string;
+    type: 'file' | 'function' | 'class' | 'variable' | 'import';
+    label: string;
+    properties: Record<string, any>;
+}
+export interface KnowledgeGraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    type: 'calls' | 'imports' | 'contains' | 'references';
+    properties: Record<string, any>;
+}
+export interface ParsedFile {
+    path: string;
+    language: string;
+    symbols: Symbol[];
+    imports: ImportExport[];
+    exports: ImportExport[];
+}
+export interface Symbol {
+    type: 'function' | 'class' | 'variable' | 'interface' | 'method';
+    name: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+export interface ImportExport {
+    source: string;
+    imported: string[];
+    isDefault: boolean;
+    lineNumber: number;
+}
+export declare const VALID_MEMORY_TYPES: readonly ["prompt", "response", "summary", "decision", "architecture", "bugfix", "manual", "commit"];
+export type MemoryType = typeof VALID_MEMORY_TYPES[number];
+export interface SecurityConfig {
+    /** Whether encryption at rest is enabled (default: true) */
+    encryptionEnabled: boolean;
+    /** Max memory entries before archival (default: 10000) */
+    maxMemoryEntries: number;
+    /** Max input length in characters (default: 51200) */
+    maxInputLength: number;
+    /** Max file size to read in bytes (default: 50MB) */
+    maxFileSizeBytes: number;
+    /** Whether auth token is required for MCP (default: false, auto-enabled if CONTEXTHUB_TOKEN is set) */
+    authRequired: boolean;
+}
+export interface CodeGraphNode {
+    id: string;
+    kind: 'file' | 'symbol';
+    path: string;
+    name?: string;
+    lang?: string;
+}
+export interface CodeGraphEdge {
+    from: string;
+    to: string;
+    kind: 'imports' | 'calls' | 'contains';
+}
+export interface CodeGraph {
+    version: string;
+    updatedAt: number;
+    nodes: CodeGraphNode[];
+    edges: CodeGraphEdge[];
+}
+export interface GraphDiff {
+    addedNodes: CodeGraphNode[];
+    removedNodes: CodeGraphNode[];
+    addedEdges: CodeGraphEdge[];
+    removedEdges: CodeGraphEdge[];
+}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+// Shared types for ContextHub
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_MEMORY_TYPES = void 0;
+// Security-related types
+exports.VALID_MEMORY_TYPES = ['prompt', 'response', 'summary', 'decision', 'architecture', 'bugfix', 'manual', 'commit'];

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@imayuur/contexthub-shared-types",
+  "version": "1.0.0",
+  "description": "Shared TypeScript types for ContextHub",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iMayuuR/contexthub.git",
+    "directory": "packages/shared-types"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "author": "Mayur Dattatray Patil",
+  "bugs": {
+    "url": "https://github.com/iMayuuR/contexthub/issues"
+  },
+  "homepage": "https://github.com/iMayuuR/contexthub#readme",
+  "keywords": [
+    "contexthub",
+    "mcp",
+    "ai-memory",
+    "cursor",
+    "claude"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}