@stack-spot/portal-network 0.201.0 → 0.202.0-beta.1

package/src/api-addresses.ts

@@ -1,3 +1,4 @@
+import { APIMap } from '@stack-spot/opa'
 import apisItauJson from './apis-itau.json' assert { type: 'json' }
 import apisJson from './apis.json' assert { type: 'json' }
 import { NetworkClient } from './network/NetworkClient'
@@ -5,26 +6,29 @@ import { Env, Tenant } from './network/types'
 
 type ApisKeys = keyof typeof apisJson;
 
+type APIName = APIMap[string]
+type ExceptionAPIName = Exclude<APIName, keyof Apis>
+
+declare global {
+  interface ImportMeta {
+    readonly env: {
+      VITE_NETWORK_OVERRIDES: string,
+      DEV: boolean,
+      PROD: boolean,
+    },
+  }
+}
+
 type ApiConfig = {
   url: Record<Env, string>,
   docs?: string,
 }
 
-type PartialApiConfig = {
-  url: Partial<Record<Env, string>>,
-  docs?: string
-}
-
 type Apis = Record<ApisKeys, ApiConfig>;
 
-type PartialApis = Partial<Record<ApisKeys, PartialApiConfig>>;
-
-type ApiAddress = {
-  [api: string]: string,
-}
+type ApiAddress = Record<ApisKeys, string>
 
