yoi/web/workspace/tests/workdir-api.test.ts

declare const Deno: {
  test(name: string, fn: () => void | Promise<void>): void;
};

import {
  parseWorkingDirectoryCreateResponse,
  parseWorkingDirectoryDetailResponse,
  parseWorkingDirectoryListResponse,
  validateWorkingDirectoryCreateRequest,
} from "../src/lib/workspace/api/workdirs.ts";

const summary = {
  working_directory_id: "workdir-1",
  display_name: "Checkout",
  source: { kind: "repository", repository_key: "main" },
  materializer_kind: "runtime_git_clone",
  status: "active",
  occupied_by: {
    runtime_id: "arcadia",
    worker_id: "worker-1",
    display_name: "Coder",
    linked_at: "2026-01-01T00:00:00Z",
  },
};

Deno.test("logical config Workdir source preserves WIP metadata without filesystem authority", () => {
  const source = { kind: "workspace_config", access: "read_only", content_path: "/workspace-config", purpose: "Workspace configuration" };
  const response = (source: unknown) => ({ workspace_id: "workspace-a", item: {
    working_directory_id: "config-1", source, materializer_kind: "logical_workspace_config", status: "active",
  }, diagnostics: [] });
  const detail = parseWorkingDirectoryDetailResponse(response(source));
  if (JSON.stringify(detail.item.source) !== JSON.stringify(source) || detail.runtime_id !== undefined) {
    throw new Error("logical config identity was lost or acquired a fake Runtime");
  }
  for (const invalid of [
    { ...source, access: "command" }, { ...source, content_path: "/home/config" },
    { ...source, grant_id: "external-grant" }, { ...source, repository_key: "main" },
    { ...source, token: "secret" }, { kind: "repository", repository_key: "main", access: "read_write" },
  ]) {
    let rejected = false;
    try { parseWorkingDirectoryDetailResponse(response(invalid)); } catch { rejected = true; }
    if (!rejected) throw new Error("mixed or unsafe source metadata was accepted");
  }
});

Deno.test("Workdir REST validation accepts the generated list and create contracts", () => {
  const list = parseWorkingDirectoryListResponse({
    workspace_id: "workspace-a",
    items: [summary],
    diagnostics: [],
  });
  if (list.items[0]?.display_name !== "Checkout") {
    throw new Error("display name was not preserved");
  }
  if (list.items[0]?.occupied_by?.runtime_id !== "arcadia") {
    throw new Error("occupancy subject was not preserved");
  }

  const created = parseWorkingDirectoryCreateResponse({
    workspace_id: "workspace-a",
    runtime_id: "arcadia",
    item: summary,
    diagnostics: [],
  });
  if (created.runtime_id !== "arcadia") {
    throw new Error("create Runtime was not preserved");
  }
});

Deno.test("Workdir REST validation accepts External grant sources without Runtime identity", () => {
  const detail = parseWorkingDirectoryDetailResponse({
    workspace_id: "workspace-a",
    item: {
      working_directory_id: "external-1",
      display_name: "Session analysis",
      source: {
        kind: "external_grant",
        grant_id: "grant-1",
        grant_permissions: { read: true, write: true, command: true },
      },
      materializer_kind: "client_hosted_external",
      status: "active",
      cleanliness: "unknown",
    },
    diagnostics: [],
  });
  if (detail.runtime_id !== undefined) {
    throw new Error("External Workdir acquired a fake Runtime identity");
  }
  if (detail.item.source.kind !== "external_grant") {
    throw new Error("External Workdir source was not preserved");
  }
  if (
    !detail.item.source.grant_permissions.read ||
    !detail.item.source.grant_permissions.write ||
    !detail.item.source.grant_permissions.command
  ) {
    throw new Error("External Workdir grant permissions were not preserved");
  }
});

Deno.test("Workdir REST validation rejects missing or misplaced External grant permissions", () => {
  for (
    const source of [
      { kind: "external_grant", grant_id: "grant-1" },
      {
        kind: "external_grant",
        grant_id: "grant-1",
        grant_permissions: { read: false, write: false, command: true },
      },
      {
        kind: "external_grant",
        grant_id: "grant-1",
        grant_permissions: { read: true, write: false, command: "yes" },
      },
      {
        kind: "repository",
        repository_key: "main",
        grant_permissions: { read: true, write: false, command: false },
      },
    ]
  ) {
    let rejected = false;
    try {
      parseWorkingDirectoryDetailResponse({
        workspace_id: "workspace-a",
        item: {
          working_directory_id: "invalid-1",
          source,
          materializer_kind: source.kind === "repository"
            ? "runtime_git_clone"
            : "client_hosted_external",
          status: "active",
        },
        diagnostics: [],
      });
    } catch {
      rejected = true;
    }
    if (!rejected) {
      throw new Error(
        `invalid External permission projection was accepted: ${
          JSON.stringify(source)
        }`,
      );
    }
  }
});

Deno.test("Workdir REST validation rejects stale response JSON", () => {
  let rejected = false;
  try {
    parseWorkingDirectoryListResponse({
      workspace_id: "workspace-a",
      items: [summary],
      diagnostics: [],
      source: "legacy-runtime",
    });
  } catch {
    rejected = true;
  }
  if (!rejected) throw new Error("stale response field was accepted");
});

Deno.test("Workdir REST validation enforces create operation fields", () => {
  const request = validateWorkingDirectoryCreateRequest({
    runtime_id: "arcadia",
    display_name: "Review checkout",
    repository_key: "main",
    selector: "develop",
    operation_id: "operation-1",
  });
  if (request.operation_id !== "operation-1") {
    throw new Error("operation id was not preserved");
  }
  if (request.display_name !== "Review checkout") {
    throw new Error("display name was not preserved");
  }

  for (
    const invalid of [
      { runtime_id: "arcadia", operation_id: "operation-1" },
      { repository_key: "main", operation_key: "operation-1" },
    ]
  ) {
    let rejected = false;
    try {
      validateWorkingDirectoryCreateRequest(invalid);
    } catch {
      rejected = true;
    }
    if (!rejected) {
      throw new Error(
        `invalid request was accepted: ${JSON.stringify(invalid)}`,
      );
    }
  }
});