@soederpop/luca 0.1.2 → 0.2.1

package/dist/node/features/file-manager.d.ts

@@ -0,0 +1,177 @@
+import { z } from 'zod';
+import { State } from "../../state.js";
+import { Feature } from "../feature.js";
+import type { FSWatcher } from "chokidar";
+type File = {
+    absolutePath: string;
+    relativePath: string;
+    relativeDirname: string;
+    dirname: string;
+    name: string;
+    extension: string;
+    size: number;
+    modifiedAt: Date;
+    createdAt: Date;
+};
+export declare const FileManagerStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    started: z.ZodOptional<z.ZodBoolean>;
+    starting: z.ZodOptional<z.ZodBoolean>;
+    watching: z.ZodOptional<z.ZodBoolean>;
+    failed: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export declare const FileManagerOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    exclude: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+export declare const FileManagerEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    'file:change': z.ZodTuple<[z.ZodObject<{
+        type: z.ZodEnum<{
+            add: "add";
+            delete: "delete";
+            change: "change";
+        }>;
+        path: z.ZodString;
+    }, z.core.$strip>], null>;
+}, z.core.$strip>;
+export type FileManagerState = z.infer<typeof FileManagerStateSchema>;
+export type FileManagerOptions = z.infer<typeof FileManagerOptionsSchema>;
+/**
+ * The FileManager feature creates a database like index of all of the files in the project,
+ * and provides metadata about these files, and also provides a way to watch for changes to the files.
+ *
+ * @example
+ * ```typescript
+ * const fileManager = container.feature('fileManager')
+ * await fileManager.start()
+ *
+ * const fileIds = fileManager.fileIds
+ * const typescriptFiles = fileManager.matchFiles("**ts")
+ * ```
+*/
+export declare class FileManager<T extends FileManagerState = FileManagerState, K extends FileManagerOptions = FileManagerOptions> extends Feature<T, K> {
+    static shortcut: "features.fileManager";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        started: z.ZodOptional<z.ZodBoolean>;
+        starting: z.ZodOptional<z.ZodBoolean>;
+        watching: z.ZodOptional<z.ZodBoolean>;
+        failed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        exclude: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        'file:change': z.ZodTuple<[z.ZodObject<{
+            type: z.ZodEnum<{
+                add: "add";
+                delete: "delete";
+                change: "change";
+            }>;
+            path: z.ZodString;
+        }, z.core.$strip>], null>;
+    }, z.core.$strip>;
+    files: State<Record<string, File>>;
+    /** Returns an array of all relative file paths indexed by the file manager. */
+    get fileIds(): string[];
+    /** Returns an array of all file metadata objects indexed by the file manager. */
+    get fileObjects(): File[];
+    /**
+     * Matches the file IDs against the pattern(s) provided
+     * @param {string | string[]} patterns - The patterns to match against the file IDs
+     * @returns {string[]} The file IDs that match the patterns
+    */
+    match(patterns: string | string[]): string[];
+    /**
+     * Matches the file IDs against the pattern(s) provided and returns the file objects for each.
+     *
+     * @param {string | string[]} patterns - The patterns to match against the file IDs
+     * @returns {File[]} The file objects that match the patterns
+    */
+    matchFiles(patterns: string | string[]): (File | undefined)[];
+    /**
+     * Returns the directory IDs for all of the files in the project.
+    */
+    get directoryIds(): string[];
+    /** Returns an array of unique file extensions found across all indexed files. */
+    get uniqueExtensions(): string[];
+    /** Whether the file manager has completed its initial scan. */
+    get isStarted(): boolean;
+    /** Whether the file manager is currently performing its initial scan. */
+    get isStarting(): boolean;
+    /** Whether the file watcher is actively monitoring for changes. */
+    get isWatching(): boolean;
+    /** Returns the list of directories currently being watched. */
+    get watchedPaths(): string[];
+    /**
+     * Starts the file manager and scans the files in the project.
+     * @param {object} [options={}] - Options for the file manager
+     * @param {string | string[]} [options.exclude] - The patterns to exclude from the scan
+     * @returns {Promise<FileManager>} The file manager instance
+    */
+    start(options?: {
+        exclude?: string | string[];
+    }): Promise<this>;
+    /**
+     * Attempts to load the file index from disk cache.
+     * Only uses cache when in a clean git repo (sha hasn't changed, no dirty files).
+     * @returns true if cache was loaded successfully, false otherwise
+     */
+    /**
+     * Reads the current git SHA by reading .git/HEAD directly,
+     * avoiding the ~19ms cost of shelling out to `git rev-parse HEAD`.
+     */
+    private readGitShaFast;
+    private loadFromCache;
+    /**
+     * Writes the current file index to disk cache, keyed by git sha.
+     * Stores directory mtimes alongside file data so the cache can be
+     * invalidated when files are added/removed without a new commit.
+     */
+    private writeToCache;
+    /**
+     * Scans the files in the project and updates the file manager state.
+     * @param {object} [options={}] - Options for the file manager
+     * @param {string | string[]} [options.exclude] - The patterns to exclude from the scan
+     * @returns {Promise<FileManager>} The file manager instance
+    */
+    scanFiles(options?: {
+        exclude?: string | string[];
+    }): Promise<this>;
+    watcher: FSWatcher | null;
+    /** Returns the directories and files currently being watched by chokidar. */
+    get watchedFiles(): Record<string, string[]>;
+    /**
+     * Watches directories for file changes. Can be called multiple times to add
+     * more directories to an existing watcher. Tracks all watched paths in state.
+     *
+     * When called without `paths`, watches the project's `directoryIds` (default behavior).
+     * When called with `paths`, watches only those specific directories/globs.
+     * Subsequent calls add to the existing watcher — they never replace what's already watched.
+     *
+     * @param {object} [options={}] - Options for the file manager
+     * @param {string | string[]} [options.paths] - Specific directories or globs to watch. Defaults to project directoryIds.
+     * @param {string | string[]} [options.exclude] - The patterns to exclude from the watch
+     * @returns {Promise<void>}
+    */
+    watch(options?: {
+        paths?: string | string[];
+        exclude?: string | string[];
+    }): Promise<void>;
+    stopWatching(): Promise<void>;
+    updateFile(path: string): Promise<void>;
+    removeFile(path: string): Promise<void>;
+}
+export default FileManager;
+//# sourceMappingURL=file-manager.d.ts.map

package/dist/node/features/file-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager.d.ts","sourceRoot":"","sources":["../../../src/node/features/file-manager.ts"],"names":[],"mappings":"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"}