@superblocksteam/vite-plugin-file-sync 2.0.74-next.2 → 2.0.75-next.3

package/dist/ai-service/app-interface/filesystem/draft-manager.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Draft management wrapper.
+ *
+ * Encapsulates the DraftInterface to provide a clean internal API
+ * for managing draft file operations within the AppShell.
+ * External consumers (tools) should not interact with this directly.
+ */
+import type { DraftInterface } from "../../../draft-interface.js";
+/**
+ * Draft changes categorized by operation type.
+ */
+export interface DraftChanges {
+    /** Files that have been edited (content modified) */
+    edits: string[];
+    /** Files that have been added (new files) */
+    additions: string[];
+    /** Files that have been deleted */
+    deletions: string[];
+}
+/**
+ * Manages draft file operations.
+ *
+ * This class wraps the DraftInterface to provide a simplified API
+ * for the AppShell filesystem operations. It handles all draft
+ * creation, deletion, and query operations internally.
+ */
+export declare class DraftManager {
+    private readonly draftInterface;
+    constructor(draftInterface: DraftInterface);
+    /**
+     * Creates a draft file with the given content.
+     *
+     * This stages a file write that can be committed or discarded.
+     * Parent directories are created automatically.
+     *
+     * @param filePath - Relative path of the file
+     * @param content - Content to write
+     */
+    createDraft(filePath: string, content: string): Promise<void>;
+    /**
+     * Creates a draft marker without content.
+     *
+     * Used to mark a file as having a pending draft without
+     * specifying the content immediately.
+     *
+     * @param filePath - Relative path of the file
+     */
+    createDraftMarker(filePath: string): Promise<void>;
+    /**
+     * Creates a draft deletion for a file.
+     *
+     * This stages a file deletion that can be committed or discarded.
+     *
+     * @param filePath - Relative path of the file to delete
+     */
+    createDraftDelete(filePath: string): Promise<void>;
+    /**
+     * Checks if there are any pending draft changes.
+     *
+     * @returns true if there are uncommitted draft changes
+     */
+    hasDraftChanges(): Promise<boolean>;
+    /**
+     * Gets a unified diff of pending draft changes.
+     *
+     * @param paths - Optional specific paths to diff. If empty, diffs all changes.
+     * @returns Unified diff string
+     */
+    getDraftDiff(paths?: string[]): Promise<string>;
+    /**
+     * Gets categorized draft changes.
+     *
+     * @returns Object containing arrays of edited, added, and deleted paths
+     */
+    getDraftChanges(): Promise<DraftChanges>;
+    /**
+     * Gets the underlying DraftInterface.
+     *
+     * This should only be used for advanced operations that require
+     * direct access to the draft interface. Prefer using the methods
+     * on this class when possible.
+     *
+     * @internal
+     */
+    getInterface(): DraftInterface;
+}
+//# sourceMappingURL=draft-manager.d.ts.map

package/dist/ai-service/app-interface/filesystem/draft-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-manager.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/draft-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAE3D;;;;;;;;OAQG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE;;;;;;;OAOG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;;;;;OAMG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzC;;;;;OAKG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAI9C;;;;;;;;OAQG;IACH,YAAY,IAAI,cAAc;CAG/B"}

package/dist/ai-service/app-interface/filesystem/draft-manager.js

