@sanity/workbench 0.1.0-alpha.6 → 0.1.0-alpha.7

package/src/core/user-applications/studio.test.ts

@@ -0,0 +1,928 @@
+import type {
+  StudioApplication as StudioApplicationApiResponse,
+  // eslint-disable-next-line no-restricted-imports
+  StudioResource as ProtocolStudioResource,
+} from "@sanity/message-protocol";
+import { afterEach, describe, expect, expectTypeOf, vi, it } from "vitest";
+
+import {
+  MULTIPLE_WORKSPACE_STUDIO_DATA,
+  PROJECTS,
+  SINGLE_WORKSPACE_STUDIO_DATA,
+} from "../__tests__/__fixtures__";
+import type { ProjectId } from "../projects";
+import { StudioApplication, StudioWorkspace } from "./studio";
+import { brandUserApplicationId } from "./user-application";
+
+describe("StudioApplication", () => {
+  afterEach(() => {
+    vi.unstubAllEnvs();
+  });
+
+  const setup = (application?: StudioApplicationApiResponse) =>
+    new StudioApplication(
+      {
+        ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+        ...application,
+        manifest: null,
+      },
+      PROJECTS,
+    );
+
+  it("should have a list of studio workspaces", () => {
+    const studio = setup();
+
+    expect(studio.workspaces).toHaveLength(8);
+    expect(studio.workspaces[0]).toBeInstanceOf(StudioWorkspace);
+  });
+
+  it("should supply me a default workspace if the application has no manifest", () => {
+    const studio = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      manifestData: null,
+    });
+
+    expect(studio.workspaces).toHaveLength(1);
+    expectTypeOf(studio.workspaces).toEqualTypeOf<readonly StudioWorkspace[]>();
+    expect(studio.workspaces[0]).toBeInstanceOf(StudioWorkspace);
+
+    // @ts-expect-error - workspace is protected but we want to test the snapshot for default values
+    expect(studio.workspaces[0].workspace).toMatchInlineSnapshot(`
+        {
+          "basePath": "/",
+          "name": "default",
+          "projectId": "hzao7xsp",
+          "title": "Default",
+        }
+      `);
+    expect(studio.workspaces[0].href).toMatchInlineSnapshot(
+      `"/studio/75affa24c862a372764ceb40/default"`,
+    );
+  });
+
+  it("should supply me a default workspace if the application has a manifest but no workspaces", () => {
+    const studio = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      manifestData: {
+        value: {
+          ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+          workspaces: [],
+        },
+      },
+    });
+
+    expect(studio.workspaces).toHaveLength(1);
+    expectTypeOf(studio.workspaces).toEqualTypeOf<readonly StudioWorkspace[]>();
+    expect(studio.workspaces[0]).toBeInstanceOf(StudioWorkspace);
+
+    // @ts-expect-error - workspace is protected but we want to test the snapshot for default values
+    expect(studio.workspaces[0].workspace).toMatchInlineSnapshot(`
+        {
+          "basePath": "/",
+          "name": "default",
+          "projectId": "hzao7xsp",
+          "title": "Default",
+        }
+      `);
+    expect(studio.workspaces[0].href).toMatchInlineSnapshot(
+      `"/studio/75affa24c862a372764ceb40/default"`,
+    );
+  });
+
+  it("should have type of studio", () => {
+    const studio = setup();
+
+    expect(studio.type).toBe("studio");
+  });
+
+  it("should use the first workspace title as the title if it does not have multiple workspaces", () => {
+    const studio = setup();
+
+    expect(studio.title).toBe(studio.workspaces[0].title);
+  });
+
+  it("should use the project display name as the title and urlType is internal", () => {
+    const studio = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      urlType: "internal",
+    });
+
+    expect(studio.title).toBe("Customer 360");
+  });
+
+  it("should use the application title when set, regardless of workspace count or urlType", () => {
+    const customTitle = "My Custom Studio";
+
+    // Single workspace, internal
+    const singleInternal = setup({
+      ...SINGLE_WORKSPACE_STUDIO_DATA,
+      title: customTitle,
+    });
+    expect(singleInternal.title).toBe(customTitle);
+
+    // Multiple workspaces, external
+    const multiExternal = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      title: customTitle,
+    });
+    expect(multiExternal.title).toBe(customTitle);
+
+    // Multiple workspaces, internal (would normally fall back to project.displayName)
+    const multiInternal = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      urlType: "internal",
+      title: customTitle,
+    });
+    expect(multiInternal.title).toBe(customTitle);
+  });
+
+  it("should fall back to workspace/project title when application title is null", () => {
+    // External with multiple workspaces and no application title -> first workspace title
+    const externalStudio = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      title: null,
+    });
+    expect(externalStudio.title).toBe(externalStudio.workspaces[0].title);
+
+    // Internal with multiple workspaces and no application title -> project displayName
+    const internalStudio = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      urlType: "internal",
+      title: null,
+    });
+    expect(internalStudio.title).toBe("Customer 360");
+  });
+
+  it("should return the hostname as the subtitle", () => {
+    vi.stubEnv("VITE_SANITY_ENV", "staging");
+    vi.stubEnv("VITE_SANITY_DOMAIN", "sanity.work");
+    const studio = setup();
+    expect(studio.subtitle).toBe("360.sanity.build");
+  });
+
+  it("should allow you to get attributes from the application", () => {
+    const studio = setup();
+
+    expect(studio.get("title")).toBe(null);
+    expect(studio.get("urlType")).toBe("external");
+    expectTypeOf(studio.get("urlType")).toEqualTypeOf<
+      "internal" | "external"
+    >();
+    expect(studio.get("appHost")).toBe("https://360.sanity.build");
+    expectTypeOf(studio.get("appHost")).toEqualTypeOf<string>();
+  });
+
+  it("should throw when accessing a non-existent attribute", () => {
+    const studio = setup();
+    expect(() =>
+      // @ts-expect-error - testing invalid attribute
+      studio.get("nonExistent"),
+    ).toThrow(
+      `Attribute nonExistent does not exist on studio ${MULTIPLE_WORKSPACE_STUDIO_DATA.id}`,
+    );
+  });
+
+  it("should throw when project is not found for the application", () => {
+    expect(
+      () =>
+        new StudioApplication(
+          {
+            ...SINGLE_WORKSPACE_STUDIO_DATA,
+            projectId: "non-existing-project",
+          },
+          PROJECTS,
+        ),
+    ).toThrow(
+      `Project not found for application ${SINGLE_WORKSPACE_STUDIO_DATA.id}`,
+    );
+  });
+
+  it("should fall back to deployment manifest workspaces when main manifest has no workspaces", () => {
+    vi.spyOn(console, "warn").mockImplementation(() => {});
+
+    const studio = setup({
+      ...SINGLE_WORKSPACE_STUDIO_DATA,
+      manifestData: {
+        value: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+          workspaces: [],
+        },
+      },
+      activeDeployment: {
+        ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment!,
+        manifest: {
+          workspaces: [
+            {
+              name: "from-deployment",
+              title: "From Deployment",
+              basePath: "/from-deployment",
+              projectId: "c16r74n4",
+              dataset: "production",
+              schemaDescriptorId: "test.json",
+            },
+          ],
+        },
+      },
+    });
+
+    expect(studio.workspaces).toHaveLength(1);
+    expect(studio.workspaces[0].title).toBe("From Deployment");
+  });
+
+  it("should throw an error if the studio application is converted to a protocol resource", () => {
+    const studio = setup();
+    expect(() => studio.toProtocolResource()).toThrow(
+      "Studio application resources cannot be converted to protocol resources",
+    );
+  });
+
+  it("should return a value for hasManifest", () => {
+    const studio = setup();
+    expect(studio.hasManifest).toBe(true);
+  });
+
+  it("should return a value for hasSchema", () => {
+    const studio = setup();
+    expect(studio.hasSchema).toBe(true);
+  });
+
+  it("should return true for hasSchema, even though the user does not have access to any workspaces", () => {
+    const studio = setup({
+      ...SINGLE_WORKSPACE_STUDIO_DATA,
+      manifestData: {
+        value: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+          workspaces: [
+            {
+              ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value.workspaces[0],
+              projectId: "non-existing-project",
+            },
+          ],
+        },
+      },
+    });
+
+    expect(studio.hasSchema).toBe(true);
+  });
+
+  it("should return false for hasSchema, without any workspaces", () => {
+    const studio = setup({
+      ...SINGLE_WORKSPACE_STUDIO_DATA,
+      manifestData: {
+        value: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+          workspaces: [],
+        },
+      },
+    });
+
+    expect(studio.hasSchema).toBe(false);
+  });
+
+  describe("version", () => {
+    it("should return the activeDeployment version if the studio is internal", () => {
+      const version = "4.9.0";
+
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          version,
+        },
+      });
+
+      expect(studio.version).toBe(version);
+    });
+
+    it("should return the manifest studioVersion if the studio is external", () => {
+      const studioVersion = "4.9.0";
+
+      const studio = setup({
+        ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+        manifestData: {
+          value: {
+            ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+            version: 3,
+            studioVersion,
+          },
+        },
+      });
+
+      expect(studio.version).toBe(studioVersion);
+    });
+
+    it("should return the deployment-manifest bundleVersion if the studio has no version in the manifest", () => {
+      const bundleVersion = "4.9.0";
+
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        manifestData: {
+          value: {
+            ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+            version: 2,
+          },
+        },
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          manifest: {
+            bundleVersion,
+          },
+        },
+        config: {},
+      });
+
+      expect(studio.version).toBe(bundleVersion);
+    });
+
+    it("should return the live-manifest bundleVersion if the studio is external and the live-manifest version is greater than the manifest version", () => {
+      const studioVersion = "4.9.0";
+      const bundleVersion = "5.0.0";
+
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          manifest: {
+            bundleVersion,
+          },
+        },
+        manifestData: {
+          value: {
+            ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+            version: 3,
+            studioVersion,
+          },
+        },
+        config: {},
+      });
+
+      expect(studio.version).toBe(bundleVersion);
+    });
+
+    it("should return null if the version is not a valid semver", () => {
+      const studio = setup({
+        ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+        manifestData: {
+          value: {
+            ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+            version: 3,
+            studioVersion: "invalid",
+          },
+        },
+      });
+
+      expect(studio.version).toBeNull();
+    });
+
+    it("should return null if its an external studio and the manifest does not have a studioVersion", () => {
+      const studio = setup(MULTIPLE_WORKSPACE_STUDIO_DATA);
+      expect(studio.version).toBeNull();
+    });
+  });
+
+  describe("compatability status", () => {
+    it('should return "unknown" if the version is unknown or less than the minimum version', () => {
+      expect(setup(MULTIPLE_WORKSPACE_STUDIO_DATA).compatibilityStatus).toBe(
+        "unknown",
+      );
+
+      expect(
+        setup({ ...MULTIPLE_WORKSPACE_STUDIO_DATA, manifest: null })
+          .compatibilityStatus,
+      ).toBe("unknown");
+
+      // Studio with version below minimum (2.28.0)
+      expect(
+        setup({
+          ...SINGLE_WORKSPACE_STUDIO_DATA,
+          activeDeployment: {
+            ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+            version: "2.0.0",
+          },
+        }).compatibilityStatus,
+      ).toBe("unknown");
+    });
+
+    it("should return partially compatible if the schema is missing or the manifest is missing or the issues are not empty", () => {
+      expect(
+        setup({
+          ...SINGLE_WORKSPACE_STUDIO_DATA,
+          manifestData: {
+            value: {
+              ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+              workspaces: [],
+            },
+          },
+        }).compatibilityStatus,
+      ).toBe("partially-compatible");
+
+      expect(
+        setup({
+          ...SINGLE_WORKSPACE_STUDIO_DATA,
+          activeDeployment: {
+            ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+            version: "3.70.0", // Below ACTIVITY and FAVORITES (3.88.1)
+          },
+        }).compatibilityStatus,
+      ).toBe("partially-compatible");
+    });
+
+    it("should return fully compatible if the schema is present, the manifest is present and the issues are empty", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          version: StudioApplication.MinimumStudioVersionWithNoIssues!,
+        },
+      });
+      expect(studio.compatibilityStatus).toBe("fully-compatible");
+    });
+  });
+
+  describe("issues", () => {
+    it("should return an empty array if the studio is fully compatible", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          version: StudioApplication.MinimumStudioVersionWithNoIssues!,
+        },
+      });
+      expect(studio.issues).toHaveLength(0);
+    });
+
+    it("should return an array of issues if the studio is partially compatible", () => {
+      // Version 3.70.0 is below ACTIVITY (3.88.1), FAVORITES (3.88.1), URL_SYNCING (3.75.0), UI_ADJUSTMENT (3.78.1)
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          version: "3.70.0",
+        },
+      });
+
+      const issueIds = studio.issues.map((issue) => issue.id);
+      expect(issueIds).toContain("ACTIVITY");
+      expect(issueIds).toContain("FAVORITES");
+      expect(issueIds).toContain("URL_SYNCING");
+      expect(issueIds).toContain("UI_ADJUSTMENT");
+      expect(issueIds).not.toContain("CONTENT_MAPPING"); // 3.68.0
+      expect(issueIds).not.toContain("LOGIN"); // 2.28.0
+    });
+
+    it("should include the manifest issue if the manifest is missing", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        manifestData: null,
+      });
+
+      const issueIds = studio.issues.map((issue) => issue.id);
+      expect(issueIds).toContain("MANIFEST");
+    });
+  });
+
+  describe("MINIMUM_STUDIO_NO_ISSUES_VERSION", () => {
+    it("should equal the highest version required by Studio features", () => {
+      expect(
+        StudioApplication.MinimumStudioVersionWithNoIssues,
+      ).toMatchInlineSnapshot(`"5.1.0"`);
+    });
+  });
+
+  it("should delegate to isAutoRedirecting resolveIsAutoRedirecting", () => {
+    const studio = setup({
+      ...SINGLE_WORKSPACE_STUDIO_DATA,
+      activeDeployment: {
+        ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+        version: "4.0.0",
+      },
+    });
+
+    expect(studio.isAutoRedirecting).toBe(
+      StudioApplication.resolveIsAutoRedirecting(studio),
+    );
+  });
+
+  describe("resolveIsAutoRedirecting", () => {
+    it("should return false for external studios", () => {
+      const studio = setup(MULTIPLE_WORKSPACE_STUDIO_DATA);
+      expect(StudioApplication.resolveIsAutoRedirecting(studio)).toBe(false);
+    });
+
+    it("should return false when no version can be determined", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        activeDeployment: null,
+      });
+      expect(StudioApplication.resolveIsAutoRedirecting(studio)).toBe(false);
+    });
+
+    it.each(["latest", "next", "stable"])(
+      'should return true for auto-updating studios using autoUpdatingVersion of "%s"',
+      (autoUpdatingVersion) => {
+        const studio = setup({
+          ...SINGLE_WORKSPACE_STUDIO_DATA,
+          autoUpdatingVersion,
+          activeDeployment: {
+            ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+            isAutoUpdating: true,
+            version: "4.0.0",
+          },
+        });
+        expect(StudioApplication.resolveIsAutoRedirecting(studio)).toBe(true);
+      },
+    );
+
+    it("should return true if version is higher than MinimumStudioVersion", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        autoUpdatingVersion: "3.0.0",
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          isAutoUpdating: true,
+          version: "3.0.0",
+        },
+      });
+      expect(StudioApplication.resolveIsAutoRedirecting(studio)).toBe(true);
+    });
+
+    it("should return false if version is equal or lower than MinimumStudioVersion", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        autoUpdatingVersion: "2.0.0",
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          isAutoUpdating: true,
+          version: "2.0.0",
+        },
+      });
+      expect(StudioApplication.resolveIsAutoRedirecting(studio)).toBe(false);
+    });
+
+    it("should fall through to version comparison when autoUpdatingVersion is null and auto-updating", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        autoUpdatingVersion: null,
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          isAutoUpdating: true,
+          version: "4.0.0",
+        },
+      });
+      expect(StudioApplication.resolveIsAutoRedirecting(studio)).toBe(true);
+    });
+
+    it("should use custom version argument when provided for non-auto-updating studios", () => {
+      const studio = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        activeDeployment: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.activeDeployment,
+          isAutoUpdating: false,
+          version: "4.0.0",
+        },
+      });
+      // Default behavior returns true for version > 3.92.0
+      expect(StudioApplication.resolveIsAutoRedirecting(studio)).toBe(true);
+      // When passing a custom version below 3.92.0, it should return false
+      expect(StudioApplication.resolveIsAutoRedirecting(studio, "3.0.0")).toBe(
+        false,
+      );
+    });
+  });
+
+  it("should remove any workspaces where the project is not found", () => {
+    // supress the console.warn
+    vi.spyOn(console, "warn").mockImplementation(() => {});
+
+    const application = {
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      manifestData: {
+        value: {
+          ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+          workspaces: [
+            {
+              ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value
+                .workspaces[0],
+              projectId: "zvy7mysv",
+            },
+            ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value.workspaces.slice(
+              1,
+            ),
+          ],
+        },
+      },
+    } satisfies StudioApplicationApiResponse;
+
+    const studio = setup(application);
+
+    expect(studio.workspaces).toHaveLength(7);
+    studio.workspaces.forEach((workspace) => {
+      expect(workspace.title).not.toBe(
+        MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value.workspaces[0].title,
+      );
+    });
+  });
+
+  it("should return a default workspace if the application has workspaces with no matching projects", () => {
+    const PROJECT_ID = "zvy7mysv";
+
+    // supress the console.warn
+    vi.spyOn(console, "warn").mockImplementation(() => {});
+
+    const application = {
+      ...SINGLE_WORKSPACE_STUDIO_DATA,
+      manifestData: {
+        value: {
+          ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+          workspaces: [
+            {
+              ...SINGLE_WORKSPACE_STUDIO_DATA.manifestData.value.workspaces[0],
+              projectId: PROJECT_ID,
+            },
+          ],
+        },
+      },
+    } satisfies StudioApplicationApiResponse;
+
+    const studio = setup(application);
+
+    const project = PROJECTS.find(
+      (p) => p.id === SINGLE_WORKSPACE_STUDIO_DATA.projectId,
+    );
+
+    expect(PROJECTS.find((p) => p.id === PROJECT_ID)).toBeUndefined();
+    expect(studio.workspaces[0].project.id).toBe(project?.id);
+    expect(studio.workspaces[0].title).toBe(project?.displayName);
+    expect(studio.title).toBe(project?.displayName);
+  });
+});
+
+describe("StudioWorkspace", () => {
+  const setup = (application?: StudioApplicationApiResponse) =>
+    new StudioApplication(
+      {
+        ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+        ...application,
+      },
+      PROJECTS,
+    );
+
+  it("should have a type of workspace", () => {
+    const workspace = setup().workspaces[1];
+
+    expect(workspace.type).toBe("workspace");
+  });
+
+  it("should have a href of <studio>/<id>/<workspace-name>", () => {
+    const workspace = setup().workspaces[1];
+
+    expect(workspace.href).toMatchInlineSnapshot(
+      `"/studio/75affa24c862a372764ceb40/operations-gateway"`,
+    );
+  });
+
+  it("should have a name property", () => {
+    const workspace = setup().workspaces[1];
+
+    expect(workspace.get("name")).toBe("operations-gateway");
+  });
+
+  it("should use its own title if it is not the default", () => {
+    const workspace = setup().workspaces[1];
+
+    expect(workspace.title).toBe("Operations Gateway");
+  });
+
+  it("should return the workspace subtitle for non-default workspaces", () => {
+    const workspace = setup().workspaces[1];
+
+    expect(workspace.subtitle).toBeUndefined();
+  });
+
+  it("should return the hostname as subtitle for default workspaces with internal appHost", () => {
+    vi.stubEnv("VITE_SANITY_ENV", "staging");
+    vi.stubEnv("VITE_SANITY_DOMAIN", "sanity.work");
+    const workspace = setup({
+      ...SINGLE_WORKSPACE_STUDIO_DATA,
+      manifestData: null,
+    }).workspaces[0];
+
+    expect(workspace.subtitle).toBe("sanity-home.studio.sanity.work");
+  });
+
+  it("should use appHost directly as subtitle when it is a valid URL", () => {
+    const workspace = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      manifestData: null,
+    }).workspaces[0];
+
+    expect(workspace.subtitle).toBe("360.sanity.build");
+  });
+
+  it("should deduplicate basePath when appHost already contains it", () => {
+    const workspace = setup({
+      ...MULTIPLE_WORKSPACE_STUDIO_DATA,
+      appHost: "https://my-studio.com/admin",
+      manifestData: {
+        value: {
+          ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value,
+          workspaces: [
+            {
+              ...MULTIPLE_WORKSPACE_STUDIO_DATA.manifestData.value
+                .workspaces[0],
+              basePath: "/admin",
+            },
+          ],
+        },
+      },
+    }).workspaces[0];
+
+    expect(workspace.url.pathname).toBe("/admin");
+  });
+
+  it("should allow you to get attributes from the application", () => {
+    const workspace = setup().workspaces[1];
+
+    expect(workspace.get("basePath")).toBe("/operations-gateway");
+    expectTypeOf(workspace.get("basePath")).toEqualTypeOf<string>();
+    expect(workspace.get("projectId")).toBe("hzao7xsp");
+    expectTypeOf(workspace.get("projectId")).toEqualTypeOf<ProjectId>();
+    expect(workspace.get("dataset")).toBe("production");
+    expectTypeOf(workspace.get("dataset")).toEqualTypeOf<string | undefined>();
+  });
+
+  describe("single workspace studio", () => {
+    it("should use the title of the workspace if the parent application has a manifest", () => {
+      const workspace = setup(SINGLE_WORKSPACE_STUDIO_DATA).workspaces[0];
+
+      expect(workspace.title).toBe("Sanity Home");
+    });
+
+    it("should use the hostname of the project display name if the parent application does not have a manifest", () => {
+      const workspace = setup({
+        ...SINGLE_WORKSPACE_STUDIO_DATA,
+        manifestData: null,
+      }).workspaces[0];
+
+      expect(workspace.title).toBe("Sanity Home");
+    });
+
+    it("should have a href of <studio>/<id>/<workspace-name>", () => {
+      const workspace = setup(SINGLE_WORKSPACE_STUDIO_DATA).workspaces[0];
+      expect(workspace.href).toMatchInlineSnapshot(
+        `"/studio/0092b48439cd2aa19de05c2c/default"`,
+      );
+    });
+
+    it("should have a name property", () => {
+      const workspace = setup(SINGLE_WORKSPACE_STUDIO_DATA).workspaces[0];
+      expect(workspace.get("name")).toBe("default");
+    });
+  });
+
+  it("splitId - should split the id by the first hyphen", () => {
+    expect(StudioWorkspace.splitId("app-workspace")).toEqual([
+      "app",
+      "workspace",
+    ]);
+    expect(StudioWorkspace.splitId("app-workspace-test")).toEqual([
+      "app",
+      "workspace-test",
+    ]);
+  });
+
+  it("makeId - should concatonate the strings with a hyphen", () => {
+    const appId = brandUserApplicationId("app");
+    expect(StudioWorkspace.makeId(appId, "workspace")).toBe("app-workspace");
+    expect(StudioWorkspace.makeId(appId, "workspace-test")).toBe(
+      "app-workspace-test",
+    );
+  });
+
+  it("should implement the toProtocolResource method", () => {
+    const workspace = setup().workspaces[1];
+    expect(workspace.toProtocolResource()).toMatchInlineSnapshot(`
+      {
+        "activeDeployment": null,
+        "autoUpdatingVersion": null,
+        "basePath": "/operations-gateway",
+        "config": {},
+        "dashboardStatus": "default",
+        "dataset": "production",
+        "hasManifest": true,
+        "hasSchema": true,
+        "href": "/studio/75affa24c862a372764ceb40/operations-gateway",
+        "icon": "<svg width="50" height="49" viewBox="0 0 50 49" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="50" height="49" fill="#FFCC32"></rect><path d="M30.5 36.6667V33C30.5 31.5413 29.9205 30.1424 28.8891 29.1109C27.8576 28.0795 26.4587 27.5 25 27.5C23.5413 27.5 22.1424 28.0795 21.1109 29.1109C20.0795 30.1424 19.5 31.5413 19.5 33V36.6667C19.5 37.1529 19.3068 37.6192 18.963 37.963C18.6192 38.3068 18.1529 38.5 17.6667 38.5H10.3333C9.8471 38.5 9.38079 38.3068 9.03697 37.963C8.69315 37.6192 8.5 37.1529 8.5 36.6667V11H15.8333V16.5H21.3333V11H28.6667V16.5H34.1667V11H41.5V36.6667C41.5 37.1529 41.3068 37.6192 40.963 37.963C40.6192 38.3068 40.1529 38.5 39.6667 38.5H32.3333C31.8471 38.5 31.3808 38.3068 31.037 37.963C30.6932 37.6192 30.5 37.1529 30.5 36.6667Z" fill="white" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M8.5 22H41.5Z" fill="white"></path><path d="M8.5 22H41.5" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path></svg>",
+        "id": "75affa24c862a372764ceb40-operations-gateway",
+        "manifest": {
+          "createdAt": "2025-11-19T07:59:25.943Z",
+          "version": 2,
+          "workspaces": [
+            {
+              "basePath": "/360",
+              "dataset": "production",
+              "icon": "<svg width="50" height="50" viewBox="0 0 50 50" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="50" height="50" fill="#FF5500"></rect><path d="M8.5 25C8.5 27.1668 8.92678 29.3124 9.75599 31.3143C10.5852 33.3161 11.8006 35.1351 13.3327 36.6673C14.8649 38.1994 16.6839 39.4148 18.6857 40.244C20.6876 41.0732 22.8332 41.5 25 41.5C27.1668 41.5 29.3124 41.0732 31.3143 40.244C33.3161 39.4148 35.1351 38.1994 36.6673 36.6673C38.1994 35.1351 39.4148 33.3161 40.244 31.3143C41.0732 29.3124 41.5 27.1668 41.5 25C41.5 22.8332 41.0732 20.6876 40.244 18.6857C39.4148 16.6839 38.1994 14.8649 36.6673 13.3327C35.1351 11.8006 33.3161 10.5852 31.3143 9.75599C29.3124 8.92679 27.1668 8.5 25 8.5C22.8332 8.5 20.6876 8.92679 18.6857 9.75599C16.6839 10.5852 14.8649 11.8006 13.3327 13.3327C11.8006 14.8649 10.5852 16.6839 9.75599 18.6857C8.92678 20.6876 8.5 22.8332 8.5 25Z" fill="white" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M17.666 25C17.666 29.3761 18.4386 33.5729 19.8139 36.6673C21.1892 39.7616 23.0544 41.5 24.9993 41.5C26.9443 41.5 28.8095 39.7616 30.1848 36.6673C31.5601 33.5729 32.3327 29.3761 32.3327 25C32.3327 20.6239 31.5601 16.4271 30.1848 13.3327C28.8095 10.2384 26.9443 8.5 24.9993 8.5C23.0544 8.5 21.1892 10.2384 19.8139 13.3327C18.4386 16.4271 17.666 20.6239 17.666 25Z" fill="white" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M8.5 25.0003C8.5 29.052 15.8883 32.3337 25 32.3337C34.1117 32.3337 41.5 29.052 41.5 25.0003C41.5 20.9487 34.1117 17.667 25 17.667C15.8883 17.667 8.5 20.9487 8.5 25.0003Z" fill="white" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M17.666 25C17.666 29.3761 18.4386 33.5729 19.8139 36.6673C21.1892 39.7616 23.0544 41.5 24.9993 41.5C26.9443 41.5 28.8095 39.7616 30.1848 36.6673C31.5601 33.5729 32.3327 29.3761 32.3327 25C32.3327 20.6239 31.5601 16.4271 30.1848 13.3327C28.8095 10.2384 26.9443 8.5 24.9993 8.5C23.0544 8.5 21.1892 10.2384 19.8139 13.3327C18.4386 16.4271 17.666 20.6239 17.666 25Z" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path></svg>",
+              "name": "explorer",
+              "projectId": "hzao7xsp",
+              "schema": "cd26d36b.create-schema.json",
+              "title": "Customer 360",
+              "tools": "d7989384.create-tools.json",
+            },
+            {
+              "basePath": "/operations-gateway",
+              "dataset": "production",
+              "icon": "<svg width="50" height="49" viewBox="0 0 50 49" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="50" height="49" fill="#FFCC32"></rect><path d="M30.5 36.6667V33C30.5 31.5413 29.9205 30.1424 28.8891 29.1109C27.8576 28.0795 26.4587 27.5 25 27.5C23.5413 27.5 22.1424 28.0795 21.1109 29.1109C20.0795 30.1424 19.5 31.5413 19.5 33V36.6667C19.5 37.1529 19.3068 37.6192 18.963 37.963C18.6192 38.3068 18.1529 38.5 17.6667 38.5H10.3333C9.8471 38.5 9.38079 38.3068 9.03697 37.963C8.69315 37.6192 8.5 37.1529 8.5 36.6667V11H15.8333V16.5H21.3333V11H28.6667V16.5H34.1667V11H41.5V36.6667C41.5 37.1529 41.3068 37.6192 40.963 37.963C40.6192 38.3068 40.1529 38.5 39.6667 38.5H32.3333C31.8471 38.5 31.3808 38.3068 31.037 37.963C30.6932 37.6192 30.5 37.1529 30.5 36.6667Z" fill="white" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M8.5 22H41.5Z" fill="white"></path><path d="M8.5 22H41.5" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path></svg>",
+              "name": "operations-gateway",
+              "projectId": "hzao7xsp",
+              "schema": "cd26d36b.create-schema.json",
+              "title": "Operations Gateway",
+              "tools": "f63673b7.create-tools.json",
+            },
+            {
+              "basePath": "/finder",
+              "dataset": "production",
+              "icon": "<svg width="50" height="50" viewBox="0 0 50 50" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="50" height="50" fill="#D6EDFF"></rect><rect x="12.2959" y="11.7402" width="25.41" height="13.86" fill="white"></rect><path d="M23.0732 11.356H26.9232Z" fill="white"></path><path d="M23.0732 11.356H26.9232" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path><path d="M38.4734 24.8306C37.1895 35.0966 33.9824 40.2306 28.8484 40.2306H21.1484C16.0145 40.2306 12.8074 35.0966 11.5234 24.8306" fill="white"></path><path d="M38.4734 24.8306C37.1895 35.0966 33.9824 40.2306 28.8484 40.2306H21.1484C16.0145 40.2306 12.8074 35.0966 11.5234 24.8306" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path><path d="M23.0732 32.5303C23.0732 33.8142 23.7143 34.4553 24.9982 34.4553C26.2822 34.4553 26.9232 33.8142 26.9232 32.5303H23.0732Z" fill="white" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path><path d="M24.999 36.3804V40.2304Z" fill="white"></path><path d="M24.999 36.3804V40.2304" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path><path d="M21.1494 22.9058V22.9241Z" fill="white"></path><path d="M21.1494 22.9058V22.9241" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path><path d="M28.8486 22.9058V22.9241Z" fill="white"></path><path d="M28.8486 22.9058V22.9241" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path><path d="M11.5239 9.43018L23.0739 11.2974L11.0657 24.1718C10.7284 24.551 10.2575 24.7849 9.7516 24.8248C9.24568 24.8646 8.74398 24.7072 8.35148 24.3855C8.08529 24.1689 7.88519 23.882 7.77392 23.5574C7.66265 23.2327 7.64466 22.8834 7.72201 22.549L11.5239 9.43018Z" fill="white" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path><path d="M38.4748 9.43018L26.9248 11.2974L38.933 24.1718C39.6221 24.9572 40.8368 25.0535 41.6472 24.3855C41.9134 24.1689 42.1135 23.882 42.2248 23.5574C42.336 23.2327 42.354 22.8834 42.2767 22.549L38.4748 9.43018Z" fill="white" stroke="black" stroke-width="3.85" stroke-linecap="round" stroke-linejoin="round"></path></svg>",
+              "name": "finder",
+              "projectId": "hzao7xsp",
+              "schema": "cd26d36b.create-schema.json",
+              "title": "Finder",
+              "tools": "790d30d6.create-tools.json",
+            },
+            {
+              "basePath": "/radar",
+              "dataset": "production",
+              "icon": "<svg viewBox="0 0 50 50" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="50" height="50" fill="#CDEA19"></rect><path d="M41.4925 24.9818H26.8258C26.8258 24.6192 26.7183 24.2647 26.5169 23.9632C26.3154 23.6617 26.0291 23.4268 25.6941 23.288C25.3591 23.1492 24.9905 23.1129 24.6348 23.1837C24.2792 23.2544 23.9525 23.429 23.6962 23.6854C23.4398 23.9418 23.2651 24.2685 23.1944 24.6241C23.1237 24.9797 23.16 25.3484 23.2987 25.6834C23.4375 26.0184 23.6725 26.3047 23.974 26.5061C24.2755 26.7076 24.6299 26.8151 24.9925 26.8151V41.4818C29.3686 41.4818 33.5654 39.7434 36.6598 36.649C39.7541 33.5547 41.4925 29.3578 41.4925 24.9818Z" fill="white" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M32.3252 19.4821C31.5372 18.4314 30.5326 17.5624 29.3795 16.9337C28.2264 16.3051 26.9517 15.9316 25.6417 15.8385C24.3317 15.7454 23.0169 15.9349 21.7865 16.3941C20.5561 16.8534 19.4387 17.5716 18.5101 18.5003C17.5814 19.4289 16.8631 20.5463 16.4039 21.7767C15.9446 23.0072 15.7552 24.3219 15.8483 25.6319C15.9414 26.9419 16.3149 28.2167 16.9435 29.3698C17.5721 30.5229 18.4412 31.5274 19.4919 32.3154" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M40.55 19.4821C39.6182 16.8561 38.0365 14.5088 35.9524 12.6592C33.8683 10.8096 31.3498 9.51795 28.6317 8.90464C25.9136 8.29133 23.0845 8.37637 20.4081 9.15184C17.7317 9.9273 15.2953 11.3679 13.3261 13.3393C11.3569 15.3108 9.91908 17.7488 9.14665 20.426C8.37422 23.1033 8.29238 25.9325 8.90876 28.6499C9.52514 31.3673 10.8197 33.8844 12.6716 35.9664C14.5236 38.0483 16.8726 39.6274 19.4997 40.5562" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path></svg>",
+              "name": "radar",
+              "projectId": "hzao7xsp",
+              "schema": "cd26d36b.create-schema.json",
+              "title": "Radar",
+              "tools": "6e3a5662.create-tools.json",
+            },
+            {
+              "basePath": "/atlas",
+              "dataset": "production",
+              "icon": "<svg width="50" height="49" viewBox="0 0 50 49" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="50" height="49" fill="#40E8AF"></rect><path d="M17.667 31.8332L21.3337 20.8332L32.3337 17.1665L28.667 28.1665L17.667 31.8332Z" fill="white" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M8.5 24.5C8.5 26.6668 8.92678 28.8124 9.75599 30.8143C10.5852 32.8161 11.8006 34.6351 13.3327 36.1673C14.8649 37.6994 16.6839 38.9148 18.6857 39.744C20.6876 40.5732 22.8332 41 25 41C27.1668 41 29.3124 40.5732 31.3143 39.744C33.3161 38.9148 35.1351 37.6994 36.6673 36.1673C38.1994 34.6351 39.4148 32.8161 40.244 30.8143C41.0732 28.8124 41.5 26.6668 41.5 24.5C41.5 22.3332 41.0732 20.1876 40.244 18.1857C39.4148 16.1839 38.1994 14.3649 36.6673 12.8327C35.1351 11.3006 33.3161 10.0852 31.3143 9.25599C29.3124 8.42679 27.1668 8 25 8C22.8332 8 20.6876 8.42679 18.6857 9.25599C16.6839 10.0852 14.8649 11.3006 13.3327 12.8327C11.8006 14.3649 10.5852 16.1839 9.75599 18.1857C8.92678 20.1876 8.5 22.3332 8.5 24.5Z" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M25 8V11.6667" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M25 37.3335V41.0002" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M8.5 24.5H12.1667" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path><path d="M37.833 24.5H41.4997" stroke="black" stroke-width="3.66667" stroke-linecap="round" stroke-linejoin="round"></path></svg>",
+              "name": "atlas",
+              "projectId": "hzao7xsp",
+              "schema": "b0fefb08.create-schema.json",
+              "title": "Atlas",
+              "tools": "9597875e.create-tools.json",
+            },
+            {
+              "basePath": "/resources",
+              "dataset": "production",
+              "icon": "<svg stroke="currentColor" fill="none" stroke-width="2" viewBox="0 0 24 24" stroke-linecap="round" stroke-linejoin="round" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg"><path d="M3 19a9 9 0 0 1 9 0a9 9 0 0 1 9 0"></path><path d="M3 6a9 9 0 0 1 9 0a9 9 0 0 1 9 0"></path><path d="M3 6l0 13"></path><path d="M12 6l0 13"></path><path d="M21 6l0 13"></path></svg>",
+              "name": "resources",
+              "projectId": "hzao7xsp",
+              "schema": "b0fefb08.create-schema.json",
+              "title": "Resource Center",
+              "tools": "c704250f.create-tools.json",
+            },
+            {
+              "basePath": "/data",
+              "dataset": "production",
+              "icon": "<svg stroke="currentColor" fill="none" stroke-width="2" viewBox="0 0 24 24" stroke-linecap="round" stroke-linejoin="round" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg"><path d="M9 5h-2a2 2 0 0 0 -2 2v12a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-12a2 2 0 0 0 -2 -2h-2"></path><path d="M9 3m0 2a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v0a2 2 0 0 1 -2 2h-2a2 2 0 0 1 -2 -2z"></path><path d="M9 17v-4"></path><path d="M12 17v-1"></path><path d="M15 17v-2"></path><path d="M12 17v-1"></path></svg>",
+              "name": "data",
+              "projectId": "hzao7xsp",
+              "schema": "b0fefb08.create-schema.json",
+              "title": "Data Hub",
+              "tools": "08382af6.create-tools.json",
+            },
+            {
+              "basePath": "/operations",
+              "dataset": "production",
+              "icon": "<svg stroke="currentColor" fill="none" stroke-width="2" viewBox="0 0 24 24" stroke-linecap="round" stroke-linejoin="round" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg"><path d="M12 8a2 2 0 0 1 2 2v4a2 2 0 1 1 -4 0v-4a2 2 0 0 1 2 -2"></path><path d="M17 15c.345 .6 1.258 1 2 1a2 2 0 1 0 0 -4a2 2 0 1 1 0 -4c.746 0 1.656 .394 2 1"></path><path d="M3 15c.345 .6 1.258 1 2 1a2 2 0 1 0 0 -4a2 2 0 1 1 0 -4c.746 0 1.656 .394 2 1"></path></svg>",
+              "name": "operations",
+              "projectId": "hzao7xsp",
+              "schema": "cd26d36b.create-schema.json",
+              "title": "SupportOS™",
+              "tools": "a6046e2d.create-tools.json",
+            },
+          ],
+        },
+        "name": "operations-gateway",
+        "projectId": "hzao7xsp",
+        "schema": "cd26d36b.create-schema.json",
+        "title": "Operations Gateway",
+        "tools": "f63673b7.create-tools.json",
+        "type": "studio",
+        "updatedAt": "2025-05-06T20:12:05.955Z",
+        "url": "https://360.sanity.build/",
+        "urlType": "external",
+        "userApplicationId": "75affa24c862a372764ceb40",
+        "version": undefined,
+      }
+    `);
+
+    expectTypeOf(
+      workspace.toProtocolResource(),
+    ).toEqualTypeOf<ProtocolStudioResource>();
+  });
+
+  it("should be able to access the studio application", () => {
+    const studioApplication = setup();
+    const workspace = studioApplication.workspaces[0];
+
+    expect(workspace.studio).toBe(studioApplication);
+  });
+});