@stack-spot/portal-network 0.208.3 → 0.210.0

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,81 @@ 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',
+}  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

@@ -222,6 +222,14 @@
     },
     "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",

package/src/apis.json

@@ -222,6 +222,14 @@
     },
     "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",

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/ai.ts

@@ -45,6 +45,8 @@ import {
   resetKnowledgeObjectsV1KnowledgeSourcesSlugObjectsDelete,
   runFetchStepV1QuickCommandsSlugStepsStepSlugFetchRunPost,
   searchKnowledgeSourcesV1KnowledgeSourcesSearchPost,
+  tokensByUserV1AnalyticsTokensByUserGet,
+  tokensDailyUsageV1AnalyticsTokensDailyUsageGet,
   startScriptStepV1QuickCommandsSlugStepsStepSlugStartScriptPost,
   totalV1TokensUsageTotalGet,
   updateQuickCommandV1QuickCommandsSlugPatch,
@@ -277,6 +279,14 @@ class AIClient extends ReactQueryNetworkClient {
    */
   removeFavoriteQuickCommand = this.mutation(removeAuthorizationParam(deleteFavoriteV1QuickCommandsSlugFavoriteDelete))
   /**
+   * Get Tokens Daily usage
+   */
+  analyticsTokensDailyUsage = this.query(removeAuthorizationParam(tokensDailyUsageV1AnalyticsTokensDailyUsageGet))
+  /**
+   * Get Tokens By User
+   */
+  analyticsTokensByUser = this.query(removeAuthorizationParam(tokensByUserV1AnalyticsTokensByUserGet))
+  /*
    * Lists all the feature flags for this user.
    */
   flags = this.query(getFlagsV1FlagsGet)

package/src/error/dictionary/accountAssetManager.ts

@@ -0,0 +1,12 @@
+import { Dictionary } from '@stack-spot/portal-translate'
+
+export const accountAssetManagerDictionary = {
+  en: {
+    FOLDER_BAD_REQUEST_ERROR: 'The provided data is invalid or inconsistent.',
+    FOLDER_ALREADY_EXISTS: 'A folder with this name already exists.',
+  },
+  pt: {
+    FOLDER_BAD_REQUEST_ERROR: 'Os dados informados estão inválidos ou inconsistentes.',
+    FOLDER_ALREADY_EXISTS: 'Já existe uma pasta com esse nome.',
+  },
+} satisfies Dictionary

package/src/index.ts

@@ -1,6 +1,7 @@
 export { CancelledError } from '@tanstack/react-query'
-export { apiAddresses, getApiAddresses, getApisByTenant, getBaseUrlByTenantWithOverride, setApisOverride } from './api-addresses'
+export { apiAddresses, getApiAddresses, getApisBaseUrlConfig, getBaseUrlByTenantWithOverride } from './api-addresses'
 export { accountClient } from './client/account'
+export { accountAssetManagerClient } from './client/account-asset-manager'
 export { agentClient } from './client/agent'
 export { agentToolsClient } from './client/agent-tools'
 export { aiClient } from './client/ai'

package/src/network/NetworkClient.ts

@@ -1,8 +1,9 @@
 import { AuthenticationError, SessionExpiredError } from '@stack-spot/auth'
-import { requestPermission } from '@stack-spot/opa'
+import { requestPermission, setup as setupPermissions } from '@stack-spot/opa'
 import { events } from 'fetch-event-stream'
-import { getBaseUrlByTenantWithOverride } from '../api-addresses'
+import { getApisBaseUrlConfig, getBaseUrlByTenantWithOverride, getPermissionsAPIMap } from '../api-addresses'
 import { StackspotAPIError } from '../error/StackspotAPIError'
+import { queryClient } from './react-query-client'
 import { Env, FetchEventStream, HTTPMethod, SessionManager, Tenant } from './types'
 
 /**
@@ -41,6 +42,14 @@ export abstract class NetworkClient {
     NetworkClient.sessionManager = sessionManager
     NetworkClient.env = env
     NetworkClient.tenant = tenant
+    const url = getApisBaseUrlConfig(env, tenant).permissionValidation
+    const apiMap = getPermissionsAPIMap(env, tenant)
+    sessionManager.onChange?.((session) => {
+      if (session) {
+        queryClient.invalidateQueries()
+        setupPermissions({ url, session, apiMap })
+      }
+    })
   }
 
   /**
@@ -65,7 +74,7 @@ export abstract class NetworkClient {
    * @returns the final baseURL for the current environment, considering overrides if available.
    */
   protected getBaseURL(): string {
-    return getBaseUrlByTenantWithOverride(this.baseURL, NetworkClient.env, NetworkClient.tenant);
+    return getBaseUrlByTenantWithOverride(this.baseURL, NetworkClient.env, NetworkClient.tenant)
   }
 
   /**

package/src/network/types.ts

@@ -8,6 +8,7 @@ export interface SessionManager {
   hasSession(): boolean,
   endSession(): void,
   getSession(): Session,
+  onChange?: (listener: (session: Session | undefined) => void) => (() => void),
 }
 
 export type Tenant = 'stackspot' | 'itau'