Function createAppFileApi

apps/webuiapps/src/lib/fileApi.ts:319–392

(appName: string)

 * @param appName Application identifier (e.g. 'twitter'), used to build the cloud path prefix
 */
export function createAppFileApi(appName: string): FileOperations {
  const basePath = `apps/${appName}/data`;

  /**
   * Convert internal path to cloud path
   *   "/" → "/apps/twitter/data"
   *   "/posts/tweet.json" → "/apps/twitter/data/posts/tweet.json"
   */
  const toCloudPath = (internalPath: string): string => {
    const normalized = normalizePath(internalPath);
    return normalized === '/' ? `/${basePath}` : `/${basePath}${normalized}`;
  };

  return {
    /**
     * List files (single level)
     * Cloud path is prefixed; returned FileNode.path remains in internal format
     */
    listFiles: async (path = '/'): Promise<FileNode[]> => {
      const manager = getClientComManager();
      const normalizedPath = normalizePath(path);

      // Internal directory path (without prefix), used to build returned FileNode.path
      const internalDirPath = path === '/' ? '' : normalizedPath.replace(/^\//, '');
      // Cloud directory path (with prefix), used for API requests
      const cloudDirPath = internalDirPath ? `${basePath}/${internalDirPath}` : basePath;

      const startTime = ts();
      const t0 = performance.now();
      const result = await manager.listFiles<CloudListResponse>({ path: cloudDirPath });
      console.info(
        `[FileApi:${appName}][${startTime}] listFiles "${path}" — ${(performance.now() - t0).toFixed(1)}ms`,
      );

      if (!result || result.not_exists || !result.files) {
        return [];
      }

      return result.files.map((entry) => {
        // entry.path may be a full cloud path (e.g. "apps/twitter/data/posts"),
        // a session-prefixed path (e.g. "charId/modId/apps/twitter/data/posts"),
        // or a relative name (e.g. "posts"). Extract the entry name relative to the current directory.
        let entryName = entry.path;
        const cloudDirSuffix = `${cloudDirPath}/`;
        const suffixIndex = entryName.indexOf(cloudDirSuffix);
        if (suffixIndex !== -1) {
          entryName = entryName.slice(suffixIndex + cloudDirSuffix.length);
        }

        // Build FileNode.path using internal path (without prefix)
        const fullPath = normalizePath(
          internalDirPath ? `/${internalDirPath}/${entryName}` : `/${entryName}`,
        );
        const isFolder = entry.type === 1;

        return {
          id: '',
          name: entryName,