-let defaultApis: Apis = apisJson;
-let overrideApis: PartialApis = {};
+const defaultApis: Apis = apisJson
 
 const apis: Record<Tenant, Apis> = {
   'stackspot': apisJson,
@@ -37,12 +41,12 @@ const apis: Record<Tenant, Apis> = {
  * @param tenant The current tenant (e.g., 'stackspot', 'itau').
  * @returns API catalog containing the URLs per environment.
  */
-export function getApisByTenant(tenant: Tenant) {
+function getApisByTenant(tenant: Tenant) {
   return apis[tenant]
 }
 
 function transformApisToApiAddress(apis: Apis, env: Env): ApiAddress {
-  const apiAddress: ApiAddress = {}
+  const apiAddress = {} as ApiAddress
 
   for (const api in apis) {
     const key = api as ApisKeys
@@ -59,14 +63,28 @@ function transformApisToApiAddress(apis: Apis, env: Env): ApiAddress {
  * @returns {boolean} true if the URL is found, otherwise false.
  */
 function matchesBaseUrl(baseUrl: Record<Env, string>, candidate: Record<Env, string>): boolean {
-  const envs: Env[] = ['dev', 'stg', 'prd'];
+  const envs: Env[] = ['dev', 'stg', 'prd']
 
   return envs.every(e => {
     if (candidate[e]) {
-      return baseUrl[e] === candidate[e];
+      return baseUrl[e] === candidate[e]
     }
-    return true;
-  });
+    return true
+  })
+}
+
+const getApiOverride = () => {
+  const envs = import.meta.env
+
+  let overrideAPIsURL = {} as ApiAddress
+  if (envs.PROD) return overrideAPIsURL
+
+  try {
+    overrideAPIsURL= JSON.parse(envs.VITE_NETWORK_OVERRIDES)
+    return overrideAPIsURL
+  } catch {
+    return overrideAPIsURL
+  }
 }
 
 /**
@@ -77,44 +95,82 @@ function matchesBaseUrl(baseUrl: Record<Env, string>, candidate: Record<Env, str
  * @param tenant the current tenant.
  * @returns {string} the base URL for the given environment and tenant, applying any overrides if available.
  */
-export const getBaseUrlByTenantWithOverride = (baseUrl: Record<Env, string>, targetEnv: Env = 'prd', tenant: Tenant = 'stackspot'): string => {
-  let matchesApiName: ApisKeys | null = null;
+export const getBaseUrlByTenantWithOverride = (baseUrl: Record<Env, string>, targetEnv: Env = 'prd',
+  tenant: Tenant = 'stackspot'): string => {
+  let matchesApiName: ApisKeys | null = null
 
   for (const [apiName, config] of Object.entries(defaultApis) as [ApisKeys, ApiConfig][]) {
     if (matchesBaseUrl(baseUrl, config.url)) {
-      matchesApiName = apiName;
-      break;
+      matchesApiName = apiName
+      break
     }
   }
 
   if (!matchesApiName) return ''
 
-  const overrideUrl = overrideApis[matchesApiName]?.url?.[targetEnv]
-  if (overrideUrl) {
-    return overrideUrl;
-  }
-
+  const overrides = getApiOverride()
   const apis = getApisByTenant(tenant)
-  return apis[matchesApiName]?.url?.[targetEnv];
+  const api = apis[matchesApiName]
+  return overrides?.[matchesApiName] ?? api?.url?.[targetEnv]
 }
 
-/**
- * Sets the APIs addresses for override.
- * @param customApis a JSON object containing APIs address to override.
- */
-export const setApisOverride = (customApis: PartialApis) => {
-  overrideApis = customApis;
+export const getApisBaseUrlConfig = (env: Env = 'prd', tenant: Tenant = 'stackspot'): ApiAddress => {
+  const overrides = getApiOverride()
+  const apis = getApisByTenant(tenant)
+  const apiMap = {} as ApiAddress
+  
+  for (const [key, value] of Object.entries(apis)) {
+    if (value?.url && value.url?.[env]) {
+      const url = value.url[env]
+      const api = key as ApisKeys
+      apiMap[api] = url
+    }
+  }
+
+  return { ...apiMap, ...overrides }
 }
 
+
 /**
  * Sets the default APIs addresses for each environments.
  * @returns {Apis} an object containing APIs URLs grouped by api name and enviroments.
  */
-export const getApiAddresses = (): Apis => {
-  return defaultApis;
-}
+export const getApiAddresses = (): Apis => defaultApis
 
 export const apiAddresses = () => {
   const env = NetworkClient.getEnv()
   return transformApisToApiAddress(defaultApis, env)
 }
+
+const networkApiNameToOpaApiName = {
+  ai: 'code-buddy',
+  dataIntegration: 'data-integration',
+  workspaceManager: 'workspace-manager',
+  cloudServices: 'cloud-services',
+  cloudAccount: 'cloud-account',
+  cloudPlatformHorizon: 'cloud-platform-horizon',
+  codeShift: 'code-shift',
+  genAiInference: 'ai-inference',
+  apiRuntime: 'runtime-manager',
+  serviceCatalog: 'catalog',
+  accountAssetManager: 'account-asset-manager',
+}  as const satisfies Partial<Record<keyof Apis, ExceptionAPIName>>
+
+function resolveApiName(name: keyof Apis): APIName {
+  return (networkApiNameToOpaApiName as Record<string, ExceptionAPIName>)[name] ?? name
+}
+
+function generateApiMap(apis: ApiAddress) {
+  const apiMap: APIMap = {}
+  for (const [key, url] of Object.entries(apis)) {
+    if (url) {
+      apiMap[url] = resolveApiName(key as keyof Apis)
+    }
+  }
+  return apiMap
+}
+
+export function getPermissionsAPIMap(env: Env, tenant: Tenant = 'stackspot'): APIMap {
+  const apis = getApisBaseUrlConfig(env, tenant)
+  return generateApiMap(apis)
+}

package/src/apis-itau.json

@@ -221,5 +221,21 @@
       "prd": "https://discover-core.stackspot.com"
     },
     "docs": "/v3/api-docs"
+  },
+  "accountAssetManager" : {
+    "url": {
+      "dev": "https://account-asset-manager.dev.stackspot.com",
+      "stg": "https://account-asset-manager.stg.stackspot.com",
+      "prd": "https://account-asset-manager.stackspot.com"   
+    },
+    "docs": "/v3/api-docs" 
+  },
+  "edpBfa": {
+    "url": {
+      "dev": "https://adp-development-edp-bfa.dev.stackspot.com",
+      "stg": "https://adp-development-edp-bfa.stg.stackspot.com",
+      "prd": "https://edp-bfa.stackspot.com"
+    },
+    "docs": "/openapi.json"
   }
 }

package/src/apis.json

@@ -221,5 +221,21 @@
       "prd": "https://discover-core.stackspot.com"
     },
     "docs": "/v3/api-docs"
+  },
+  "accountAssetManager" : {
+    "url": {
+      "dev": "https://account-asset-manager.dev.stackspot.com",
+      "stg": "https://account-asset-manager.stg.stackspot.com",
+      "prd": "https://account-asset-manager.stackspot.com"   
+    },
+    "docs": "/v3/api-docs" 
+  },
+  "edpBfa": {
+    "url": {
+      "dev": "https://adp-development-edp-bfa.dev.stackspot.com",
+      "stg": "https://adp-development-edp-bfa.stg.stackspot.com",
+      "prd": "https://edp-bfa.stackspot.com"
+    },
+    "docs": "/openapi.json"
   }
 }

package/src/client/account-asset-manager.ts

