/**
 * Palantir Foundry Filesystem API.
 * Folders, resources, and spaces.
 *
 * Base paths:
 *   - Folders:    /api/v2/filesystem/folders/
 *   - Resources:  /api/v2/filesystem/resources/
 *   - Spaces:     /api/v2/filesystem/spaces
 *
 * All filesystem endpoints require preview=true query parameter.
 * Folder children use /children endpoint (NOT /contents).
 * Resource lookup by path uses /getByPath endpoint.
 *
 * @see https://www.palantir.com/docs/foundry/api/v2/filesystem-v2-resources/
 */

import type { PalantirClient } from "./client.js";
import type { Folder, Resource, CreateFolderParams, PageResponse, PageParams } from "./types.js";

/** A Foundry space (project or space). */
export interface Space {
  rid: string;
  displayName?: string;
  description?: string;
  spaceType?: string;
}

export class FilesystemNamespace {
  constructor(private client: PalantirClient) {}

  // ─── Folders ────────────────────────────────────────────────────
  // All endpoints require preview=true

  /** Get a folder by RID. */
  async getFolder(folderRid: string): Promise<Folder> {
    return this.client.get(
      `/api/v2/filesystem/folders/${folderRid}`,
      { preview: true } as Record<string, unknown>
    );
  }

  /** Create a folder. */
  async createFolder(params: CreateFolderParams): Promise<Folder> {
    return this.client.post(
      "/api/v2/filesystem/folders?preview=true",
      params
    );
  }

  /** List children of a folder. */
  async listFolderChildren(
    folderRid: string,
    params?: PageParams
  ): Promise<PageResponse<Resource>> {
    return this.client.get(
      `/api/v2/filesystem/folders/${folderRid}/children`,
      { ...params, preview: true } as Record<string, unknown>
    );
  }

  // ─── Resources ──────────────────────────────────────────────────

  /** Get a resource by RID. */
  async getResource(resourceRid: string): Promise<Resource> {
    return this.client.get(
      `/api/v2/filesystem/resources/${resourceRid}`,
      { preview: true } as Record<string, unknown>
    );
  }

  /** Get a resource by its full path. */
  async getResourceByPath(
    path: string,
    params?: { domainTag?: string }
  ): Promise<Resource> {
    return this.client.get(
      "/api/v2/filesystem/resources/getByPath",
      { path, ...params, preview: true } as Record<string, unknown>
    );
  }

  /** Delete a resource. */
  async deleteResource(resourceRid: string): Promise<void> {
    return this.client.delete(
      `/api/v2/filesystem/resources/${resourceRid}?preview=true`
    );
  }

  // ─── Spaces ─────────────────────────────────────────────────────

  /** List spaces (projects). */
  async listSpaces(params?: PageParams): Promise<PageResponse<Space>> {
    return this.client.get(
      "/api/v2/filesystem/spaces",
      { ...params, preview: true } as Record<string, unknown>
    );
  }
}