@@ -0,0 +1,91 @@
+/**
+ * Draft management wrapper.
+ *
+ * Encapsulates the DraftInterface to provide a clean internal API
+ * for managing draft file operations within the AppShell.
+ * External consumers (tools) should not interact with this directly.
+ */
+/**
+ * Manages draft file operations.
+ *
+ * This class wraps the DraftInterface to provide a simplified API
+ * for the AppShell filesystem operations. It handles all draft
+ * creation, deletion, and query operations internally.
+ */
+export class DraftManager {
+    draftInterface;
+    constructor(draftInterface) {
+        this.draftInterface = draftInterface;
+    }
+    /**
+     * Creates a draft file with the given content.
+     *
+     * This stages a file write that can be committed or discarded.
+     * Parent directories are created automatically.
+     *
+     * @param filePath - Relative path of the file
+     * @param content - Content to write
+     */
+    async createDraft(filePath, content) {
+        await this.draftInterface.createDraftFile(filePath, content);
+    }
+    /**
+     * Creates a draft marker without content.
+     *
+     * Used to mark a file as having a pending draft without
+     * specifying the content immediately.
+     *
+     * @param filePath - Relative path of the file
+     */
+    async createDraftMarker(filePath) {
+        await this.draftInterface.createDraftMarkerOnly(filePath);
+    }
+    /**
+     * Creates a draft deletion for a file.
+     *
+     * This stages a file deletion that can be committed or discarded.
+     *
+     * @param filePath - Relative path of the file to delete
+     */
+    async createDraftDelete(filePath) {
+        await this.draftInterface.createDraftDelete(filePath);
+    }
+    /**
+     * Checks if there are any pending draft changes.
+     *
+     * @returns true if there are uncommitted draft changes
+     */
+    async hasDraftChanges() {
+        return await this.draftInterface.hasLocalDraftChanges();
+    }
+    /**
+     * Gets a unified diff of pending draft changes.
+     *
+     * @param paths - Optional specific paths to diff. If empty, diffs all changes.
+     * @returns Unified diff string
+     */
+    async getDraftDiff(paths) {
+        return await this.draftInterface.getDraftDiff(paths ?? []);
+    }
+    /**
+     * Gets categorized draft changes.
+     *
+     * @returns Object containing arrays of edited, added, and deleted paths
+     */
+    async getDraftChanges() {
+        return await this.draftInterface.getDraftChanges();
+    }
+    /**
+     * Gets the underlying DraftInterface.
+     *
+     * This should only be used for advanced operations that require
+     * direct access to the draft interface. Prefer using the methods
+     * on this class when possible.
+     *
+     * @internal
+     */
+    getInterface() {
+        return this.draftInterface;
+    }
+}
+//# sourceMappingURL=draft-manager.js.map

package/dist/ai-service/app-interface/filesystem/draft-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-manager.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/draft-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAE/D;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,OAAe;QACjD,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,KAAgB;QACjC,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/ai-service/app-interface/filesystem/handlers/api-handler.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Virtual file handler for API files.
+ *
+ * APIs appear as single TypeScript files (apis/MyAPI.ts) but are stored
+ * as directories containing YAML definitions and step files.
+ */
+import type { FileMetadata, VirtualFileHandler, VirtualPathInfo, VirtualReadOptions, VirtualWriteOptions, VirtualDeleteOptions } from "../virtual-fs-types.js";
+/**
+ * Handler for virtual API files.
+ *
+ * Virtual path: apis/MyAPI.ts
+ * Physical storage: apis/MyAPI/api.yaml + step files
+ * Scratch location: .superblocks/scratch/apis%2FMyAPI.ts
+ */
+export declare class ApiFileHandler implements VirtualFileHandler {
+    readonly type = "api";
+    matches(virtualPath: string): boolean;
+    matchesPhysical(physicalPath: string): boolean;
+    parse(virtualPath: string): VirtualPathInfo | undefined;
+    toVirtualPath(physicalPath: string): string | undefined;
+    read(virtualPath: string, options: VirtualReadOptions): Promise<string | undefined>;
+    write(virtualPath: string, content: string, options: VirtualWriteOptions): Promise<void>;
+    delete(virtualPath: string, options: VirtualDeleteOptions): Promise<string[]>;
+    /**
+     * Gets metadata for a virtual API file.
+     * Checks scratch file first (for pending changes), then falls back to YAML.
+     *
+     * @param virtualPath - The virtual API path (e.g., "apis/MyAPI.ts")
+     * @param options - Read options including app root
+     * @returns FileMetadata or undefined if not found
+     */
+    getMetadata(virtualPath: string, options: VirtualReadOptions): Promise<FileMetadata | undefined>;
+    private deleteDirectoryContents;
+}
+//# sourceMappingURL=api-handler.d.ts.map

package/dist/ai-service/app-interface/filesystem/handlers/api-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-handler.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/api-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAsBhC;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,kBAAkB;IACvD,QAAQ,CAAC,IAAI,SAAS;IAEtB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKrC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI9C,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAavD,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUjD,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAgFxB,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAcV,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC;IA2CpB;;;;;;;OAOG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;YA2CtB,uBAAuB;CAyBtC"}

package/dist/ai-service/app-interface/filesystem/handlers/api-handler.js