@@ -0,0 +1,100 @@
+import { HttpError } from '@oazapfts/runtime'
+import { getApiAddresses } from '../api-addresses'
+import { defaults, deleteAssetType, deleteFolder, deleteProject, disassociateProjectAsset, getFolderDetails, getProjectDetails, listAssetTypes, listFolders, saveAssetType, saveFolder, saveProject, updateAsset, updateAssetType, updateFolders, updateProject } from '../api/accountAssetManager'
+import { DefaultAPIError } from '../error/DefaultAPIError'
+import { accountAssetManagerDictionary } from '../error/dictionary/accountAssetManager'
+import { StackspotAPIError } from '../error/StackspotAPIError'
+import { ReactQueryNetworkClient } from '../network/ReactQueryNetworkClient'
+import { removeAuthorizationParam } from '../utils/remove-authorization-param'
+
+class AccountAssetManagerClient extends ReactQueryNetworkClient {
+  constructor() {
+    super(getApiAddresses().accountAssetManager.url, defaults)
+  }
+
+  protected buildStackSpotError(error: HttpError): StackspotAPIError {
+    return new DefaultAPIError(error.data, error.status, accountAssetManagerDictionary, error.headers)
+  }
+
+  /**
+   * Save project
+   */
+  saveProject = this.mutation(removeAuthorizationParam(saveProject))
+
+  /**
+   * Get project details
+   */
+  getProjectDetails = this.query(removeAuthorizationParam(getProjectDetails))
+
+  /**
+   * Delete project
+   */
+  deleteProject = this.mutation(removeAuthorizationParam(deleteProject))
+
+  /**
+   * Update project
+   */
+  updateProject = this.mutation(removeAuthorizationParam(updateProject))
+
+  /**
+   * Disassociate project asset
+   */
+  disassociateProjectAsset = this.mutation(removeAuthorizationParam(disassociateProjectAsset))
+
+  /**
+   * List account folders
+   */
+  folders = this.query(removeAuthorizationParam(listFolders))
+
+  /**
+   * Create new folder in account
+   */
+  createFolder = this.mutation(removeAuthorizationParam(saveFolder))
+
+  /**
+   * Get folder details
+   */
+  folderDetails = this.query(removeAuthorizationParam(getFolderDetails))
+
+  /**
+   * Delete folder
+   */
+  deleteFolder = this.mutation(removeAuthorizationParam(deleteFolder))
+
+  /**
+   * Update folder
+   */
+  updateFolder = this.mutation(removeAuthorizationParam(updateFolders))
+
+  /**
+   * Create asset
+   */
+  createAsset = this.mutation(removeAuthorizationParam(saveAssetType))
+
+  /**
+   * Update asset
+   */
+  updateAsset = this.mutation(removeAuthorizationParam(updateAsset))
+
+  /**
+   * List all asset types
+   */
+  assetTypes = this.query(removeAuthorizationParam(listAssetTypes))
+
+  /**
+   * Save asset type
+   */
+  saveAssetType = this.mutation(removeAuthorizationParam(saveAssetType))
+
+  /**
+   * Delete asset type
+   */
+  deleteAssetType = this.mutation(removeAuthorizationParam(deleteAssetType))
+
+  /**
+   * Update asset type
+   */
+  updateAssetType = this.mutation(removeAuthorizationParam(updateAssetType))
+}
+
+export const accountAssetManagerClient = new AccountAssetManagerClient()

package/src/client/account.ts

