@zipbul/gildash 0.0.1

package/dist/migrations/migrations/meta/0000_snapshot.json

@@ -0,0 +1,408 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "dde10964-60b8-4981-af9f-7d4664d0d20a",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "tables": {
+    "files": {
+      "name": "files",
+      "columns": {
+        "project": {
+          "name": "project",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "file_path": {
+          "name": "file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "mtime_ms": {
+          "name": "mtime_ms",
+          "type": "real",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "size": {
+          "name": "size",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content_hash": {
+          "name": "content_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "files_project_file_path_pk": {
+          "columns": [
+            "project",
+            "file_path"
+          ],
+          "name": "files_project_file_path_pk"
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "relations": {
+      "name": "relations",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "project": {
+          "name": "project",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "src_file_path": {
+          "name": "src_file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "src_symbol_name": {
+          "name": "src_symbol_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "dst_file_path": {
+          "name": "dst_file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "dst_symbol_name": {
+          "name": "dst_symbol_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "meta_json": {
+          "name": "meta_json",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "idx_relations_src": {
+          "name": "idx_relations_src",
+          "columns": [
+            "project",
+            "src_file_path"
+          ],
+          "isUnique": false
+        },
+        "idx_relations_dst": {
+          "name": "idx_relations_dst",
+          "columns": [
+            "project",
+            "dst_file_path"
+          ],
+          "isUnique": false
+        },
+        "idx_relations_type": {
+          "name": "idx_relations_type",
+          "columns": [
+            "project",
+            "type"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "relations_project_src_file_path_files_project_file_path_fk": {
+          "name": "relations_project_src_file_path_files_project_file_path_fk",
+          "tableFrom": "relations",
+          "tableTo": "files",
+          "columnsFrom": [
+            "project",
+            "src_file_path"
+          ],
+          "columnsTo": [
+            "project",
+            "file_path"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "relations_project_dst_file_path_files_project_file_path_fk": {
+          "name": "relations_project_dst_file_path_files_project_file_path_fk",
+          "tableFrom": "relations",
+          "tableTo": "files",
+          "columnsFrom": [
+            "project",
+            "dst_file_path"
+          ],
+          "columnsTo": [
+            "project",
+            "file_path"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "symbols": {
+      "name": "symbols",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "project": {
+          "name": "project",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "file_path": {
+          "name": "file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "kind": {
+          "name": "kind",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_line": {
+          "name": "start_line",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_column": {
+          "name": "start_column",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_line": {
+          "name": "end_line",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_column": {
+          "name": "end_column",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_exported": {
+          "name": "is_exported",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "signature": {
+          "name": "signature",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "fingerprint": {
+          "name": "fingerprint",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "detail_json": {
+          "name": "detail_json",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content_hash": {
+          "name": "content_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "indexed_at": {
+          "name": "indexed_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "idx_symbols_project_file": {
+          "name": "idx_symbols_project_file",
+          "columns": [
+            "project",
+            "file_path"
+          ],
+          "isUnique": false
+        },
+        "idx_symbols_project_kind": {
+          "name": "idx_symbols_project_kind",
+          "columns": [
+            "project",
+            "kind"
+          ],
+          "isUnique": false
+        },
+        "idx_symbols_project_name": {
+          "name": "idx_symbols_project_name",
+          "columns": [
+            "project",
+            "name"
+          ],
+          "isUnique": false
+        },
+        "idx_symbols_fingerprint": {
+          "name": "idx_symbols_fingerprint",
+          "columns": [
+            "project",
+            "fingerprint"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "symbols_project_file_path_files_project_file_path_fk": {
+          "name": "symbols_project_file_path_files_project_file_path_fk",
+          "tableFrom": "symbols",
+          "tableTo": "files",
+          "columnsFrom": [
+            "project",
+            "file_path"
+          ],
+          "columnsTo": [
+            "project",
+            "file_path"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "watcher_owner": {
+      "name": "watcher_owner",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "pid": {
+          "name": "pid",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "started_at": {
+          "name": "started_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "heartbeat_at": {
+          "name": "heartbeat_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {
+        "watcher_owner_singleton": {
+          "name": "watcher_owner_singleton",
+          "value": "\"watcher_owner\".\"id\" = 1"
+        }
+      }
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/dist/migrations/migrations/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1771705270251,
+      "tag": "0000_soft_revanche",
+      "breakpoints": true
+    }
+  ]
+}

package/dist/src/codeledger.d.ts

@@ -0,0 +1,103 @@
+import type { ParsedFile } from './parser/types';
+import { parseSource as defaultParseSource } from './parser/parse-source';
+import { ParseCache } from './parser/parse-cache';
+import type { ExtractedSymbol } from './extractor/types';
+import { extractSymbols as defaultExtractSymbols } from './extractor/symbol-extractor';
+import { extractRelations as defaultExtractRelations } from './extractor/relation-extractor';
+import type { CodeRelation } from './extractor/types';
+import { DbConnection } from './store/connection';
+import { FileRepository } from './store/repositories/file.repository';
+import { SymbolRepository } from './store/repositories/symbol.repository';
+import { RelationRepository } from './store/repositories/relation.repository';
+import { ProjectWatcher } from './watcher/project-watcher';
+import { IndexCoordinator } from './indexer/index-coordinator';
+import type { IndexResult } from './indexer/index-coordinator';
+import type { FileChangeEvent } from './watcher/types';
+import { acquireWatcherRole, releaseWatcherRole, updateHeartbeat } from './watcher/ownership';
+import type { WatcherOwnerStore } from './watcher/ownership';
+import { discoverProjects } from './common/project-discovery';
+import type { ProjectBoundary } from './common/project-discovery';
+import { loadTsconfigPaths } from './common/tsconfig-resolver';
+import type { TsconfigPaths } from './common/tsconfig-resolver';
+import { symbolSearch as defaultSymbolSearch } from './search/symbol-search';
+import type { SymbolSearchQuery, SymbolSearchResult } from './search/symbol-search';
+import { relationSearch as defaultRelationSearch } from './search/relation-search';
+import type { RelationSearchQuery } from './search/relation-search';
+import type { SymbolStats } from './store/repositories/symbol.repository';
+export interface Logger {
+    error(...args: unknown[]): void;
+}
+export interface CodeledgerOptions {
+    projectRoot: string;
+    extensions?: string[];
+    ignorePatterns?: string[];
+    parseCacheCapacity?: number;
+    logger?: Logger;
+}
+/** @internal */
+interface CodeledgerInternalOptions {
+    existsSyncFn?: (p: string) => boolean;
+    dbConnectionFactory?: () => Pick<DbConnection, 'open' | 'close' | 'transaction'> & WatcherOwnerStore;
+    watcherFactory?: () => Pick<ProjectWatcher, 'start' | 'close'>;
+    coordinatorFactory?: () => Pick<IndexCoordinator, 'fullIndex' | 'shutdown' | 'onIndexed'> & {
+        tsconfigPaths?: Promise<TsconfigPaths | null>;
+        handleWatcherEvent?(event: FileChangeEvent): void;
+    };
+    repositoryFactory?: () => {
+        fileRepo: Pick<FileRepository, 'upsertFile' | 'getAllFiles' | 'getFilesMap' | 'deleteFile'>;
+        symbolRepo: SymbolRepository;
+        relationRepo: RelationRepository;
+        parseCache: Pick<ParseCache, 'set' | 'get' | 'invalidate'>;
+    };
+    acquireWatcherRoleFn?: typeof acquireWatcherRole;
+    releaseWatcherRoleFn?: typeof releaseWatcherRole;
+    updateHeartbeatFn?: typeof updateHeartbeat;
+    discoverProjectsFn?: typeof discoverProjects;
+    parseSourceFn?: typeof defaultParseSource;
+    extractSymbolsFn?: typeof defaultExtractSymbols;
+    extractRelationsFn?: typeof defaultExtractRelations;
+    symbolSearchFn?: typeof defaultSymbolSearch;
+    relationSearchFn?: typeof defaultRelationSearch;
+    loadTsconfigPathsFn?: typeof loadTsconfigPaths;
+}
+export declare class Codeledger {
+    readonly projectRoot: string;
+    private readonly db;
+    private readonly symbolRepo;
+    private readonly relationRepo;
+    private readonly parseCache;
+    private coordinator;
+    private watcher;
+    private readonly releaseWatcherRoleFn;
+    private readonly parseSourceFn;
+    private readonly extractSymbolsFn;
+    private readonly extractRelationsFn;
+    private readonly symbolSearchFn;
+    private readonly relationSearchFn;
+    private readonly logger;
+    private readonly defaultProject;
+    private readonly role;
+    private timer;
+    private signalHandlers;
+    private closed;
+    private tsconfigPaths;
+    private boundaries;
+    private readonly onIndexedCallbacks;
+    private constructor();
+    static open(options: CodeledgerOptions & CodeledgerInternalOptions): Promise<Codeledger>;
+    close(): Promise<void>;
+    onIndexed(callback: (result: IndexResult) => void): () => void;
+    parseSource(filePath: string, sourceText: string): ParsedFile;
+    extractSymbols(parsed: ParsedFile): ExtractedSymbol[];
+    extractRelations(parsed: ParsedFile): CodeRelation[];
+    reindex(): Promise<IndexResult>;
+    get projects(): ProjectBoundary[];
+    getStats(project?: string): SymbolStats;
+    searchSymbols(query: SymbolSearchQuery): SymbolSearchResult[];
+    searchRelations(query: RelationSearchQuery): CodeRelation[];
+    getDependencies(filePath: string, project?: string, limit?: number): string[];
+    getDependents(filePath: string, project?: string, limit?: number): string[];
+    getAffected(changedFiles: string[], project?: string): Promise<string[]>;
+    hasCycle(project?: string): Promise<boolean>;
+}
+export {};

package/dist/src/common/hasher.d.ts

@@ -0,0 +1,2 @@
+export declare function hashString(input: string): string;
+export declare function hashFile(filePath: string): Promise<string>;

package/dist/src/common/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./hasher";
+export * from "./lru-cache";
+export * from "./path-utils";
+export * from "./project-discovery";
+export * from "./tsconfig-resolver";

package/dist/src/common/lru-cache.d.ts

@@ -0,0 +1,10 @@
+export declare class LruCache<K, V> {
+    #private;
+    constructor(capacity: number);
+    get size(): number;
+    has(key: K): boolean;
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    delete(key: K): boolean;
+    clear(): void;
+}

package/dist/src/common/path-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function toRelativePath(projectRoot: string, absolutePath: string): string;
+export declare function toAbsolutePath(projectRoot: string, relativePath: string): string;

package/dist/src/common/project-discovery.d.ts

@@ -0,0 +1,6 @@
+export interface ProjectBoundary {
+    dir: string;
+    project: string;
+}
+export declare function discoverProjects(projectRoot: string): Promise<ProjectBoundary[]>;
+export declare function resolveFileProject(filePath: string, boundaries: ProjectBoundary[], rootProject?: string): string;

package/dist/src/common/tsconfig-resolver.d.ts

@@ -0,0 +1,6 @@
+export interface TsconfigPaths {
+    baseUrl: string;
+    paths: Map<string, string[]>;
+}
+export declare function loadTsconfigPaths(projectRoot: string): Promise<TsconfigPaths | null>;
+export declare function clearTsconfigPathsCache(projectRoot?: string): void;

package/dist/src/errors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Base error class for all Gildash errors.
+ * Every error thrown by this library is an instance of `GildashError`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await Gildash.open({ projectRoot: '/path' });
+ * } catch (err) {
+ *   if (err instanceof GildashError) {
+ *     console.error('Gildash error:', err.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class GildashError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Thrown when the file watcher fails to start or stop. */
+export declare class WatcherError extends GildashError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Thrown when AST parsing of a TypeScript file fails. */
+export declare class ParseError extends GildashError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Thrown when symbol or relation extraction from a parsed AST fails. */
+export declare class ExtractError extends GildashError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Thrown when the indexing pipeline encounters an unrecoverable error. */
+export declare class IndexError extends GildashError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Thrown when a database (SQLite) operation fails. */
+export declare class StoreError extends GildashError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Thrown when a search query (symbol search, relation search) fails. */
+export declare class SearchError extends GildashError {
+    constructor(message: string, options?: ErrorOptions);
+}

package/dist/src/extractor/calls-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { Program } from 'oxc-parser';
+import type { ImportReference, CodeRelation } from './types';
+export declare function extractCalls(ast: Program, filePath: string, importMap: Map<string, ImportReference>): CodeRelation[];

package/dist/src/extractor/extractor-utils.d.ts

@@ -0,0 +1,5 @@
+import type { Program } from 'oxc-parser';
+import type { TsconfigPaths } from '../common/tsconfig-resolver';
+import type { ImportReference } from './types';
+export declare function resolveImport(currentFilePath: string, importPath: string, tsconfigPaths?: TsconfigPaths): string[];
+export declare function buildImportMap(ast: Program, currentFilePath: string, tsconfigPaths?: TsconfigPaths, resolveImportFn?: (currentFilePath: string, importPath: string, tsconfigPaths?: TsconfigPaths) => string[]): Map<string, ImportReference>;

package/dist/src/extractor/heritage-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { Program } from 'oxc-parser';
+import type { ImportReference, CodeRelation } from './types';
+export declare function extractHeritage(ast: Program, filePath: string, importMap: Map<string, ImportReference>): CodeRelation[];

package/dist/src/extractor/imports-extractor.d.ts

@@ -0,0 +1,4 @@
+import type { Program } from 'oxc-parser';
+import type { TsconfigPaths } from '../common/tsconfig-resolver';
+import type { CodeRelation } from './types';
+export declare function extractImports(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths, resolveImportFn?: (currentFilePath: string, importPath: string, tsconfigPaths?: TsconfigPaths) => string[]): CodeRelation[];

package/dist/src/extractor/index.d.ts

@@ -0,0 +1,7 @@
+export { extractSymbols } from './symbol-extractor';
+export { extractRelations } from './relation-extractor';
+export { extractImports } from './imports-extractor';
+export { extractCalls } from './calls-extractor';
+export { extractHeritage } from './heritage-extractor';
+export { resolveImport, buildImportMap } from './extractor-utils';
+export type { ExtractedSymbol, SymbolKind, CodeRelation, Parameter, Modifier, Heritage, Decorator, JsDocBlock, JsDocTag, ImportReference, QualifiedName, } from './types';

package/dist/src/extractor/relation-extractor.d.ts

@@ -0,0 +1,4 @@
+import type { Program } from 'oxc-parser';
+import type { TsconfigPaths } from '../common/tsconfig-resolver';
+import type { CodeRelation } from './types';
+export declare function extractRelations(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths): CodeRelation[];

package/dist/src/extractor/symbol-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedFile } from '../parser/types';
+import type { ExtractedSymbol } from './types';
+export declare function extractSymbols(parsed: ParsedFile): ExtractedSymbol[];