@postman-cse/onboarding-bootstrap 2.9.9 → 2.9.10

package/dist/action.cjs

@@ -258936,6 +258936,87 @@ var BifrostInternalIntegrationAdapter = class _BifrostInternalIntegrationAdapter
     const advised = adviseFromHttpError(httpErr, this.adviceContext("workspace repository linking"));
     throw advised ?? httpErr;
   }
+  async findWorkspaceForRepo(repoUrl, path10 = "/") {
+    const encodedRepo = encodeURIComponent(repoUrl);
+    const encodedPath = encodeURIComponent(path10);
+    const requestPath2 = `/workspaces/filesystem?repo=${encodedRepo}&path=${encodedPath}`;
+    let response;
+    try {
+      response = await this.proxyRequest("workspaces", "GET", requestPath2);
+    } catch (error2) {
+      return {
+        state: "unknown",
+        reason: error2 instanceof Error ? error2.message : String(error2)
+      };
+    }
+    let bodyText;
+    try {
+      bodyText = await response.text();
+    } catch (error2) {
+      return {
+        state: "unknown",
+        reason: error2 instanceof Error ? error2.message : String(error2)
+      };
+    }
+    let parsed = null;
+    if (bodyText.trim()) {
+      try {
+        parsed = JSON.parse(bodyText);
+      } catch (error2) {
+        return {
+          state: "unknown",
+          reason: error2 instanceof Error ? error2.message : String(error2)
+        };
+      }
+    }
+    const wrappedInvisibleWorkspaceIdRaw = parsed?.error?.meta?.workspaceId;
+    const wrappedInvisibleWorkspaceId = typeof wrappedInvisibleWorkspaceIdRaw === "string" ? wrappedInvisibleWorkspaceIdRaw.trim() : "";
+    if (wrappedInvisibleWorkspaceId) {
+      return { state: "linked-invisible", workspaceId: wrappedInvisibleWorkspaceId };
+    }
+    if (response.status === 200) {
+      if (!parsed || !Object.prototype.hasOwnProperty.call(parsed, "data")) {
+        return {
+          state: "unknown",
+          reason: "Filesystem probe returned 200 without a data payload"
+        };
+      }
+      const data = parsed?.data ?? null;
+      if (data == null) {
+        return { state: "free" };
+      }
+      if (typeof data === "object" && !Array.isArray(data)) {
+        const workspace = data;
+        const id = typeof workspace.id === "string" ? workspace.id.trim() : "";
+        if (id) {
+          const name = typeof workspace.name === "string" ? workspace.name : "";
+          return {
+            state: "linked-visible",
+            workspace: { ...workspace, id, name }
+          };
+        }
+      }
+      return {
+        state: "unknown",
+        reason: "Filesystem probe returned 200 with unrecognized workspace payload"
+      };
+    }
+    if (response.status === 403) {
+      const workspaceIdRaw = parsed?.error?.meta?.workspaceId ?? parsed?.meta?.workspaceId;
+      const workspaceId = typeof workspaceIdRaw === "string" ? workspaceIdRaw.trim() : "";
+      if (workspaceId) {
+        return { state: "linked-invisible", workspaceId };
+      }
+      return {
+        state: "unknown",
+        reason: "Filesystem probe returned 403 without error.meta.workspaceId"
+      };
+    }
+    return {
+      state: "unknown",
+      reason: `Filesystem probe returned HTTP ${response.status}`
+    };
+  }
   async linkCollectionsToSpecification(specificationId, collections) {
     if (collections.length === 0) {
       return;
@@ -312653,7 +312734,28 @@ async function provisionWorkspace(inputs, dependencies, telemetry, outputs, reso
   }
   telemetry.setTeamId(teamId);
   const repoUrl = inputs.repoUrl || "";
-  if (!explicitWorkspaceId && repoUrl && inputs.postmanAccessToken && teamId) {
+  if (repoUrl && dependencies.internalIntegration?.findWorkspaceForRepo) {
+    const probe = await dependencies.internalIntegration.findWorkspaceForRepo(repoUrl);
+    if (probe.state === "linked-invisible") {
+      const orgTail = inputs.workspaceTeamId ? " Verify workspace-team-id; if the owner is in another sub-team, ask that sub-team's admin to disconnect it." : "";
+      throw new Error(
+        `REPOSITORY_LINK_CONFLICT_INVISIBLE: Repository ${repoUrl} at path / is linked to workspace ${probe.workspaceId}, but these credentials cannot view it. No Postman assets were changed. Ask its owner or a team admin to disconnect it.${orgTail}`
+      );
+    }
+    if (probe.state === "linked-visible") {
+      workspaceId = probe.workspace.id;
+      workspaceMutationOwned = true;
+      const nameSuffix = probe.workspace.name ? ` ("${probe.workspace.name}")` : "";
+      dependencies.core.info(
+        `Repository ${repoUrl} at path / is already linked to workspace ${probe.workspace.id}${nameSuffix}; adopting it as the canonical workspace.`
+      );
+    } else if (probe.state === "unknown") {
+      dependencies.core.warning(
+        `Repository link preflight could not determine ownership for ${repoUrl}: ${probe.reason}. Continuing with normal workspace selection.`
+      );
+    }
+  }
+  if (!workspaceId && repoUrl && inputs.postmanAccessToken && teamId) {
     const selection = await runGroup(
       dependencies.core,
       "Resolve Canonical Workspace",

package/dist/cli.cjs

@@ -257254,6 +257254,87 @@ var BifrostInternalIntegrationAdapter = class _BifrostInternalIntegrationAdapter
     const advised = adviseFromHttpError(httpErr, this.adviceContext("workspace repository linking"));
     throw advised ?? httpErr;
   }
+  async findWorkspaceForRepo(repoUrl, path8 = "/") {
+    const encodedRepo = encodeURIComponent(repoUrl);
+    const encodedPath = encodeURIComponent(path8);
+    const requestPath2 = `/workspaces/filesystem?repo=${encodedRepo}&path=${encodedPath}`;
+    let response;
+    try {
+      response = await this.proxyRequest("workspaces", "GET", requestPath2);
+    } catch (error) {
+      return {
+        state: "unknown",
+        reason: error instanceof Error ? error.message : String(error)
+      };
+    }
+    let bodyText;
+    try {
+      bodyText = await response.text();
+    } catch (error) {
+      return {
+        state: "unknown",
+        reason: error instanceof Error ? error.message : String(error)
+      };
+    }
+    let parsed = null;
+    if (bodyText.trim()) {
+      try {
+        parsed = JSON.parse(bodyText);
+      } catch (error) {
+        return {
+          state: "unknown",
+          reason: error instanceof Error ? error.message : String(error)
+        };
+      }
+    }
+    const wrappedInvisibleWorkspaceIdRaw = parsed?.error?.meta?.workspaceId;
+    const wrappedInvisibleWorkspaceId = typeof wrappedInvisibleWorkspaceIdRaw === "string" ? wrappedInvisibleWorkspaceIdRaw.trim() : "";
+    if (wrappedInvisibleWorkspaceId) {
+      return { state: "linked-invisible", workspaceId: wrappedInvisibleWorkspaceId };
+    }
+    if (response.status === 200) {
+      if (!parsed || !Object.prototype.hasOwnProperty.call(parsed, "data")) {
+        return {
+          state: "unknown",
+          reason: "Filesystem probe returned 200 without a data payload"
+        };
+      }
+      const data = parsed?.data ?? null;
+      if (data == null) {
+        return { state: "free" };
+      }
+      if (typeof data === "object" && !Array.isArray(data)) {
+        const workspace = data;
+        const id = typeof workspace.id === "string" ? workspace.id.trim() : "";
+        if (id) {
+          const name = typeof workspace.name === "string" ? workspace.name : "";
+          return {
+            state: "linked-visible",
+            workspace: { ...workspace, id, name }
+          };
+        }
+      }
+      return {
+        state: "unknown",
+        reason: "Filesystem probe returned 200 with unrecognized workspace payload"
+      };
+    }
+    if (response.status === 403) {
+      const workspaceIdRaw = parsed?.error?.meta?.workspaceId ?? parsed?.meta?.workspaceId;
+      const workspaceId = typeof workspaceIdRaw === "string" ? workspaceIdRaw.trim() : "";
+      if (workspaceId) {
+        return { state: "linked-invisible", workspaceId };
+      }
+      return {
+        state: "unknown",
+        reason: "Filesystem probe returned 403 without error.meta.workspaceId"
+      };
+    }
+    return {
+      state: "unknown",
+      reason: `Filesystem probe returned HTTP ${response.status}`
+    };
+  }
   async linkCollectionsToSpecification(specificationId, collections) {
     if (collections.length === 0) {
       return;
@@ -310879,7 +310960,28 @@ async function provisionWorkspace(inputs, dependencies, telemetry, outputs, reso
   }
   telemetry.setTeamId(teamId);
   const repoUrl = inputs.repoUrl || "";
-  if (!explicitWorkspaceId && repoUrl && inputs.postmanAccessToken && teamId) {
+  if (repoUrl && dependencies.internalIntegration?.findWorkspaceForRepo) {
+    const probe = await dependencies.internalIntegration.findWorkspaceForRepo(repoUrl);
+    if (probe.state === "linked-invisible") {
+      const orgTail = inputs.workspaceTeamId ? " Verify workspace-team-id; if the owner is in another sub-team, ask that sub-team's admin to disconnect it." : "";
+      throw new Error(
+        `REPOSITORY_LINK_CONFLICT_INVISIBLE: Repository ${repoUrl} at path / is linked to workspace ${probe.workspaceId}, but these credentials cannot view it. No Postman assets were changed. Ask its owner or a team admin to disconnect it.${orgTail}`
+      );
+    }
+    if (probe.state === "linked-visible") {
+      workspaceId = probe.workspace.id;
+      workspaceMutationOwned = true;
+      const nameSuffix = probe.workspace.name ? ` ("${probe.workspace.name}")` : "";
+      dependencies.core.info(
+        `Repository ${repoUrl} at path / is already linked to workspace ${probe.workspace.id}${nameSuffix}; adopting it as the canonical workspace.`
+      );
+    } else if (probe.state === "unknown") {
+      dependencies.core.warning(
+        `Repository link preflight could not determine ownership for ${repoUrl}: ${probe.reason}. Continuing with normal workspace selection.`
+      );
+    }
+  }
+  if (!workspaceId && repoUrl && inputs.postmanAccessToken && teamId) {
     const selection = await runGroup(
       dependencies.core,
       "Resolve Canonical Workspace",

package/dist/index.cjs

@@ -258961,6 +258961,87 @@ var BifrostInternalIntegrationAdapter = class _BifrostInternalIntegrationAdapter
     const advised = adviseFromHttpError(httpErr, this.adviceContext("workspace repository linking"));
     throw advised ?? httpErr;
   }
+  async findWorkspaceForRepo(repoUrl, path10 = "/") {
+    const encodedRepo = encodeURIComponent(repoUrl);
+    const encodedPath = encodeURIComponent(path10);
+    const requestPath2 = `/workspaces/filesystem?repo=${encodedRepo}&path=${encodedPath}`;
+    let response;
+    try {
+      response = await this.proxyRequest("workspaces", "GET", requestPath2);
+    } catch (error2) {
+      return {
+        state: "unknown",
+        reason: error2 instanceof Error ? error2.message : String(error2)
+      };
+    }
+    let bodyText;
+    try {
+      bodyText = await response.text();
+    } catch (error2) {
+      return {
+        state: "unknown",
+        reason: error2 instanceof Error ? error2.message : String(error2)
+      };
+    }
+    let parsed = null;
+    if (bodyText.trim()) {
+      try {
+        parsed = JSON.parse(bodyText);
+      } catch (error2) {
+        return {
+          state: "unknown",
+          reason: error2 instanceof Error ? error2.message : String(error2)
+        };
+      }
+    }
+    const wrappedInvisibleWorkspaceIdRaw = parsed?.error?.meta?.workspaceId;
+    const wrappedInvisibleWorkspaceId = typeof wrappedInvisibleWorkspaceIdRaw === "string" ? wrappedInvisibleWorkspaceIdRaw.trim() : "";
+    if (wrappedInvisibleWorkspaceId) {
+      return { state: "linked-invisible", workspaceId: wrappedInvisibleWorkspaceId };
+    }
+    if (response.status === 200) {
+      if (!parsed || !Object.prototype.hasOwnProperty.call(parsed, "data")) {
+        return {
+          state: "unknown",
+          reason: "Filesystem probe returned 200 without a data payload"
+        };
+      }
+      const data = parsed?.data ?? null;
+      if (data == null) {
+        return { state: "free" };
+      }
+      if (typeof data === "object" && !Array.isArray(data)) {
+        const workspace = data;
+        const id = typeof workspace.id === "string" ? workspace.id.trim() : "";
+        if (id) {
+          const name = typeof workspace.name === "string" ? workspace.name : "";
+          return {
+            state: "linked-visible",
+            workspace: { ...workspace, id, name }
+          };
+        }
+      }
+      return {
+        state: "unknown",
+        reason: "Filesystem probe returned 200 with unrecognized workspace payload"
+      };
+    }
+    if (response.status === 403) {
+      const workspaceIdRaw = parsed?.error?.meta?.workspaceId ?? parsed?.meta?.workspaceId;
+      const workspaceId = typeof workspaceIdRaw === "string" ? workspaceIdRaw.trim() : "";
+      if (workspaceId) {
+        return { state: "linked-invisible", workspaceId };
+      }
+      return {
+        state: "unknown",
+        reason: "Filesystem probe returned 403 without error.meta.workspaceId"
+      };
+    }
+    return {
+      state: "unknown",
+      reason: `Filesystem probe returned HTTP ${response.status}`
+    };
+  }
   async linkCollectionsToSpecification(specificationId, collections) {
     if (collections.length === 0) {
       return;
@@ -312681,7 +312762,28 @@ async function provisionWorkspace(inputs, dependencies, telemetry, outputs, reso
   }
   telemetry.setTeamId(teamId);
   const repoUrl = inputs.repoUrl || "";
-  if (!explicitWorkspaceId && repoUrl && inputs.postmanAccessToken && teamId) {
+  if (repoUrl && dependencies.internalIntegration?.findWorkspaceForRepo) {
+    const probe = await dependencies.internalIntegration.findWorkspaceForRepo(repoUrl);
+    if (probe.state === "linked-invisible") {
+      const orgTail = inputs.workspaceTeamId ? " Verify workspace-team-id; if the owner is in another sub-team, ask that sub-team's admin to disconnect it." : "";
+      throw new Error(
+        `REPOSITORY_LINK_CONFLICT_INVISIBLE: Repository ${repoUrl} at path / is linked to workspace ${probe.workspaceId}, but these credentials cannot view it. No Postman assets were changed. Ask its owner or a team admin to disconnect it.${orgTail}`
+      );
+    }
+    if (probe.state === "linked-visible") {
+      workspaceId = probe.workspace.id;
+      workspaceMutationOwned = true;
+      const nameSuffix = probe.workspace.name ? ` ("${probe.workspace.name}")` : "";
+      dependencies.core.info(
+        `Repository ${repoUrl} at path / is already linked to workspace ${probe.workspace.id}${nameSuffix}; adopting it as the canonical workspace.`
+      );
+    } else if (probe.state === "unknown") {
+      dependencies.core.warning(
+        `Repository link preflight could not determine ownership for ${repoUrl}: ${probe.reason}. Continuing with normal workspace selection.`
+      );
+    }
+  }
+  if (!workspaceId && repoUrl && inputs.postmanAccessToken && teamId) {
     const selection = await runGroup(
       dependencies.core,
       "Resolve Canonical Workspace",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman-cse/onboarding-bootstrap",
-  "version": "2.9.9",
+  "version": "2.9.10",
   "description": "Bootstrap Postman workspaces, specs, and collections from OpenAPI.",
   "type": "module",
   "main": "dist/index.cjs",