@jskit-ai/shell-web 0.1.4

package/test/surfaceContext.test.js

@@ -0,0 +1,184 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import {
+  buildSurfaceConfigContext,
+  readPlacementSurfaceConfig,
+  joinSurfacePath,
+  resolveSurfaceIdFromPlacementPathname,
+  resolveSurfaceRootPathFromPlacementContext,
+  resolveSurfacePathFromPlacementContext,
+  resolveSurfaceNavigationTargetFromPlacementContext
+} from "../src/client/placement/surfaceContext.js";
+
+test("buildSurfaceConfigContext normalizes runtime definitions for placement context", () => {
+  const surfaceConfig = buildSurfaceConfigContext(
+    {
+      DEFAULT_SURFACE_ID: "APP",
+      listEnabledSurfaceIds() {
+        return [" APP ", "admin"];
+      },
+      listSurfaceDefinitions() {
+        return [
+          { id: "app", pagesRoot: "", requiresWorkspace: false },
+          { id: "admin", pagesRoot: "w/[workspaceSlug]/admin", requiresWorkspace: true },
+          { id: "console", pagesRoot: "console", requiresWorkspace: false }
+        ];
+      }
+    },
+    {
+      tenancyMode: "workspace"
+    }
+  );
+
+  assert.equal(surfaceConfig.defaultSurfaceId, "app");
+  assert.equal(surfaceConfig.tenancyMode, "workspace");
+  assert.deepEqual(surfaceConfig.enabledSurfaceIds, ["app", "admin"]);
+  assert.deepEqual(surfaceConfig.surfacesById.admin, {
+    id: "admin",
+    pagesRoot: "w/[workspaceSlug]/admin",
+    routeBase: "/w/:workspaceSlug/admin",
+    enabled: true,
+    requiresWorkspace: true
+  });
+  assert.deepEqual(surfaceConfig.surfacesById.console, {
+    id: "console",
+    pagesRoot: "console",
+    routeBase: "/console",
+    enabled: false,
+    requiresWorkspace: false
+  });
+});
+
+test("readPlacementSurfaceConfig normalizes malformed context data", () => {
+  const context = {
+    surfaceConfig: {
+      tenancyMode: "workspace",
+      defaultSurfaceId: " ADMIN ",
+      enabledSurfaceIds: ["admin", "app", "app"],
+      surfacesById: {
+        admin: {
+          id: "ADMIN",
+          pagesRoot: "w/[workspaceSlug]/admin/",
+          requiresWorkspace: true
+        },
+        app: {
+          id: "app",
+          pagesRoot: "",
+          requiresWorkspace: false
+        }
+      }
+    }
+  };
+
+  const surfaceConfig = readPlacementSurfaceConfig(context);
+  assert.equal(surfaceConfig.defaultSurfaceId, "admin");
+  assert.deepEqual(surfaceConfig.enabledSurfaceIds, ["admin", "app"]);
+});
+
+test("surface path helpers compose root and prefixed surface routes", () => {
+  const context = {
+    surfaceConfig: {
+      tenancyMode: "workspace",
+      enabledSurfaceIds: ["app", "home", "console"],
+      surfacesById: {
+        app: {
+          id: "app",
+          pagesRoot: "app",
+          routeBase: "/app",
+          requiresWorkspace: true
+        },
+        home: {
+          id: "home",
+          pagesRoot: "",
+          routeBase: "/",
+          requiresWorkspace: false
+        },
+        console: {
+          id: "console",
+          pagesRoot: "console",
+          routeBase: "/console",
+          requiresWorkspace: false
+        }
+      }
+    }
+  };
+
+  assert.equal(joinSurfacePath("/admin/", "/members/"), "/admin/members");
+  assert.equal(resolveSurfaceIdFromPlacementPathname(context, "/console/settings"), "console");
+  assert.equal(resolveSurfaceIdFromPlacementPathname(context, "/unknown"), "home");
+  assert.equal(resolveSurfaceRootPathFromPlacementContext(context, "app"), "/app");
+  assert.equal(resolveSurfaceRootPathFromPlacementContext(context, "home"), "/");
+  assert.equal(resolveSurfacePathFromPlacementContext(context, "app", "/workspace/settings"), "/app/workspace/settings");
+  assert.equal(resolveSurfacePathFromPlacementContext(context, "home", "members"), "/members");
+});
+
+test("resolveSurfaceIdFromPlacementPathname prefers most specific dynamic surface route base", () => {
+  const context = {
+    surfaceConfig: {
+      defaultSurfaceId: "home",
+      enabledSurfaceIds: ["home", "app", "admin", "console"],
+      surfacesById: {
+        home: { id: "home", pagesRoot: "", routeBase: "/" },
+        app: { id: "app", pagesRoot: "w/[workspaceSlug]", routeBase: "/w/:workspaceSlug" },
+        admin: { id: "admin", pagesRoot: "w/[workspaceSlug]/admin", routeBase: "/w/:workspaceSlug/admin" },
+        console: { id: "console", pagesRoot: "console", routeBase: "/console" }
+      }
+    }
+  };
+
+  assert.equal(resolveSurfaceIdFromPlacementPathname(context, "/"), "home");
+  assert.equal(resolveSurfaceIdFromPlacementPathname(context, "/w/acme"), "app");
+  assert.equal(resolveSurfaceIdFromPlacementPathname(context, "/w/acme/projects"), "app");
+  assert.equal(resolveSurfaceIdFromPlacementPathname(context, "/w/acme/admin"), "admin");
+  assert.equal(resolveSurfaceIdFromPlacementPathname(context, "/w/acme/admin/users"), "admin");
+});
+
+test("resolveSurfaceNavigationTargetFromPlacementContext resolves cross-origin targets from surface config", () => {
+  const context = {
+    surfaceConfig: {
+      defaultSurfaceId: "home",
+      enabledSurfaceIds: ["home", "auth", "account", "app", "admin"],
+      surfacesById: {
+        home: { id: "home", routeBase: "/home", origin: "https://www.example.com" },
+        auth: { id: "auth", routeBase: "/auth", origin: "https://auth.example.com" },
+        account: { id: "account", routeBase: "/account", origin: "https://www.example.com" },
+        app: { id: "app", routeBase: "/w/:workspaceSlug", origin: "https://app.example.com" },
+        admin: { id: "admin", routeBase: "/w/:workspaceSlug/admin", origin: "https://admin.example.com" }
+      }
+    }
+  };
+
+  const sameOriginTarget = resolveSurfaceNavigationTargetFromPlacementContext(context, {
+    path: "/account",
+    currentOrigin: "https://www.example.com"
+  });
+  assert.deepEqual(sameOriginTarget, {
+    href: "/account",
+    sameOrigin: true,
+    surfaceId: "account",
+    external: false
+  });
+
+  const crossOriginTarget = resolveSurfaceNavigationTargetFromPlacementContext(context, {
+    path: "/auth/login",
+    currentOrigin: "https://www.example.com"
+  });
+  assert.deepEqual(crossOriginTarget, {
+    href: "https://auth.example.com/auth/login",
+    sameOrigin: false,
+    surfaceId: "auth",
+    external: false
+  });
+
+  const explicitSurfaceTarget = resolveSurfaceNavigationTargetFromPlacementContext(context, {
+    path: "/w/acme/admin",
+    surfaceId: "admin",
+    currentOrigin: "https://app.example.com"
+  });
+  assert.deepEqual(explicitSurfaceTarget, {
+    href: "https://admin.example.com/w/acme/admin",
+    sameOrigin: false,
+    surfaceId: "admin",
+    external: false
+  });
+});