@aigne/afs 1.11.0-beta → 1.11.0-beta.10

package/dist/provider/base.d.mts

@@ -0,0 +1,175 @@
+import { AFSExplainResult } from "../meta/type.mjs";
+import { AFSAccessMode, AFSDeleteOptions, AFSDeleteResult, AFSEntry, AFSEntryMetadata, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRenameOptions, AFSRenameResult, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult } from "../type.mjs";
+import { OperationsDeclaration } from "../capabilities/types.mjs";
+import { ProviderRouter } from "./router.mjs";
+
+//#region src/provider/base.d.ts
+/**
+ * Abstract base class for AFS providers using virtual routing
+ *
+ * All providers extend this class and use decorators to define routes:
+ * - @List(pattern) - Handle list operations
+ * - @Read(pattern) - Handle read operations
+ * - @Write(pattern) - Handle write operations
+ * - @Delete(pattern) - Handle delete operations
+ * - @Exec(pattern) - Handle exec operations
+ * - @Search(pattern) - Handle search operations
+ * - @Meta(pattern) - Handle .meta path reads
+ * - @Actions(pattern) - Handle .actions path listing
+ *
+ * @example
+ * ```typescript
+ * class MyProvider extends AFSBaseProvider {
+ *   readonly name = "my-provider";
+ *
+ *   @List("/")
+ *   async listRoot(ctx: RouteContext) {
+ *     return { data: [...] };
+ *   }
+ *
+ *   @Read("/:id")
+ *   async getItem(ctx: RouteContext<{ id: string }>) {
+ *     return { id: ctx.params.id, path: ctx.path, content: ... };
+ *   }
+ * }
+ * ```
+ */
+declare abstract class AFSBaseProvider implements AFSModule {
+  /** Provider name, must be unique when mounted */
+  abstract readonly name: string;
+  /** Optional description */
+  readonly description?: string;
+  /** Access mode: "readonly" or "readwrite" */
+  readonly accessMode: AFSAccessMode;
+  /** Internal router for path matching */
+  private router;
+  constructor();
+  /**
+   * Collect routes from decorators and register them
+   */
+  private collectDecoratorRoutes;
+  /**
+   * Remove methods for operations that have no routes registered.
+   * This allows core to check if a provider supports a capability via typeof check.
+   *
+   * We set the method to undefined on the instance to shadow the prototype method,
+   * since `delete` only removes instance properties, not inherited ones.
+   */
+  private removeUnimplementedMethods;
+  /**
+   * Build an OperationsDeclaration based on which methods are implemented.
+   * Uses the fact that removeUnimplementedMethods() sets unsupported methods to undefined.
+   * Write/delete/exec/rename are also gated by accessMode.
+   */
+  protected getOperationsDeclaration(): OperationsDeclaration;
+  /**
+   * List entries at a path
+   */
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  /**
+   * Expand list results to specified depth using BFS traversal.
+   * Used when handler has handleDepth: false.
+   *
+   * The handler is expected to return single-level results (direct children only).
+   * This method recursively calls the handler to expand directories up to maxDepth.
+   * Pattern filtering is applied after BFS completes to ensure directories are
+   * traversed even if they don't match the pattern.
+   */
+  private listWithDepthExpansion;
+  /**
+   * Check if a path matches a glob pattern
+   */
+  private matchesPattern;
+  /**
+   * Read an entry at a path
+   */
+  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
+  /**
+   * Write an entry at a path
+   */
+  write(path: string, content: AFSWriteEntryPayload, options?: AFSWriteOptions): Promise<AFSWriteResult>;
+  /**
+   * Delete an entry at a path
+   */
+  delete(path: string, options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
+  /**
+   * Search entries at a path
+   */
+  search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
+  /**
+   * Execute an action at a path
+   */
+  exec(path: string, args: Record<string, unknown>, options?: AFSExecOptions): Promise<AFSExecResult>;
+  /**
+   * Get stat information for a path
+   *
+   * Note: Fallback to read() is handled at AFS core level, not here.
+   */
+  stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult>;
+  /**
+   * Get human-readable explanation for a path
+   *
+   * Note: Fallback to stat() is handled at AFS core level, not here.
+   */
+  explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult>;
+  /**
+   * Rename/move a path
+   */
+  rename(oldPath: string, newPath: string, options?: AFSRenameOptions): Promise<AFSRenameResult>;
+  /**
+   * Normalize a path to ensure consistent format
+   * - Always starts with /
+   * - No trailing slash (except for root)
+   */
+  protected normalizePath(path: string): string;
+  /**
+   * Join path segments
+   */
+  protected joinPath(...segments: string[]): string;
+  /**
+   * Build an AFSEntry helper
+   *
+   * @param path - The entry path (will be normalized)
+   * @param options - Entry options
+   * @param options.id - Entry ID. Defaults to normalized path if not provided
+   * @param options.content - Entry content
+   * @param options.meta - Entry metadata
+   * @param options.createdAt - Creation time. Undefined if not available from data source
+   * @param options.updatedAt - Last update time. Undefined if not available from data source
+   *
+   * @example
+   * ```typescript
+   * // Simple entry with just path
+   * this.buildEntry("/items/1")
+   *
+   * // Entry with content and metadata
+   * this.buildEntry("/items/1", {
+   *   content: { name: "Item 1" },
+   *   meta: { size: 100 },
+   * })
+   *
+   * // Entry with all fields
+   * this.buildEntry("/items/1", {
+   *   id: "custom-id",
+   *   content: data,
+   *   meta: { size: stats.size },
+   *   createdAt: stats.birthtime,
+   *   updatedAt: stats.mtime,
+   * })
+   * ```
+   */
+  protected buildEntry(path: string, options?: {
+    id?: string;
+    content?: unknown;
+    meta?: Partial<AFSEntryMetadata>;
+    createdAt?: Date;
+    updatedAt?: Date;
+  }): AFSEntry;
+  /**
+   * Get the router (for testing/debugging)
+   */
+  protected getRouter(): ProviderRouter;
+}
+//#endregion
+export { AFSBaseProvider };
+//# sourceMappingURL=base.d.mts.map

package/dist/provider/base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.mts","names":[],"sources":["../../src/provider/base.ts"],"mappings":";;;;;;;;;AA0EA;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAsB,eAAA,YAA2B,SAAA;EAmdT;EAAA,kBAjdpB,IAAA;EAidwC;EAAA,SA9cjD,WAAA;EAueE;EAAA,SApeF,UAAA,EAAY,aAAA;EAkkBF;EAAA,QA/jBX,MAAA;;EAikBQ;;;EAAA,QAtjBR,sBAAA;EAtBgD;;;;;;;EAAA,QAqDhD,0BAAA;;;;;;YA4BE,wBAAA,CAAA,GAA4B,qBAAA;EAmB3B;;;EAAL,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAAA;;;;;;;;;EAAA,QAyD9C,sBAAA;EAsLZ;;;EAAA,QAlEM,cAAA;EAoEN;;;EA7DI,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAuF/C;;;EA7BP,KAAA,CACJ,IAAA,UACA,OAAA,EAAS,oBAAA,EACT,OAAA,GAAU,eAAA,GACT,OAAA,CAAQ,cAAA;EAyBqD;;;EAA1D,MAAA,CAAO,IAAA,UAAc,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAyBZ;;;EAA9C,MAAA,CAAO,IAAA,UAAc,KAAA,UAAe,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAqBzE;;;EAAA,IAAA,CACJ,IAAA,UACA,IAAA,EAAM,MAAA,mBACN,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,aAAA;EADC;;;;;EA4BN,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAAzB;;;;;EAuB7B,OAAA,CAAQ,IAAA,UAAc,OAAA,GAAU,iBAAA,GAAoB,OAAA,CAAQ,gBAAA;EAA5B;;;EAqBhC,MAAA,CACJ,OAAA,UACA,OAAA,UACA,OAAA,GAAU,gBAAA,GACT,OAAA,CAAQ,eAAA;EAJL;;;;;EAAA,UAiCI,aAAA,CAAc,IAAA;EA7Bb;;;EAAA,UAgDD,QAAA,CAAA,GAAY,QAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAA,UAyCZ,UAAA,CACR,IAAA,UACA,OAAA;IACE,EAAA;IACA,OAAA;IACA,IAAA,GAAO,OAAA,CAAQ,gBAAA;IACf,SAAA,GAAY,IAAA;IACZ,SAAA,GAAY,IAAA;EAAA,IAEb,QAAA;;;;YAeO,SAAA,CAAA,GAAa,cAAA;AAAA"}

package/dist/provider/base.mjs

@@ -0,0 +1,426 @@
+import { AFSNotFoundError, AFSReadonlyError } from "../error.mjs";
+import { getRoutes } from "./decorators.mjs";
+import { ProviderRouter } from "./router.mjs";
+import { minimatch } from "minimatch";
+
+//#region src/provider/base.ts
+/**
+* Abstract base class for AFS providers using virtual routing
+*
+* All providers extend this class and use decorators to define routes:
+* - @List(pattern) - Handle list operations
+* - @Read(pattern) - Handle read operations
+* - @Write(pattern) - Handle write operations
+* - @Delete(pattern) - Handle delete operations
+* - @Exec(pattern) - Handle exec operations
+* - @Search(pattern) - Handle search operations
+* - @Meta(pattern) - Handle .meta path reads
+* - @Actions(pattern) - Handle .actions path listing
+*
+* @example
+* ```typescript
+* class MyProvider extends AFSBaseProvider {
+*   readonly name = "my-provider";
+*
+*   @List("/")
+*   async listRoot(ctx: RouteContext) {
+*     return { data: [...] };
+*   }
+*
+*   @Read("/:id")
+*   async getItem(ctx: RouteContext<{ id: string }>) {
+*     return { id: ctx.params.id, path: ctx.path, content: ... };
+*   }
+* }
+* ```
+*/
+var AFSBaseProvider = class {
+	/** Optional description */
+	description;
+	/** Access mode: "readonly" or "readwrite" */
+	accessMode = "readonly";
+	/** Internal router for path matching */
+	router;
+	constructor() {
+		this.router = new ProviderRouter();
+		this.collectDecoratorRoutes();
+		this.removeUnimplementedMethods();
+	}
+	/**
+	* Collect routes from decorators and register them
+	*/
+	collectDecoratorRoutes() {
+		const routes = getRoutes(this.constructor);
+		for (const route of routes) {
+			const handler = this[route.methodName];
+			if (typeof handler !== "function") {
+				console.warn(`[AFSBaseProvider] Method ${route.methodName} not found on ${this.constructor.name}`);
+				continue;
+			}
+			const boundHandler = handler.bind(this);
+			this.router.registerRoute(route.pattern, route.operation, boundHandler, route.description, route.listOptions);
+		}
+	}
+	/**
+	* Remove methods for operations that have no routes registered.
+	* This allows core to check if a provider supports a capability via typeof check.
+	*
+	* We set the method to undefined on the instance to shadow the prototype method,
+	* since `delete` only removes instance properties, not inherited ones.
+	*/
+	removeUnimplementedMethods() {
+		for (const [operation, methodName] of Object.entries({
+			list: "list",
+			read: "read",
+			write: "write",
+			delete: "delete",
+			exec: "exec",
+			search: "search",
+			stat: "stat",
+			explain: "explain",
+			rename: "rename"
+		})) if (this.router.getRoutesForOperation(operation).length === 0) this[methodName] = void 0;
+	}
+	/**
+	* Build an OperationsDeclaration based on which methods are implemented.
+	* Uses the fact that removeUnimplementedMethods() sets unsupported methods to undefined.
+	* Write/delete/exec/rename are also gated by accessMode.
+	*/
+	getOperationsDeclaration() {
+		const isReadwrite = this.accessMode === "readwrite";
+		return {
+			read: typeof this.read === "function",
+			list: typeof this.list === "function",
+			write: typeof this.write === "function" && isReadwrite,
+			delete: typeof this.delete === "function" && isReadwrite,
+			search: typeof this.search === "function",
+			exec: typeof this.exec === "function",
+			stat: typeof this.stat === "function",
+			explain: typeof this.explain === "function"
+		};
+	}
+	/**
+	* List entries at a path
+	*/
+	async list(path, options) {
+		const maxDepth = options?.maxDepth ?? 1;
+		if (maxDepth === 0) return { data: [] };
+		const normalizedPath = this.normalizePath(path);
+		const match = this.router.match(normalizedPath, "list");
+		if (!match) throw new AFSNotFoundError(normalizedPath);
+		const limit = options?.limit;
+		if ((match.route.listOptions?.handleDepth ?? false) || maxDepth <= 1) {
+			const ctx = {
+				path: normalizedPath,
+				params: match.params,
+				options
+			};
+			const handler = match.route.handler;
+			const handlerResult = await handler(ctx);
+			const result = {
+				data: handlerResult.data,
+				total: handlerResult.total
+			};
+			if (limit !== void 0 && result.data.length > limit) return {
+				data: result.data.slice(0, limit),
+				total: result.total ?? result.data.length
+			};
+			return result;
+		}
+		return this.listWithDepthExpansion(normalizedPath, options, maxDepth);
+	}
+	/**
+	* Expand list results to specified depth using BFS traversal.
+	* Used when handler has handleDepth: false.
+	*
+	* The handler is expected to return single-level results (direct children only).
+	* This method recursively calls the handler to expand directories up to maxDepth.
+	* Pattern filtering is applied after BFS completes to ensure directories are
+	* traversed even if they don't match the pattern.
+	*/
+	async listWithDepthExpansion(basePath, options, maxDepth) {
+		const limit = options?.limit ?? 1e3;
+		const pattern = options?.pattern;
+		const allEntries = [];
+		const visited = /* @__PURE__ */ new Set();
+		const queue = [{
+			path: basePath,
+			depth: 0
+		}];
+		const unfilteredEntries = [];
+		while (queue.length > 0) {
+			const { path, depth } = queue.shift();
+			if (visited.has(path)) continue;
+			visited.add(path);
+			const singleLevelOptions = {
+				...options,
+				maxDepth: 1,
+				pattern: void 0
+			};
+			const match = this.router.match(path, "list");
+			if (!match) continue;
+			const ctx = {
+				path,
+				params: match.params,
+				options: singleLevelOptions
+			};
+			const handler = match.route.handler;
+			let result;
+			try {
+				result = await handler(ctx);
+			} catch (error) {
+				const code = error.code;
+				if (code === "ENOENT" || code === "ENOTDIR" || error instanceof Error && error.message.includes("not found")) continue;
+				throw error;
+			}
+			const noExpandSet = new Set(result.noExpand ?? []);
+			for (const entry of result.data) {
+				if (entry.path === path && depth > 0) continue;
+				unfilteredEntries.push(entry);
+				const childrenCount = entry.meta?.childrenCount;
+				const isDirectory = childrenCount !== void 0 && childrenCount !== 0;
+				const shouldExpand = !noExpandSet.has(entry.path);
+				if (depth < maxDepth - 1 && isDirectory && shouldExpand && entry.path !== path) queue.push({
+					path: entry.path,
+					depth: depth + 1
+				});
+			}
+		}
+		if (pattern) for (const entry of unfilteredEntries) {
+			if (allEntries.length >= limit) break;
+			if (this.matchesPattern(entry.path, pattern)) allEntries.push(entry);
+		}
+		else for (const entry of unfilteredEntries) {
+			if (allEntries.length >= limit) break;
+			allEntries.push(entry);
+		}
+		return {
+			data: allEntries,
+			total: allEntries.length >= limit ? void 0 : allEntries.length
+		};
+	}
+	/**
+	* Check if a path matches a glob pattern
+	*/
+	matchesPattern(path, pattern) {
+		return minimatch(path, pattern, { matchBase: true });
+	}
+	/**
+	* Read an entry at a path
+	*/
+	async read(path, options) {
+		const normalizedPath = this.normalizePath(path);
+		const actionsMatch = normalizedPath.match(/^(.*)\/\.actions\/([^/]+)$/);
+		if (actionsMatch) {
+			const actionsListPath = `${actionsMatch[1] || ""}/.actions`;
+			const actionName = actionsMatch[2];
+			const listMatch = this.router.match(actionsListPath, "list");
+			if (listMatch) {
+				const ctx = {
+					path: actionsListPath,
+					params: listMatch.params,
+					options: {}
+				};
+				const handler = listMatch.route.handler;
+				const actionEntry = (await handler(ctx)).data.find((entry) => entry.summary === actionName || entry.id === actionName || entry.id.endsWith(`:${actionName}`) || entry.meta?.name === actionName);
+				if (actionEntry) return { data: actionEntry };
+			}
+		}
+		const match = this.router.match(normalizedPath, "read");
+		if (match) {
+			const ctx = {
+				path: normalizedPath,
+				params: match.params,
+				options
+			};
+			const handler = match.route.handler;
+			return { data: await handler(ctx) };
+		}
+		throw new AFSNotFoundError(normalizedPath);
+	}
+	/**
+	* Write an entry at a path
+	*/
+	async write(path, content, options) {
+		if (this.accessMode === "readonly") throw new AFSReadonlyError("Cannot write on a readonly provider");
+		const normalizedPath = this.normalizePath(path);
+		const match = this.router.match(normalizedPath, "write");
+		if (!match) throw new Error(`No write handler for path: ${path}`);
+		const ctx = {
+			path: normalizedPath,
+			params: match.params,
+			options
+		};
+		const handler = match.route.handler;
+		return handler(ctx, content);
+	}
+	/**
+	* Delete an entry at a path
+	*/
+	async delete(path, options) {
+		if (this.accessMode === "readonly") throw new AFSReadonlyError("Cannot delete on a readonly provider");
+		const normalizedPath = this.normalizePath(path);
+		const match = this.router.match(normalizedPath, "delete");
+		if (!match) throw new Error(`No delete handler for path: ${path}`);
+		const ctx = {
+			path: normalizedPath,
+			params: match.params,
+			options
+		};
+		const handler = match.route.handler;
+		return handler(ctx);
+	}
+	/**
+	* Search entries at a path
+	*/
+	async search(path, query, options) {
+		const normalizedPath = this.normalizePath(path);
+		const match = this.router.match(normalizedPath, "search");
+		if (!match) return { data: [] };
+		const ctx = {
+			path: normalizedPath,
+			params: match.params,
+			options
+		};
+		const handler = match.route.handler;
+		return handler(ctx, query, options);
+	}
+	/**
+	* Execute an action at a path
+	*/
+	async exec(path, args, options) {
+		if (this.accessMode === "readonly") throw new AFSReadonlyError("Cannot exec on a readonly provider");
+		const normalizedPath = this.normalizePath(path);
+		const match = this.router.match(normalizedPath, "exec");
+		if (!match) throw new Error(`No exec handler for path: ${path}`);
+		const ctx = {
+			path: normalizedPath,
+			params: match.params,
+			options
+		};
+		const handler = match.route.handler;
+		return handler(ctx, args);
+	}
+	/**
+	* Get stat information for a path
+	*
+	* Note: Fallback to read() is handled at AFS core level, not here.
+	*/
+	async stat(path, options) {
+		const normalizedPath = this.normalizePath(path);
+		const match = this.router.match(normalizedPath, "stat");
+		if (match) {
+			const ctx = {
+				path: normalizedPath,
+				params: match.params,
+				options
+			};
+			const handler = match.route.handler;
+			return handler(ctx);
+		}
+		throw new AFSNotFoundError(normalizedPath);
+	}
+	/**
+	* Get human-readable explanation for a path
+	*
+	* Note: Fallback to stat() is handled at AFS core level, not here.
+	*/
+	async explain(path, options) {
+		const normalizedPath = this.normalizePath(path);
+		const match = this.router.match(normalizedPath, "explain");
+		if (!match) throw new Error(`No explain handler for path: ${path}`);
+		const ctx = {
+			path: normalizedPath,
+			params: match.params,
+			options
+		};
+		const handler = match.route.handler;
+		return handler(ctx);
+	}
+	/**
+	* Rename/move a path
+	*/
+	async rename(oldPath, newPath, options) {
+		if (this.accessMode === "readonly") throw new AFSReadonlyError("Cannot rename on a readonly provider");
+		const normalizedPath = this.normalizePath(oldPath);
+		const match = this.router.match(normalizedPath, "rename");
+		if (!match) throw new AFSNotFoundError(normalizedPath);
+		const ctx = {
+			path: normalizedPath,
+			params: match.params,
+			options
+		};
+		const handler = match.route.handler;
+		return handler(ctx, newPath);
+	}
+	/**
+	* Normalize a path to ensure consistent format
+	* - Always starts with /
+	* - No trailing slash (except for root)
+	*/
+	normalizePath(path) {
+		if (!path || path === "/") return "/";
+		let normalized = path.startsWith("/") ? path : `/${path}`;
+		if (normalized.length > 1 && normalized.endsWith("/")) normalized = normalized.slice(0, -1);
+		return normalized;
+	}
+	/**
+	* Join path segments
+	*/
+	joinPath(...segments) {
+		return `/${segments.map((s) => s.replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/")}`;
+	}
+	/**
+	* Build an AFSEntry helper
+	*
+	* @param path - The entry path (will be normalized)
+	* @param options - Entry options
+	* @param options.id - Entry ID. Defaults to normalized path if not provided
+	* @param options.content - Entry content
+	* @param options.meta - Entry metadata
+	* @param options.createdAt - Creation time. Undefined if not available from data source
+	* @param options.updatedAt - Last update time. Undefined if not available from data source
+	*
+	* @example
+	* ```typescript
+	* // Simple entry with just path
+	* this.buildEntry("/items/1")
+	*
+	* // Entry with content and metadata
+	* this.buildEntry("/items/1", {
+	*   content: { name: "Item 1" },
+	*   meta: { size: 100 },
+	* })
+	*
+	* // Entry with all fields
+	* this.buildEntry("/items/1", {
+	*   id: "custom-id",
+	*   content: data,
+	*   meta: { size: stats.size },
+	*   createdAt: stats.birthtime,
+	*   updatedAt: stats.mtime,
+	* })
+	* ```
+	*/
+	buildEntry(path, options) {
+		const normalizedPath = this.normalizePath(path);
+		return {
+			id: options?.id ?? normalizedPath,
+			path: normalizedPath,
+			content: options?.content,
+			meta: options?.meta,
+			createdAt: options?.createdAt,
+			updatedAt: options?.updatedAt
+		};
+	}
+	/**
+	* Get the router (for testing/debugging)
+	*/
+	getRouter() {
+		return this.router;
+	}
+};
+
+//#endregion
+export { AFSBaseProvider };
+//# sourceMappingURL=base.mjs.map

package/dist/provider/base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.mjs","names":[],"sources":["../../src/provider/base.ts"],"sourcesContent":["import { minimatch } from \"minimatch\";\nimport type { OperationsDeclaration } from \"../capabilities/types.js\";\nimport { AFSNotFoundError, AFSReadonlyError } from \"../error.js\";\nimport type {\n  AFSAccessMode,\n  AFSDeleteOptions,\n  AFSDeleteResult,\n  AFSEntry,\n  AFSEntryMetadata,\n  AFSExecOptions,\n  AFSExecResult,\n  AFSExplainOptions,\n  AFSExplainResult,\n  AFSListOptions,\n  AFSListResult,\n  AFSModule,\n  AFSReadOptions,\n  AFSReadResult,\n  AFSRenameOptions,\n  AFSRenameResult,\n  AFSSearchOptions,\n  AFSSearchResult,\n  AFSStatOptions,\n  AFSStatResult,\n  AFSWriteEntryPayload,\n  AFSWriteOptions,\n  AFSWriteResult,\n} from \"../type.js\";\nimport { getRoutes } from \"./decorators.js\";\nimport { ProviderRouter } from \"./router.js\";\nimport type {\n  DeleteRouteHandler,\n  ExecRouteHandler,\n  ExplainRouteHandler,\n  ListRouteHandler,\n  ReadRouteHandler,\n  RenameRouteHandler,\n  RouteContext,\n  RouteOperation,\n  SearchRouteHandler,\n  StatRouteHandler,\n  WriteRouteHandler,\n} from \"./types.js\";\n\n/**\n * Abstract base class for AFS providers using virtual routing\n *\n * All providers extend this class and use decorators to define routes:\n * - @List(pattern) - Handle list operations\n * - @Read(pattern) - Handle read operations\n * - @Write(pattern) - Handle write operations\n * - @Delete(pattern) - Handle delete operations\n * - @Exec(pattern) - Handle exec operations\n * - @Search(pattern) - Handle search operations\n * - @Meta(pattern) - Handle .meta path reads\n * - @Actions(pattern) - Handle .actions path listing\n *\n * @example\n * ```typescript\n * class MyProvider extends AFSBaseProvider {\n *   readonly name = \"my-provider\";\n *\n *   @List(\"/\")\n *   async listRoot(ctx: RouteContext) {\n *     return { data: [...] };\n *   }\n *\n *   @Read(\"/:id\")\n *   async getItem(ctx: RouteContext<{ id: string }>) {\n *     return { id: ctx.params.id, path: ctx.path, content: ... };\n *   }\n * }\n * ```\n */\nexport abstract class AFSBaseProvider implements AFSModule {\n  /** Provider name, must be unique when mounted */\n  abstract readonly name: string;\n\n  /** Optional description */\n  readonly description?: string;\n\n  /** Access mode: \"readonly\" or \"readwrite\" */\n  readonly accessMode: AFSAccessMode = \"readonly\";\n\n  /** Internal router for path matching */\n  private router: ProviderRouter;\n\n  constructor() {\n    this.router = new ProviderRouter();\n    this.collectDecoratorRoutes();\n    this.removeUnimplementedMethods();\n  }\n\n  /**\n   * Collect routes from decorators and register them\n   */\n  private collectDecoratorRoutes(): void {\n    const routes = getRoutes(this.constructor);\n\n    for (const route of routes) {\n      const handler = (this as any)[route.methodName];\n      if (typeof handler !== \"function\") {\n        console.warn(\n          `[AFSBaseProvider] Method ${route.methodName} not found on ${this.constructor.name}`,\n        );\n        continue;\n      }\n\n      // Bind the handler to this instance\n      const boundHandler = handler.bind(this);\n      this.router.registerRoute(\n        route.pattern,\n        route.operation,\n        boundHandler,\n        route.description,\n        route.listOptions,\n      );\n    }\n  }\n\n  /**\n   * Remove methods for operations that have no routes registered.\n   * This allows core to check if a provider supports a capability via typeof check.\n   *\n   * We set the method to undefined on the instance to shadow the prototype method,\n   * since `delete` only removes instance properties, not inherited ones.\n   */\n  private removeUnimplementedMethods(): void {\n    const operationToMethod: Record<string, keyof AFSBaseProvider> = {\n      list: \"list\",\n      read: \"read\",\n      write: \"write\",\n      delete: \"delete\",\n      exec: \"exec\",\n      search: \"search\",\n      stat: \"stat\",\n      explain: \"explain\",\n      rename: \"rename\",\n    };\n\n    for (const [operation, methodName] of Object.entries(operationToMethod)) {\n      const routes = this.router.getRoutesForOperation(operation as RouteOperation);\n\n      // Keep the method only if there are routes registered for this operation\n      if (routes.length === 0) {\n        (this as any)[methodName] = undefined;\n      }\n    }\n  }\n\n  /**\n   * Build an OperationsDeclaration based on which methods are implemented.\n   * Uses the fact that removeUnimplementedMethods() sets unsupported methods to undefined.\n   * Write/delete/exec/rename are also gated by accessMode.\n   */\n  protected getOperationsDeclaration(): OperationsDeclaration {\n    const isReadwrite = this.accessMode === \"readwrite\";\n    return {\n      read: typeof this.read === \"function\",\n      list: typeof this.list === \"function\",\n      write: typeof this.write === \"function\" && isReadwrite,\n      delete: typeof this.delete === \"function\" && isReadwrite,\n      search: typeof this.search === \"function\",\n      exec: typeof this.exec === \"function\",\n      stat: typeof this.stat === \"function\",\n      explain: typeof this.explain === \"function\",\n    };\n  }\n\n  // ========== AFSModule Interface Implementation ==========\n\n  /**\n   * List entries at a path\n   */\n  async list(path: string, options?: AFSListOptions): Promise<AFSListResult> {\n    const maxDepth = options?.maxDepth ?? 1;\n\n    // maxDepth=0: return empty array (no children levels to expand)\n    if (maxDepth === 0) {\n      return { data: [] };\n    }\n\n    const normalizedPath = this.normalizePath(path);\n    const match = this.router.match(normalizedPath, \"list\");\n\n    if (!match) {\n      throw new AFSNotFoundError(normalizedPath);\n    }\n\n    const limit = options?.limit;\n    const handleDepth = match.route.listOptions?.handleDepth ?? false;\n\n    if (handleDepth || maxDepth <= 1) {\n      const ctx: RouteContext = {\n        path: normalizedPath,\n        params: match.params,\n        options,\n      };\n\n      const handler = match.route.handler as ListRouteHandler;\n      const handlerResult = await handler(ctx);\n\n      const result: AFSListResult = {\n        data: handlerResult.data,\n        total: handlerResult.total,\n      };\n\n      // Apply limit if specified\n      if (limit !== undefined && result.data.length > limit) {\n        return {\n          data: result.data.slice(0, limit),\n          total: result.total ?? result.data.length,\n        };\n      }\n\n      return result;\n    }\n\n    // Base provider handles depth expansion via BFS\n    return this.listWithDepthExpansion(normalizedPath, options, maxDepth);\n  }\n\n  /**\n   * Expand list results to specified depth using BFS traversal.\n   * Used when handler has handleDepth: false.\n   *\n   * The handler is expected to return single-level results (direct children only).\n   * This method recursively calls the handler to expand directories up to maxDepth.\n   * Pattern filtering is applied after BFS completes to ensure directories are\n   * traversed even if they don't match the pattern.\n   */\n  private async listWithDepthExpansion(\n    basePath: string,\n    options: AFSListOptions | undefined,\n    maxDepth: number,\n  ): Promise<AFSListResult> {\n    const limit = options?.limit ?? 1000;\n    const pattern = options?.pattern;\n\n    const allEntries: AFSEntry[] = [];\n    const visited = new Set<string>();\n\n    // BFS queue: [path, currentDepth]\n    // depth 0 = basePath itself, depth 1 = children, etc.\n    const queue: Array<{ path: string; depth: number }> = [{ path: basePath, depth: 0 }];\n\n    // Track entries before pattern filtering (need more than limit for filtering)\n    const unfilteredEntries: AFSEntry[] = [];\n\n    while (queue.length > 0) {\n      const { path, depth } = queue.shift()!;\n\n      // Prevent infinite loops\n      if (visited.has(path)) continue;\n      visited.add(path);\n\n      // Call handler with depth=1 and WITHOUT pattern to get all entries for expansion\n      const singleLevelOptions: AFSListOptions = {\n        ...options,\n        maxDepth: 1, // Always request single level from handler\n        pattern: undefined, // Don't filter during BFS - filter at end\n      };\n\n      const match = this.router.match(path, \"list\");\n      if (!match) continue;\n\n      const ctx: RouteContext = {\n        path,\n        params: match.params,\n        options: singleLevelOptions,\n      };\n\n      const handler = match.route.handler as ListRouteHandler;\n\n      // Wrap in try-catch to handle files deleted during BFS traversal\n      let result: Awaited<ReturnType<ListRouteHandler>>;\n      try {\n        result = await handler(ctx);\n      } catch (error) {\n        // Ignore not found errors - file may have been deleted during expansion\n        const code = (error as NodeJS.ErrnoException).code;\n        const isNotFound =\n          code === \"ENOENT\" ||\n          code === \"ENOTDIR\" ||\n          (error instanceof Error && error.message.includes(\"not found\"));\n        if (isNotFound) {\n          continue;\n        }\n        throw error;\n      }\n\n      // Collect paths that should not be expanded (internal hint from handler)\n      const noExpandSet = new Set(result.noExpand ?? []);\n\n      // Note: maxChildren is passed to handler via options, so handler applies it to children\n      // We don't apply it again here to avoid double-limiting\n\n      // Add entries to results and queue directories for expansion\n      for (const entry of result.data) {\n        // Skip the current path entry for depth > 0 (it was already added as a child by parent)\n        // At depth 0, include the root entry\n        if (entry.path === path && depth > 0) {\n          continue;\n        }\n\n        unfilteredEntries.push(entry);\n\n        // Queue entry for expansion if:\n        // 1. Within depth limit (depth < maxDepth means we can go one more level)\n        // 2. Entry is a directory (childrenCount > 0 or -1, NOT undefined which means leaf)\n        // 3. Entry is not the current path (which is already being processed)\n        // 4. Entry is not in noExpand set (used for ignored directories)\n        const childrenCount = entry.meta?.childrenCount;\n        const isDirectory = childrenCount !== undefined && childrenCount !== 0;\n        const shouldExpand = !noExpandSet.has(entry.path);\n\n        if (depth < maxDepth - 1 && isDirectory && shouldExpand && entry.path !== path) {\n          queue.push({ path: entry.path, depth: depth + 1 });\n        }\n      }\n    }\n\n    // Apply pattern filtering after BFS completes\n    if (pattern) {\n      for (const entry of unfilteredEntries) {\n        if (allEntries.length >= limit) break;\n        if (this.matchesPattern(entry.path, pattern)) {\n          allEntries.push(entry);\n        }\n      }\n    } else {\n      // No pattern, apply limit directly\n      for (const entry of unfilteredEntries) {\n        if (allEntries.length >= limit) break;\n        allEntries.push(entry);\n      }\n    }\n\n    return {\n      data: allEntries,\n      total: allEntries.length >= limit ? undefined : allEntries.length,\n    };\n  }\n\n  /**\n   * Check if a path matches a glob pattern\n   */\n  private matchesPattern(path: string, pattern: string): boolean {\n    return minimatch(path, pattern, { matchBase: true });\n  }\n\n  /**\n   * Read an entry at a path\n   */\n  async read(path: string, options?: AFSReadOptions): Promise<AFSReadResult> {\n    const normalizedPath = this.normalizePath(path);\n\n    // Handle reading individual action definitions: */.actions/:actionName\n    // This allows providers to expose action details via read() without\n    // needing to define individual read handlers for each action\n    const actionsMatch = normalizedPath.match(/^(.*)\\/\\.actions\\/([^/]+)$/);\n    if (actionsMatch) {\n      const actionsListPath = `${actionsMatch[1] || \"\"}/.actions`;\n      const actionName = actionsMatch[2];\n\n      // Try to find a list handler for the .actions path\n      const listMatch = this.router.match(actionsListPath, \"list\");\n      if (listMatch) {\n        const ctx: RouteContext = {\n          path: actionsListPath,\n          params: listMatch.params,\n          options: {},\n        };\n        const handler = listMatch.route.handler as ListRouteHandler;\n        const result = await handler(ctx);\n\n        // Find the action by name (check summary, id, or meta.name)\n        const actionEntry = result.data.find(\n          (entry) =>\n            entry.summary === actionName ||\n            entry.id === actionName ||\n            entry.id.endsWith(`:${actionName}`) ||\n            entry.meta?.name === actionName,\n        );\n\n        if (actionEntry) {\n          return { data: actionEntry };\n        }\n      }\n    }\n\n    // Standard handler matching\n    const match = this.router.match(normalizedPath, \"read\");\n    if (match) {\n      const ctx: RouteContext = {\n        path: normalizedPath,\n        params: match.params,\n        options,\n      };\n\n      const handler = match.route.handler as ReadRouteHandler;\n      const entry = await handler(ctx);\n\n      return { data: entry };\n    }\n\n    throw new AFSNotFoundError(normalizedPath);\n  }\n\n  /**\n   * Write an entry at a path\n   */\n  async write(\n    path: string,\n    content: AFSWriteEntryPayload,\n    options?: AFSWriteOptions,\n  ): Promise<AFSWriteResult> {\n    if (this.accessMode === \"readonly\") {\n      throw new AFSReadonlyError(\"Cannot write on a readonly provider\");\n    }\n\n    const normalizedPath = this.normalizePath(path);\n    const match = this.router.match(normalizedPath, \"write\");\n\n    if (!match) {\n      throw new Error(`No write handler for path: ${path}`);\n    }\n\n    const ctx: RouteContext = {\n      path: normalizedPath,\n      params: match.params,\n      options,\n    };\n\n    const handler = match.route.handler as WriteRouteHandler;\n    return handler(ctx, content);\n  }\n\n  /**\n   * Delete an entry at a path\n   */\n  async delete(path: string, options?: AFSDeleteOptions): Promise<AFSDeleteResult> {\n    if (this.accessMode === \"readonly\") {\n      throw new AFSReadonlyError(\"Cannot delete on a readonly provider\");\n    }\n\n    const normalizedPath = this.normalizePath(path);\n    const match = this.router.match(normalizedPath, \"delete\");\n\n    if (!match) {\n      throw new Error(`No delete handler for path: ${path}`);\n    }\n\n    const ctx: RouteContext = {\n      path: normalizedPath,\n      params: match.params,\n      options,\n    };\n\n    const handler = match.route.handler as DeleteRouteHandler;\n    return handler(ctx);\n  }\n\n  /**\n   * Search entries at a path\n   */\n  async search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult> {\n    const normalizedPath = this.normalizePath(path);\n    const match = this.router.match(normalizedPath, \"search\");\n\n    if (!match) {\n      return { data: [] };\n    }\n\n    const ctx: RouteContext = {\n      path: normalizedPath,\n      params: match.params,\n      options,\n    };\n\n    const handler = match.route.handler as SearchRouteHandler;\n    return handler(ctx, query, options);\n  }\n\n  /**\n   * Execute an action at a path\n   */\n  async exec(\n    path: string,\n    args: Record<string, unknown>,\n    options?: AFSExecOptions,\n  ): Promise<AFSExecResult> {\n    if (this.accessMode === \"readonly\") {\n      throw new AFSReadonlyError(\"Cannot exec on a readonly provider\");\n    }\n\n    const normalizedPath = this.normalizePath(path);\n    const match = this.router.match(normalizedPath, \"exec\");\n\n    if (!match) {\n      throw new Error(`No exec handler for path: ${path}`);\n    }\n\n    const ctx: RouteContext = {\n      path: normalizedPath,\n      params: match.params,\n      options,\n    };\n\n    const handler = match.route.handler as ExecRouteHandler;\n    return handler(ctx, args);\n  }\n\n  /**\n   * Get stat information for a path\n   *\n   * Note: Fallback to read() is handled at AFS core level, not here.\n   */\n  async stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult> {\n    const normalizedPath = this.normalizePath(path);\n    const match = this.router.match(normalizedPath, \"stat\");\n\n    if (match) {\n      const ctx: RouteContext = {\n        path: normalizedPath,\n        params: match.params,\n        options,\n      };\n\n      const handler = match.route.handler as StatRouteHandler;\n      return handler(ctx);\n    }\n\n    throw new AFSNotFoundError(normalizedPath);\n  }\n\n  /**\n   * Get human-readable explanation for a path\n   *\n   * Note: Fallback to stat() is handled at AFS core level, not here.\n   */\n  async explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult> {\n    const normalizedPath = this.normalizePath(path);\n    const match = this.router.match(normalizedPath, \"explain\");\n\n    if (!match) {\n      throw new Error(`No explain handler for path: ${path}`);\n    }\n\n    const ctx: RouteContext = {\n      path: normalizedPath,\n      params: match.params,\n      options,\n    };\n\n    const handler = match.route.handler as ExplainRouteHandler;\n    return handler(ctx);\n  }\n\n  /**\n   * Rename/move a path\n   */\n  async rename(\n    oldPath: string,\n    newPath: string,\n    options?: AFSRenameOptions,\n  ): Promise<AFSRenameResult> {\n    if (this.accessMode === \"readonly\") {\n      throw new AFSReadonlyError(\"Cannot rename on a readonly provider\");\n    }\n\n    const normalizedPath = this.normalizePath(oldPath);\n    const match = this.router.match(normalizedPath, \"rename\");\n\n    if (!match) {\n      throw new AFSNotFoundError(normalizedPath);\n    }\n\n    const ctx: RouteContext = {\n      path: normalizedPath,\n      params: match.params,\n      options,\n    };\n\n    const handler = match.route.handler as RenameRouteHandler;\n    return handler(ctx, newPath);\n  }\n\n  // ========== Utility Methods ==========\n\n  /**\n   * Normalize a path to ensure consistent format\n   * - Always starts with /\n   * - No trailing slash (except for root)\n   */\n  protected normalizePath(path: string): string {\n    if (!path || path === \"/\") {\n      return \"/\";\n    }\n\n    // Ensure leading slash\n    let normalized = path.startsWith(\"/\") ? path : `/${path}`;\n\n    // Remove trailing slash\n    if (normalized.length > 1 && normalized.endsWith(\"/\")) {\n      normalized = normalized.slice(0, -1);\n    }\n\n    return normalized;\n  }\n\n  /**\n   * Join path segments\n   */\n  protected joinPath(...segments: string[]): string {\n    const joined = segments\n      .map((s) => s.replace(/^\\/+|\\/+$/g, \"\"))\n      .filter(Boolean)\n      .join(\"/\");\n\n    return `/${joined}`;\n  }\n\n  /**\n   * Build an AFSEntry helper\n   *\n   * @param path - The entry path (will be normalized)\n   * @param options - Entry options\n   * @param options.id - Entry ID. Defaults to normalized path if not provided\n   * @param options.content - Entry content\n   * @param options.meta - Entry metadata\n   * @param options.createdAt - Creation time. Undefined if not available from data source\n   * @param options.updatedAt - Last update time. Undefined if not available from data source\n   *\n   * @example\n   * ```typescript\n   * // Simple entry with just path\n   * this.buildEntry(\"/items/1\")\n   *\n   * // Entry with content and metadata\n   * this.buildEntry(\"/items/1\", {\n   *   content: { name: \"Item 1\" },\n   *   meta: { size: 100 },\n   * })\n   *\n   * // Entry with all fields\n   * this.buildEntry(\"/items/1\", {\n   *   id: \"custom-id\",\n   *   content: data,\n   *   meta: { size: stats.size },\n   *   createdAt: stats.birthtime,\n   *   updatedAt: stats.mtime,\n   * })\n   * ```\n   */\n  protected buildEntry(\n    path: string,\n    options?: {\n      id?: string;\n      content?: unknown;\n      meta?: Partial<AFSEntryMetadata>;\n      createdAt?: Date;\n      updatedAt?: Date;\n    },\n  ): AFSEntry {\n    const normalizedPath = this.normalizePath(path);\n    return {\n      id: options?.id ?? normalizedPath,\n      path: normalizedPath,\n      content: options?.content,\n      meta: options?.meta as AFSEntryMetadata,\n      createdAt: options?.createdAt,\n      updatedAt: options?.updatedAt,\n    };\n  }\n\n  /**\n   * Get the router (for testing/debugging)\n   */\n  protected getRouter(): ProviderRouter {\n    return this.router;\n  }\n}\n"],"mappings":"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"}