@@ -102,8 +102,8 @@ import {
   isCreatedScmCredentials1,
   listAccountMemberFavorites,
   listExtensionLinks,
-  listExtensions,
   listExtensionVersions,
+  listManageableExtensions,
   listMemberFavoritesByResource,
   listScmCredentials1,
   listScmCredentials2, partialUpdateSso, personalAccessTokenAuthorization,
@@ -145,8 +145,12 @@ import { DefaultAPIError } from '../error/DefaultAPIError'
 import { accountDictionary } from '../error/dictionary/account'
 import { StackspotAPIError } from '../error/StackspotAPIError'
 import { ReactQueryNetworkClient } from '../network/ReactQueryNetworkClient'
+import { removeAuthorizationParam } from '../utils/remove-authorization-param'
 import { CreateSCMRequest, SCMStatus, UpdateSCMRequest } from './types'
 
+const listAllResourcesOfGroup = removeAuthorizationParam(getGroupResources)
+const getsListAllResourcesOfGroup = removeAuthorizationParam(getResources)
+
 class AccountClient extends ReactQueryNetworkClient {
   constructor() {
     super(getApiAddresses().account.url, defaults)
@@ -324,9 +328,9 @@ class AccountClient extends ReactQueryNetworkClient {
    */
   removeRoleFromGroup = this.mutation(deleteRole)
   /**
-   * Gets all resources of a group (paginated).
+   * Get all resources by groups with pagination.
    */
-  groupResources = this.infiniteQuery(getGroupResources)
+  allResourcesByGroupWithPagination = this.infiniteQuery(listAllResourcesOfGroup, { accumulator: 'items' })
   /**
    * Adds several resources to a group.
    */
@@ -393,7 +397,7 @@ class AccountClient extends ReactQueryNetworkClient {
   /**
    * Gets all resources (paginated)
    */
-  allResources = this.infiniteQuery(getResources)
+  allResources = this.infiniteQuery(getsListAllResourcesOfGroup, { accumulator: 'items' })
   /**
    * Gets all resource types (paginated)
    */
@@ -649,9 +653,9 @@ class AccountClient extends ReactQueryNetworkClient {
    */
   allRolesByGroupWithPagination = this.query(getRoles5)
   /**
-   * Get all resources by groups with pagination
+   * Gets all resources of a group (paginated)
    */
-  allResourcesByGroupWithPagination = this.query(getGroupResources1)
+  groupResources = this.query(getGroupResources1)
   /**
    * Get all roles account with pagination
    */
@@ -687,7 +691,7 @@ class AccountClient extends ReactQueryNetworkClient {
   /**
    * Lists all extensions.
    */
-  extensions = this.query(listExtensions)
+  extensions = this.query(listManageableExtensions)
 
   /**
    * Lists all versions of an extension.

package/src/client/agent-tools.ts

@@ -1,6 +1,6 @@
 import { HttpError } from '@oazapfts/runtime'
 import { getApiAddresses } from '../api-addresses'
-import { addFavoriteV1AgentsAgentIdFavoritePost, AgentVisibilityLevelEnum, createAgentV1AgentsPost, createToolkitToolsV1ToolkitsToolkitIdToolsPost, createToolkitV1ToolkitsPost, defaults, deleteAgentV1AgentsAgentIdDelete, deleteFavoriteV1AgentsAgentIdFavoriteDelete, deleteToolkitToolsV1ToolkitsToolkitIdToolsDelete, deleteToolkitV1ToolkitsToolkitIdDelete, editToolkitToolV1ToolkitsToolkitIdToolsToolIdPut, forkAgentV1AgentsAgentIdForkPost, forkToolkitV1ToolkitsToolkitIdForkPost, getAgentV1AgentsAgentIdGet, getPublicToolKitsV1BuiltinToolkitGet, getToolkitToolV1ToolkitsToolkitIdToolsToolIdGet, getToolkitV1ToolkitsToolkitIdGet, listAgentsUsingToolsV1ToolkitsToolkitIdToolsAgentsPost, listAgentsV1AgentsGet, listAgentsV3AgentsGet, listMultiAgentsV1AgentsMultiAgentsGet, listToolkitsV1ToolkitsGet, publishAgentV1AgentsAgentIdPublishPost, searchAgentsV1AgentsSearchPost, shareV1AgentsAgentIdSharePost, updateAgentV1AgentsAgentIdPatch, updateToolkitV1ToolkitsToolkitIdPatch, VisibilityLevelEnum } from '../api/agent-tools'
+import { addFavoriteV1AgentsAgentIdFavoritePost, AgentVisibilityLevelEnum, createAgentV1AgentsPost, createToolkitToolsV1ToolkitsToolkitIdToolsPost, createToolkitV1ToolkitsPost, defaults, deleteAgentV1AgentsAgentIdDelete, deleteFavoriteV1AgentsAgentIdFavoriteDelete, deleteToolkitToolsV1ToolkitsToolkitIdToolsDelete, deleteToolkitV1ToolkitsToolkitIdDelete, editToolkitToolV1ToolkitsToolkitIdToolsToolIdPut, forkAgentV1AgentsAgentIdForkPost, forkToolkitV1ToolkitsToolkitIdForkPost, getAgentV1AgentsAgentIdGet, getPublicToolKitsV1BuiltinToolkitGet, getToolkitToolV1ToolkitsToolkitIdToolsToolIdGet, getToolkitV1ToolkitsToolkitIdGet, listAgentsUsingToolsV1ToolkitsToolkitIdToolsAgentsPost, listAgentsV1AgentsGet, listAgentsV3AgentsGet, listMcpToolsV1McpToolsToolkitIdGet, listMultiAgentsV1AgentsMultiAgentsGet, listToolkitsV1ToolkitsGet, listToolkitsV2ToolkitsGet, publishAgentV1AgentsAgentIdPublishPost, searchAgentsV1AgentsSearchPost, shareV1AgentsAgentIdSharePost, updateAgentV1AgentsAgentIdPatch, updateToolkitV1ToolkitsToolkitIdPatch, VisibilityLevelEnum } from '../api/agent-tools'
 import { DefaultAPIError } from '../error/DefaultAPIError'
 import { agentToolsDictionary } from '../error/dictionary/agent-tools'
 import { StackspotAPIError } from '../error/StackspotAPIError'
@@ -13,6 +13,7 @@ import { workspaceAiClient } from './workspace-ai'
 
 const AGENT_DEFAULT_SLUG = 'stk_flex'
 const listAgentsV3AgentsWithoutAuthorization = removeAuthorizationParam(listAgentsV3AgentsGet)
+const listToolkitsAuthorization = removeAuthorizationParam(listToolkitsV2ToolkitsGet)
 
 class AgentToolsClient extends ReactQueryNetworkClient {
   constructor() {
@@ -23,6 +24,9 @@ class AgentToolsClient extends ReactQueryNetworkClient {
     return new DefaultAPIError(error.data, error.status, agentToolsDictionary, error.headers)
   }
 
+  /**
+   * Lists all public toolkits.
+   */
   tools = this.query(removeAuthorizationParam(getPublicToolKitsV1BuiltinToolkitGet))
 
   /**
@@ -94,11 +98,11 @@ class AgentToolsClient extends ReactQueryNetworkClient {
   agentDefault = this.query({
     name: 'agentDefault',
     request: async (signal) => {
-      const agentDefault = await listAgentsV1AgentsGet(
-        { visibility: 'built_in', slug: this.agentDefaultSlug, authorization: '' }, { signal },
+      const agentDefault = await listAgentsV3AgentsGet(
+        { filters: { visibility_list: ['built_in'], slug: this.agentDefaultSlug }, authorization: '' }, { signal },
       )
 
-      const agentId = agentDefault?.find((agent) => agent.slug ===  this.agentDefaultSlug)?.id
+      const agentId = agentDefault?.items?.find((agent) => agent.slug ===  this.agentDefaultSlug)?.id
       const agent = agentId ? await this.agent.query({ agentId }) : undefined
       return agent
     },
@@ -121,28 +125,40 @@ class AgentToolsClient extends ReactQueryNetworkClient {
         ? workspaceAiClient.workspacesContentsByType.query({ contentType: 'agent' })
         : Promise.resolve([])
 
-      const [workspaceAgents, ...agentsByVisibility] = await Promise.all([
+      const [workspaceAgents, agentsByVisibility] = await Promise.all([
         workspaceAgentsPromise,
-        ...visibilities.map((visibility) => listAgentsV1AgentsGet({ visibility, authorization: '' }, { signal })),
+        listAgentsV3AgentsGet({ filters: { 
+          visibility_list: visibilities as (AgentVisibilityLevelEnum | VisibilityLevelEnum)[],
+        }, 
+        authorization: '' }, { signal }),
       ])
 
       const workspaceAgentsWithSpaceName = workspaceAgents.flatMap(({ agents, space_name }) =>
         agents?.map((agent) => ({ ...agent, spaceName: space_name, builtIn: false }))) as AgentResponseWithBuiltIn[]
 
       const allAgents: AgentResponseWithBuiltIn[] = workspaceAgentsWithSpaceName ?? []
-
-      agentsByVisibility.forEach(agents => allAgents.push(...agents.map(agent => ({
+      
+      agentsByVisibility.items?.forEach(agent => allAgents.push(({
         ...agent,
         builtIn: agent?.visibility_level === 'built_in',
-      }))))
+      })))
 
       return allAgents
     },
   })
 
-  /* Get list of Toolkits
-  */
+  /**
+   * Lists all custom toolkits.
+   */
   toolkits = this.query(removeAuthorizationParam(listToolkitsV1ToolkitsGet))
+  /**
+  * Get list of Toolkits V2
+  */
+  toolkitsV2 = this.infiniteQuery(listToolkitsAuthorization, { accumulator: 'items' })
+  /**
+   * Lists all tools of an MCP toolkit.
+   */
+  mcpTools = this.query(removeAuthorizationParam(listMcpToolsV1McpToolsToolkitIdGet))
   /**
    * Get a toolkit by Id
    */
@@ -175,6 +191,7 @@ class AgentToolsClient extends ReactQueryNetworkClient {
    * Delete tool from Toolkit
    */
   deleteToolFromToolkit = this.mutation(removeAuthorizationParam(deleteToolkitToolsV1ToolkitsToolkitIdToolsDelete))
+  
   /**
    * Previews an uploaded open api file as a stream where each array item is an OpenAPI operation.
    */