@@ -0,0 +1,236 @@
+/**
+ * Virtual file handler for API files.
+ *
+ * APIs appear as single TypeScript files (apis/MyAPI.ts) but are stored
+ * as directories containing YAML definitions and step files.
+ */
+import { readFile, mkdir, writeFile, access, rm, readdir, stat, } from "node:fs/promises";
+import * as path from "node:path";
+import { Paths } from "../../../const.js";
+import { YamlToApiBuilderTransformer } from "../../../transform/api-builder/to-sdk-transformer.js";
+import { matchPath, matchMultiplePaths, renderPath, applyFileTransformations, } from "../../../transform/shared.js";
+// Path matchers
+const generatedApisMatch = matchPath(Paths.GeneratedApis);
+const apiArtifactsMatchRaw = matchMultiplePaths("apis/:apiName", "apis/:apiName/", "apis/:apiName/**");
+/**
+ * Matches physical API artifact paths (directories and files inside API dirs).
+ * Excludes virtual paths like apis/MyAPI.ts.
+ */
+function matchPhysicalApiPath(physicalPath) {
+    const match = apiArtifactsMatchRaw(physicalPath);
+    if (match.matched && !match.params.apiName.endsWith(".ts")) {
+        return match;
+    }
+    return { matched: false };
+}
+/**
+ * Handler for virtual API files.
+ *
+ * Virtual path: apis/MyAPI.ts
+ * Physical storage: apis/MyAPI/api.yaml + step files
+ * Scratch location: .superblocks/scratch/apis%2FMyAPI.ts
+ */
+export class ApiFileHandler {
+    type = "api";
+    matches(virtualPath) {
+        const match = generatedApisMatch(virtualPath);
+        return match.matched && match.params.apiName.endsWith(".ts");
+    }
+    matchesPhysical(physicalPath) {
+        return matchPhysicalApiPath(physicalPath).matched;
+    }
+    parse(virtualPath) {
+        const match = generatedApisMatch(virtualPath);
+        if (match.matched && match.params.apiName.endsWith(".ts")) {
+            return {
+                type: this.type,
+                params: {
+                    apiName: path.basename(match.params.apiName, ".ts"),
+                },
+            };
+        }
+        return undefined;
+    }
+    toVirtualPath(physicalPath) {
+        const match = matchPhysicalApiPath(physicalPath);
+        if (match.matched) {
+            return renderPath(Paths.GeneratedApis, {
+                apiName: `${match.params.apiName}.ts`,
+            });
+        }
+        return undefined;
+    }
+    async read(virtualPath, options) {
+        const info = this.parse(virtualPath);
+        if (!info)
+            return undefined;
+        const { appRootDirPath, templateRenderer, entityNames = [] } = options;
+        const { apiName } = info.params;
+        if (!apiName)
+            return undefined;
+        // Build paths
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        const fullScratchPath = path.join(appRootDirPath, scratchPath);
+        const yamlPath = renderPath(Paths.ApiYamls, { apiName });
+        const fullYamlPath = path.join(appRootDirPath, yamlPath);
+        // Check if both scratch and YAML exist, and compare timestamps
+        // If YAML is newer than scratch, the scratch is stale (user made manual edits)
+        let scratchExists = false;
+        let scratchMtime;
+        let yamlExists = false;
+        let yamlMtime;
+        try {
+            const scratchStat = await stat(fullScratchPath);
+            scratchExists = true;
+            scratchMtime = scratchStat.mtime;
+        }
+        catch {
+            // Scratch doesn't exist
+        }
+        try {
+            const yamlStat = await stat(fullYamlPath);
+            yamlExists = true;
+            yamlMtime = yamlStat.mtime;
+        }
+        catch {
+            // YAML doesn't exist
+        }
+        // If scratch exists and is newer than YAML (or YAML doesn't exist), use scratch
+        const scratchIsFresh = scratchExists &&
+            scratchMtime &&
+            (!yamlExists || !yamlMtime || scratchMtime >= yamlMtime);
+        if (scratchIsFresh) {
+            return await readFile(fullScratchPath, "utf-8");
+        }
+        // YAML doesn't exist and scratch is stale or missing
+        if (!yamlExists) {
+            return undefined;
+        }
+        if (!templateRenderer) {
+            throw new Error("TemplateRenderer is required to generate API content from YAML");
+        }
+        // Generate from YAML (scratch is stale or doesn't exist)
+        const yamlArtifact = {
+            type: "file",
+            filePath: yamlPath,
+            content: "",
+        };
+        const [sdkArtifact] = await applyFileTransformations([yamlArtifact], [
+            new YamlToApiBuilderTransformer({
+                appRootDirPath,
+                entityNames,
+                skipCleanup: true,
+                templateRenderer,
+            }),
+        ]);
+        return sdkArtifact?.content;
+    }
+    async write(virtualPath, content, options) {
+        const info = this.parse(virtualPath);
+        if (!info) {
+            throw new Error(`Invalid API path: ${virtualPath}`);
+        }
+        const { appRootDirPath } = options;
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        const fullScratchPath = path.join(appRootDirPath, scratchPath);
+        await mkdir(path.dirname(fullScratchPath), { recursive: true });
+        await writeFile(fullScratchPath, content, "utf-8");
+    }
+    async delete(virtualPath, options) {
+        const info = this.parse(virtualPath);
+        if (!info) {
+            throw new Error(`Invalid API path: ${virtualPath}`);
+        }
+        const { appRootDirPath, createDraftDelete } = options;
+        const { apiName } = info.params;
+        if (!apiName) {
+            throw new Error(`Missing apiName in parsed path: ${virtualPath}`);
+        }
+        const deletedPaths = [];
+        // Delete API directory contents
+        const apiDirPath = renderPath(Paths.GeneratedApis, { apiName });
+        const absoluteApiDirPath = path.join(appRootDirPath, apiDirPath);
+        try {
+            await access(absoluteApiDirPath);
+            await this.deleteDirectoryContents(absoluteApiDirPath, appRootDirPath, createDraftDelete, deletedPaths);
+            await rm(absoluteApiDirPath, { recursive: true, force: true });
+        }
+        catch {
+            // API directory doesn't exist
+        }
+        // Delete scratch file if it exists
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        try {
+            await createDraftDelete(scratchPath);
+            deletedPaths.push(scratchPath);
+        }
+        catch {
+            // Scratch file doesn't exist
+        }
+        return deletedPaths;
+    }
+    /**
+     * Gets metadata for a virtual API file.
+     * Checks scratch file first (for pending changes), then falls back to YAML.
+     *
+     * @param virtualPath - The virtual API path (e.g., "apis/MyAPI.ts")
+     * @param options - Read options including app root
+     * @returns FileMetadata or undefined if not found
+     */
+    async getMetadata(virtualPath, options) {
+        const info = this.parse(virtualPath);
+        if (!info)
+            return undefined;
+        const { appRootDirPath } = options;
+        const { apiName } = info.params;
+        if (!apiName)
+            return undefined;
+        // Check scratch file first (for pending changes)
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        const fullScratchPath = path.join(appRootDirPath, scratchPath);
+        try {
+            const stats = await stat(fullScratchPath);
+            return {
+                path: virtualPath,
+                size: stats.size,
+                mtime: stats.mtime,
+                isDirectory: false,
+                isFile: true,
+            };
+        }
+        catch {
+            // Fall back to YAML file
+        }
+        // Check YAML file
+        const yamlPath = renderPath(Paths.ApiYamls, { apiName });
+        const fullYamlPath = path.join(appRootDirPath, yamlPath);
+        try {
+            const stats = await stat(fullYamlPath);
+            return {
+                path: virtualPath,
+                size: stats.size,
+                mtime: stats.mtime,
+                isDirectory: false,
+                isFile: true,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async deleteDirectoryContents(dirPath, appRootDirPath, createDraftDelete, deletedPaths) {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            const relativePath = path.relative(appRootDirPath, fullPath);
+            if (entry.isDirectory()) {
+                await this.deleteDirectoryContents(fullPath, appRootDirPath, createDraftDelete, deletedPaths);
+            }
+            else {
+                await createDraftDelete(relativePath);
+                deletedPaths.push(relativePath);
+            }
+        }
+    }
+}
+//# sourceMappingURL=api-handler.js.map

package/dist/ai-service/app-interface/filesystem/handlers/api-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-handler.js","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/api-handler.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/app-interface/filesystem/handlers/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Virtual file handlers.
+ */
+export { ApiFileHandler } from "./api-handler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/app-interface/filesystem/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai-service/app-interface/filesystem/handlers/index.js

@@ -0,0 +1,5 @@
+/**
+ * Virtual file handlers.
+ */
+export { ApiFileHandler } from "./api-handler.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/app-interface/filesystem/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai-service/app-interface/filesystem/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Filesystem abstraction layer for AppShell.
+ *
+ * Re-exports all filesystem-related utilities including validation,
+ * virtual filesystem operations, and draft management.
+ */
+export * from "./validation.js";
+export { DraftManager, type DraftChanges } from "./draft-manager.js";
+export type { FileMetadata, VirtualFileHandler, VirtualPathInfo, VirtualReadOptions, VirtualWriteOptions, VirtualDeleteOptions, } from "./virtual-fs-types.js";
+export { VirtualFileSystem, createDefaultVirtualFileSystem, } from "./virtual-file-system.js";
+export { ApiFileHandler } from "./handlers/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/app-interface/filesystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGrE,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ai-service/app-interface/filesystem/index.js

@@ -0,0 +1,11 @@
+/**
+ * Filesystem abstraction layer for AppShell.
+ *
+ * Re-exports all filesystem-related utilities including validation,
+ * virtual filesystem operations, and draft management.
+ */
+export * from "./validation.js";
+export { DraftManager } from "./draft-manager.js";
+export { VirtualFileSystem, createDefaultVirtualFileSystem, } from "./virtual-file-system.js";
+export { ApiFileHandler } from "./handlers/index.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/app-interface/filesystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAWrE,OAAO,EACL,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ai-service/app-interface/filesystem/validation.d.ts

@@ -0,0 +1,71 @@
+/**
+ * File operation validation utilities.
+ *
+ * Provides centralized validation logic for all filesystem operations,
+ * including blacklist checking, path restrictions, and operation-specific rules.
+ */
+import { type FileOperation, type FileOperationValidationOptions } from "../constants.js";
+/**
+ * Error thrown when a file operation fails validation.
+ */
+export declare class FileValidationError extends Error {
+    readonly code: "BLACKLISTED" | "API_FILE" | "SCOPE_FILE" | "PACKAGE_JSON" | "DIRECT_PAGE" | "ROOT_DIR" | "READ_REQUIRED";
+    constructor(message: string, code: "BLACKLISTED" | "API_FILE" | "SCOPE_FILE" | "PACKAGE_JSON" | "DIRECT_PAGE" | "ROOT_DIR" | "READ_REQUIRED");
+}
+/**
+ * Checks if a path is an API file path (starts with "apis/").
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is an API file path
+ */
+export declare function isApiFilePath(filePath: string): boolean;
+/**
+ * Checks if a path is a direct page path (pages/xyz.tsx rather than pages/xyz/index.tsx).
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is a direct page file
+ */
+export declare function isDirectPagePath(filePath: string): boolean;
+/**
+ * Checks if a path is a scope file.
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is a scope file
+ */
+export declare function isScopeFile(filePath: string): boolean;
+/**
+ * Checks if a path is the package.json file.
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is package.json
+ */
+export declare function isPackageJson(filePath: string): boolean;
+/**
+ * Checks if a path is in the blacklist.
+ *
+ * @param relativePath - Relative path to check
+ * @param appRootDirPath - Application root directory for relative path calculation
+ * @returns Error message if blacklisted, null otherwise
+ */
+export declare function checkBlacklist(relativePath: string, _appRootDirPath: string): string | null;
+/**
+ * Validates a file operation against all applicable rules.
+ *
+ * @param operation - The type of file operation
+ * @param relativePath - Relative path of the file
+ * @param appRootDirPath - Application root directory
+ * @param options - Optional validation options to override defaults
+ * @throws FileValidationError if validation fails
+ */
+export declare function validateFileOperation(operation: FileOperation, relativePath: string, appRootDirPath: string, options?: Partial<FileOperationValidationOptions>): void;
+/**
+ * Recursively checks if a directory contains any blacklisted content.
+ *
+ * @param entries - Directory entries to scan
+ * @returns Error message if blacklisted content found, null otherwise
+ */
+export declare function checkDirectoryContentBlacklist(entries: Array<{
+    name: string;
+    isDirectory: boolean;
+}>): string | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/ai-service/app-interface/filesystem/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,8BAA8B,EACpC,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,IAAI,EAChB,aAAa,GACb,UAAU,GACV,YAAY,GACZ,cAAc,GACd,aAAa,GACb,UAAU,GACV,eAAe;gBARnB,OAAO,EAAE,MAAM,EACC,IAAI,EAChB,aAAa,GACb,UAAU,GACV,YAAY,GACZ,cAAc,GACd,aAAa,GACb,UAAU,GACV,eAAe;CAKtB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAcD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CAoDf;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAChD,IAAI,CA6CN;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,GACrD,MAAM,GAAG,IAAI,CA8Bf"}