@everysk/apps-sdk 0.1.0 → 0.2.0

package/README.md

@@ -5,16 +5,30 @@
 The runtime an Everysk app bundles: the provider tree, the API layer, the entity hooks, the
 shared components and the MUI theme. Declared as a `dependency`.
 
-Part of [everysk/apps-sdk](https://github.com/everysk/apps-sdk), alongside
-[`@everysk/apps-devkit`](../apps-devkit) (build presets) and
-[`@everysk/apps-cli`](../apps-cli) (the `everysk-apps` bin).
+One of three: [`@everysk/apps-devkit`](https://www.npmjs.com/package/@everysk/apps-devkit) holds
+the build presets and [`@everysk/apps-cli`](https://www.npmjs.com/package/@everysk/apps-cli) the
+`everysk-apps` bin.
+
+## Start with the CLI
+
+```bash
+npx @everysk/apps-cli init
+```
+
+For a new app, do this instead of installing by hand: it writes an app already wired for the
+modules and theme you pick, including four decisions that fail *quietly* when made by hand.
+[`@everysk/apps-cli`](https://www.npmjs.com/package/@everysk/apps-cli) lists them.
 
 ## Install
 
+For adding the SDK to an app that already exists:
+
 ```bash
 npm install @everysk/apps-sdk
 ```
 
+Then `npx @everysk/apps-cli doctor` will tell you what the wiring is still missing.
+
 `react`, `react-dom`, `@mui/material`, `@mui/x-date-pickers`, `@emotion/*`,
 `@tanstack/react-query` and `axios` are **required** peers — npm installs them with the package,
 and a version outside its range fails the install rather than giving the app a second copy. Two
@@ -51,6 +65,93 @@ to nested JSX in the right slot.
 | `appId`, `appEnvironmentVar` | Override `window.APP_ID` / `window.APP_CONFIG`, for tests and hosts that resolve configuration themselves |
 | `providers` | Optional providers, mounted inside the core tree |
 
+## What it exports
+
+Everything below comes from the package root — `import { … } from "@everysk/apps-sdk"`. A bundler
+drops what you do not use, so there is nothing to be careful about here.
+
+### Entity slices
+
+Each entity is an API module, its types, and React Query hooks over them. The hooks take an
+object and return the query result plus its `queryKey`, so a mutation can invalidate exactly what
+a list rendered.
+
+| Entity | One | Many | Write |
+|---|---|---|---|
+| Portfolio | `useFetchPortfolio` | `useFetchPortfolios` | `usePortfolioMutations` |
+| Datastore | `useFetchDatastore` | `useFetchDatastores` | `useDatastoreMutations` |
+| File | `useFetchFile` | `useFetchFiles` | `useFileMutations` |
+| Workspace | `useFetchWorkspace` | `useFetchWorkspaces` | — |
+| Profile | `useFetchProfile` | — | — |
+| Workflow | `useFetchWorkflow` | `useFetchWorkflows` | `useRunWorkflow` |
+
+Workflow carries four more for the run side: `useFetchWorkflowExecution(s)` and
+`useFetchWorkerExecution(s)`.
+
+```tsx
+const { query, queryKey } = useFetchPortfolios({
+  filters: [{ field: "workspace", value: "ws-1" }],
+  pageSize: 20,
+});
+
+const { remove } = usePortfolioMutations({ queryKey });
+```
+
+`useFetchPortfolios` is paginated — `query` is the whole `useInfiniteQuery` result, so
+`hasNextPage` and `fetchNextPage` are there. The single-entity hooks spread the query result
+directly, so `const { data, isLoading, queryKey } = useFetchPortfolio({ id, workspace })`.
+Mutations return `{ create, update, remove }`, each a React Query mutation that shows an alert on
+success and failure through `useAppAlert`.
+
+### Components
+
+Five, all MUI underneath.
+
+| Component | Props | |
+|---|---|---|
+| `PageContainer` | `header?`, `footer?`, `contentClassName?` | The page frame: chrome around a scrolling content area |
+| `Toolbar` | `className?` | Top bar. Renders `EveryskIcon` and its children |
+| `Footer` | `className?` | Bottom bar |
+| `GlobalLoading` | `isLoading`, `backdrop?`, `message?` | Full-page spinner. `backdrop` defaults to `true` |
+| `EveryskIcon` | every `SvgIconProps` except `color` | The brand mark |
+
+`Toolbar`, `Footer` and `PageContainer` take a `className`, so a Tailwind utility reaches them —
+but a utility loses to MUI's own styles in the cascade, so reach for `sx` when one is dropped.
+`GlobalLoading` takes no `className`, and `EveryskIcon` gets one through `SvgIconProps`.
+
+```tsx
+<PageContainer header={<Toolbar>Trade Allocation</Toolbar>} footer={<Footer />}>
+  <GlobalLoading isLoading={query.isLoading} message="Loading portfolios…" />
+  {/* the page */}
+</PageContainer>
+```
+
+### Contexts
+
+| Hook | |
+|---|---|
+| `useAppConfig()` | `{ appId, appEnvironmentVar }`, resolved from the page or from `EveryskApp`'s props |
+| `useAppAlert()` | `showAlert({ message, severity, …SnackbarProps })`. The entity mutations already use it |
+| `useAxios()` | `{ api }` — a memoised axios instance on the app's `baseURL`, defaulting to `/api` |
+
+### Theme
+
+`EveryskDarkTheme`, `EveryskLightTheme`, `DefaultDarkTheme`, `DefaultLightTheme` and
+`MidnightEmberTheme`, plus `getTheme(name)` to resolve one by the name the CLI writes, and
+`getBrandTheme(mode)` / `getDefaultTheme(mode)` for the pair. `EveryskApp` mounts the brand dark
+theme unless given a `theme` prop.
+
+### Query client and helpers
+
+`createQueryClient(config?)` builds the QueryClient `EveryskApp` mounts — a factory rather than a
+shared instance, because two apps or two tests sharing one client share its cache.
+`getQueryFn`, `toFilterTuple`, `buildQueryObject` and `buildQueryKey` are the pieces the entity
+hooks are built from, exported for a query the slices do not cover.
+
+`useAxios`'s interceptor is worth knowing about if you write one of those: on `GET` and `DELETE`
+it parses the request's query object into the shape the platform API expects. It is attached in
+an effect and ejected on cleanup, so interceptors do not stack across renders.
+
 ## Entry points
 
 One entry holds everything whose dependencies are required peers — the contexts, the six entity

package/dist/api/datastore.js

@@ -19,9 +19,9 @@ var getDatastore = async (api, id, workspace) => {
 	try {
 		return (await api.get(`${baseUrl}/${id}`, { params })).data.datastore;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error fetching datastore");
+		if (isAxiosError(error)) throw new Error(error.message || "Error fetching datastore", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error fetching datastore");
+		throw new Error("Error fetching datastore", { cause: error });
 	}
 };
 /**
@@ -47,9 +47,9 @@ var listDatastores = async (api, query) => {
 	try {
 		return (await api.get(baseUrl, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error listing datastores");
+		if (isAxiosError(error)) throw new Error(error.message || "Error listing datastores", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error listing datastores");
+		throw new Error("Error listing datastores", { cause: error });
 	}
 };
 /**
@@ -69,9 +69,9 @@ var createDatastore = async (api, data) => {
 	try {
 		return (await api.post(baseUrl, data)).data.datastore;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error creating datastore");
+		if (isAxiosError(error)) throw new Error(error.message || "Error creating datastore", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error creating datastore");
+		throw new Error("Error creating datastore", { cause: error });
 	}
 };
 /**
@@ -92,9 +92,9 @@ var updateDatastore = async (api, id, data) => {
 	try {
 		return (await api.put(`${baseUrl}/${id}`, data)).data.datastore;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error updating datastore");
+		if (isAxiosError(error)) throw new Error(error.message || "Error updating datastore", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error updating datastore");
+		throw new Error("Error updating datastore", { cause: error });
 	}
 };
 /**
@@ -114,9 +114,9 @@ var deleteDatastore = async (api, id, workspace) => {
 	try {
 		return (await api.delete(`${baseUrl}/${id}`, { params })).data.datastores;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error removing datastore");
+		if (isAxiosError(error)) throw new Error(error.message || "Error removing datastore", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error removing datastore");
+		throw new Error("Error removing datastore", { cause: error });
 	}
 };
 //#endregion

package/dist/api/datastore.js.map

@@ -1 +1 @@
-{"version":3,"file":"datastore.js","names":[],"sources":["../../src/api/datastore.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { DeleteEntityDefaultResponse, FilterExpression, QueryObject } from \"@/types/entityQuery\";\nimport type { Datastore, DatastoreSingleResponse, DatastoreListResponse, DeleteDatastoreResponse } from \"@/types/datastore\";\n\nconst baseUrl = \"datastores\";\n\n/**\n * getDatastore\n *\n * Fetches a single datastore by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Datastore identifier.\n * @param {string} workspace - Workspace the datastore belongs to.\n * @returns {Promise<Datastore>} The fetched datastore.\n *\n * @throws {Error} If the request fails.\n */\nexport const getDatastore = async (api: AxiosInstance, id: string, workspace: string): Promise<Datastore> => {\n  const params: AnyRecord = { workspace };\n\n  if (!workspace) throw new Error(\"Workspace filter is required to fetch a datastore\");\n\n  try {\n    const response: AxiosResponse<DatastoreSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n    return response.data.datastore;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error fetching datastore\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error fetching datastore\");\n  }\n};\n\n/**\n * listDatastores\n *\n * Fetches a list of datastores using a query object (filters, order, pagination, etc.).\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {AnyRecord} query - Query object built via `buildQueryObject`.\n * @returns {Promise<DatastoreListResponse>} Paginated list of datastores.\n *\n * @throws {Error} If workspace filter is missing.\n * @throws {Error} If the request fails.\n */\nexport const listDatastores = async (api: AxiosInstance, query: QueryObject): Promise<DatastoreListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n  if (!workspace) throw new Error(\"Workspace filter is required to list datastores\");\n\n  const params: AnyRecord = {\n    workspace,\n    ...(query ? { query: JSON.stringify(query) } : {}),\n  };\n\n  try {\n    const response: AxiosResponse<DatastoreListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing datastores\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing datastores\");\n  }\n};\n\n/**\n * createDatastore\n *\n * Creates a new datastore.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Partial<Datastore>} data - Datastore payload.\n * @returns {Promise<Datastore>} The created datastore.\n *\n * @throws {Error} If the request fails.\n */\nexport const createDatastore = async (api: AxiosInstance, data: Partial<Datastore>): Promise<Datastore> => {\n\n  const { workspace } = data;\n  if (!workspace) throw new Error(\"Workspace filter is required to create a datastore\");\n\n  try {\n    const response: AxiosResponse<DatastoreSingleResponse> = await api.post(baseUrl, data);\n    return response.data.datastore;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error creating datastore\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error creating datastore\");\n  }\n};\n\n/**\n * updateDatastore\n *\n * Updates an existing datastore by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Datastore identifier.\n * @param {Partial<Datastore>} data - Fields to update.\n * @returns {Promise<Datastore>} The updated datastore.\n *\n * @throws {Error} If the request fails.\n */\nexport const updateDatastore = async (api: AxiosInstance, id: string, data: Partial<Datastore>): Promise<Datastore> => {\n\n  const { workspace } = data;\n  if (!workspace) throw new Error(\"Workspace filter is required to update a datastore\");\n\n  try {\n    const response: AxiosResponse<DatastoreSingleResponse> = await api.put(`${baseUrl}/${id}`, data);\n    return response.data.datastore;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error updating datastore\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error updating datastore\");\n  }\n};\n\n/**\n * deleteDatastore\n *\n * Deletes a datastore by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Datastore identifier.\n * @param {string} workspace - Workspace the datastore belongs to.\n * @returns {Promise<DeleteEntityDefaultResponse[]>} List of deleted entity records.\n *\n * @throws {Error} If the request fails.\n */\nexport const deleteDatastore = async (api: AxiosInstance, id: string, workspace: string): Promise<DeleteEntityDefaultResponse[]> => {\n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<DeleteDatastoreResponse> = await api.delete(`${baseUrl}/${id}`, { params });\n    return response.data.datastores;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error removing datastore\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error removing datastore\");\n  }\n};"],"mappings":";;AAMA,IAAM,UAAU;;;;;;;;;;;;;AAchB,IAAa,eAAe,OAAO,KAAoB,IAAY,cAA0C;CAC3G,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,mDAAmD;CAEnF,IAAI;EAEF,QAAO,MADwD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CACrF,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,0BAA0B;EAG7D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,0BAA0B;CAC5C;AACF;;;;;;;;;;;;;AAcA,IAAa,iBAAiB,OAAO,KAAoB,UAAuD;CAC9G,MAAM,kBAAkB,MAAM,QAAQ,MAAM,WAA6B,OAAO,OAAO,WAAW;CAClG,MAAM,YAAY,kBAAkB,gBAAgB,SAAS;CAE7D,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,iDAAiD;CAEjF,MAAM,SAAoB;EACxB;EACA,GAAI,QAAQ,EAAE,OAAO,KAAK,UAAU,KAAK,EAAE,IAAI,CAAC;CAClD;CAEA,IAAI;EAEF,QAAO,MADsD,IAAI,IAAI,SAAS,EAAE,OAAO,CAAC,EAAA,CACxE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,0BAA0B;EAG7D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,0BAA0B;CAC5C;AACF;;;;;;;;;;;;AAaA,IAAa,kBAAkB,OAAO,KAAoB,SAAiD;CAEzG,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,oDAAoD;CAEpF,IAAI;EAEF,QAAO,MADwD,IAAI,KAAK,SAAS,IAAI,EAAA,CACrE,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,0BAA0B;EAG7D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,0BAA0B;CAC5C;AACF;;;;;;;;;;;;;AAcA,IAAa,kBAAkB,OAAO,KAAoB,IAAY,SAAiD;CAErH,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,oDAAoD;CAEpF,IAAI;EAEF,QAAO,MADwD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,IAAI,EAAA,CAC/E,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,0BAA0B;EAG7D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,0BAA0B;CAC5C;AACF;;;;;;;;;;;;;AAcA,IAAa,kBAAkB,OAAO,KAAoB,IAAY,cAA8D;CAClI,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAI;EAEF,QAAO,MADwD,IAAI,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CACxF,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,0BAA0B;EAG7D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,0BAA0B;CAC5C;AACF"}
+{"version":3,"file":"datastore.js","names":[],"sources":["../../src/api/datastore.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { DeleteEntityDefaultResponse, FilterExpression, QueryObject } from \"@/types/entityQuery\";\nimport type { Datastore, DatastoreSingleResponse, DatastoreListResponse, DeleteDatastoreResponse } from \"@/types/datastore\";\n\nconst baseUrl = \"datastores\";\n\n/**\n * getDatastore\n *\n * Fetches a single datastore by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Datastore identifier.\n * @param {string} workspace - Workspace the datastore belongs to.\n * @returns {Promise<Datastore>} The fetched datastore.\n *\n * @throws {Error} If the request fails.\n */\nexport const getDatastore = async (api: AxiosInstance, id: string, workspace: string): Promise<Datastore> => {\n  const params: AnyRecord = { workspace };\n\n  if (!workspace) throw new Error(\"Workspace filter is required to fetch a datastore\");\n\n  try {\n    const response: AxiosResponse<DatastoreSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n    return response.data.datastore;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error fetching datastore\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error fetching datastore\", { cause: error });\n  }\n};\n\n/**\n * listDatastores\n *\n * Fetches a list of datastores using a query object (filters, order, pagination, etc.).\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {AnyRecord} query - Query object built via `buildQueryObject`.\n * @returns {Promise<DatastoreListResponse>} Paginated list of datastores.\n *\n * @throws {Error} If workspace filter is missing.\n * @throws {Error} If the request fails.\n */\nexport const listDatastores = async (api: AxiosInstance, query: QueryObject): Promise<DatastoreListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n  if (!workspace) throw new Error(\"Workspace filter is required to list datastores\");\n\n  const params: AnyRecord = {\n    workspace,\n    ...(query ? { query: JSON.stringify(query) } : {}),\n  };\n\n  try {\n    const response: AxiosResponse<DatastoreListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing datastores\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing datastores\", { cause: error });\n  }\n};\n\n/**\n * createDatastore\n *\n * Creates a new datastore.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Partial<Datastore>} data - Datastore payload.\n * @returns {Promise<Datastore>} The created datastore.\n *\n * @throws {Error} If the request fails.\n */\nexport const createDatastore = async (api: AxiosInstance, data: Partial<Datastore>): Promise<Datastore> => {\n\n  const { workspace } = data;\n  if (!workspace) throw new Error(\"Workspace filter is required to create a datastore\");\n\n  try {\n    const response: AxiosResponse<DatastoreSingleResponse> = await api.post(baseUrl, data);\n    return response.data.datastore;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error creating datastore\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error creating datastore\", { cause: error });\n  }\n};\n\n/**\n * updateDatastore\n *\n * Updates an existing datastore by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Datastore identifier.\n * @param {Partial<Datastore>} data - Fields to update.\n * @returns {Promise<Datastore>} The updated datastore.\n *\n * @throws {Error} If the request fails.\n */\nexport const updateDatastore = async (api: AxiosInstance, id: string, data: Partial<Datastore>): Promise<Datastore> => {\n\n  const { workspace } = data;\n  if (!workspace) throw new Error(\"Workspace filter is required to update a datastore\");\n\n  try {\n    const response: AxiosResponse<DatastoreSingleResponse> = await api.put(`${baseUrl}/${id}`, data);\n    return response.data.datastore;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error updating datastore\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error updating datastore\", { cause: error });\n  }\n};\n\n/**\n * deleteDatastore\n *\n * Deletes a datastore by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Datastore identifier.\n * @param {string} workspace - Workspace the datastore belongs to.\n * @returns {Promise<DeleteEntityDefaultResponse[]>} List of deleted entity records.\n *\n * @throws {Error} If the request fails.\n */\nexport const deleteDatastore = async (api: AxiosInstance, id: string, workspace: string): Promise<DeleteEntityDefaultResponse[]> => {\n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<DeleteDatastoreResponse> = await api.delete(`${baseUrl}/${id}`, { params });\n    return response.data.datastores;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error removing datastore\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error removing datastore\", { cause: error });\n  }\n};"],"mappings":"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"}

package/dist/api/file.js

@@ -18,9 +18,9 @@ var getFile = async (api, id, workspace) => {
 	try {
 		return (await api.get(`${baseUrl}/${id}`, { params })).data.file;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching file");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching file", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching file");
+		throw new Error("Error while fetching file", { cause: error });
 	}
 };
 /**
@@ -48,9 +48,9 @@ var listFiles = async (api, query) => {
 	try {
 		return (await api.get(baseUrl, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching files");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching files", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching files");
+		throw new Error("Error while fetching files", { cause: error });
 	}
 };
 /**
@@ -70,9 +70,9 @@ var createFile = async (api, data) => {
 	try {
 		return (await api.post(baseUrl, data)).data.file;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while creating file");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while creating file", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while creating file");
+		throw new Error("Error while creating file", { cause: error });
 	}
 };
 /**
@@ -93,9 +93,9 @@ var updateFile = async (api, id, data) => {
 	try {
 		return (await api.put(`${baseUrl}/${id}`, data)).data.file;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while updating file");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while updating file", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while updating file");
+		throw new Error("Error while updating file", { cause: error });
 	}
 };
 /**
@@ -115,9 +115,9 @@ var deleteFile = async (api, id, workspace) => {
 	try {
 		return (await api.delete(`${baseUrl}/${id}`, { params })).data.files;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while deleting file");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while deleting file", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while deleting file");
+		throw new Error("Error while deleting file", { cause: error });
 	}
 };
 //#endregion

package/dist/api/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","names":[],"sources":["../../src/api/file.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { DeleteFileResponse, EveryskFile, FileListResponse, FileSingleResponse } from \"@/types/file\";\nimport type { DeleteEntityDefaultResponse, FilterExpression, QueryObject } from \"@/types/entityQuery\";\n\nconst baseUrl = \"files\";\n\n/**\n * getFile\n *\n * Fetches a single file by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - EveryskFile identifier.\n * @param {string} workspace - Workspace the file belongs to.\n * @returns {Promise<EveryskFile>} The fetched file.\n *\n * @throws {Error} If the request fails.\n */\nexport const getFile = async (api: AxiosInstance, id: string, workspace: string): Promise<EveryskFile> => {\n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<FileSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n    return response.data.file;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n     throw new Error(error.message || \"Error while fetching file\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching file\");\n  }\n};\n\n/**\n * listFiles\n *\n * Fetches a list of files using a query object (filters, order, pagination, etc.).\n *\n * Note: `workspace` is extracted from the query filters and sent as a separate\n * query param alongside the serialized query object.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {QueryObject} query - Query object built via `buildQueryObject`.\n * @returns {Promise<EveryskFile[]>} List of files. Returns an empty array if none found.\n *\n * @throws {Error} If the request fails.\n */\nexport const listFiles = async (api: AxiosInstance, query: QueryObject): Promise<FileListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n  \n  if (!workspace) throw new Error(\"Workspace filter is required to list files\");\n\n  const params: AnyRecord = {\n    workspace,\n    ...(query ? { query: JSON.stringify(query) } : {}),\n  };\n\n  try {\n    const response: AxiosResponse<FileListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching files\");\n    } \n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching files\");\n  }\n};\n\n/**\n * createFile\n *\n * Creates a new file.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Partial<EveryskFile>} data - EveryskFile payload.\n * @returns {Promise<EveryskFile>} The created file.\n *\n * @throws {Error} If the request fails.\n */\nexport const createFile = async (api: AxiosInstance, data: Partial<EveryskFile>): Promise<EveryskFile> => {\n\n  const { workspace } = data;\n  if (!workspace) throw new Error(\"Workspace filter is required to create a file\");\n\n  try {\n    const response: AxiosResponse<FileSingleResponse> = await api.post(baseUrl, data);\n    return response.data.file;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while creating file\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while creating file\");\n  }\n};\n\n/**\n * updateFile\n *\n * Updates an existing file by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - EveryskFile identifier.\n * @param {Partial<EveryskFile>} data - Fields to update.\n * @returns {Promise<EveryskFile>} The updated file.\n *\n * @throws {Error} If the request fails.\n */\nexport const updateFile = async (api: AxiosInstance, id: string, data: Partial<EveryskFile>): Promise<EveryskFile> => {\n\n    const { workspace } = data;\n    if (!workspace) throw new Error(\"Workspace filter is required to update a file\");\n\n    try {\n        const response: AxiosResponse<FileSingleResponse> = await api.put(`${baseUrl}/${id}`, data);\n        return response.data.file;\n    } catch (error: unknown) {\n        if (isAxiosError<AnyRecord>(error)) {\n            throw new Error(error.message || \"Error while updating file\");\n        }\n\n        if (error instanceof Error) {\n            throw error;\n        }\n\n        throw new Error(\"Error while updating file\");\n    }\n};\n\n/**\n * deleteFile\n *\n * Deletes a file by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - EveryskFile identifier.\n * @param {string} workspace - Workspace the file belongs to.\n * @returns {Promise<DeleteEntityDefaultResponse[]>} List of deleted entity records.\n *\n * @throws {Error} If the request fails.\n */\nexport const deleteFile = async (api: AxiosInstance, id: string, workspace: string): Promise<DeleteEntityDefaultResponse[]> => {\n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<DeleteFileResponse> = await api.delete(`${baseUrl}/${id}`, { params });\n    return response.data.files;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while deleting file\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while deleting file\");\n  }\n};"],"mappings":";;AAMA,IAAM,UAAU;;;;;;;;;;;;;AAchB,IAAa,UAAU,OAAO,KAAoB,IAAY,cAA4C;CACxG,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAI;EAEF,QAAO,MADmD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CAChF,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAChC,MAAM,IAAI,MAAM,MAAM,WAAW,2BAA2B;EAG7D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,2BAA2B;CAC7C;AACF;;;;;;;;;;;;;;;AAgBA,IAAa,YAAY,OAAO,KAAoB,UAAkD;CACpG,MAAM,kBAAkB,MAAM,QAAQ,MAAM,WAA6B,OAAO,OAAO,WAAW;CAClG,MAAM,YAAY,kBAAkB,gBAAgB,SAAS;CAE7D,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,4CAA4C;CAE5E,MAAM,SAAoB;EACxB;EACA,GAAI,QAAQ,EAAE,OAAO,KAAK,UAAU,KAAK,EAAE,IAAI,CAAC;CAClD;CAEA,IAAI;EAEF,QAAO,MADiD,IAAI,IAAI,SAAS,EAAE,OAAO,CAAC,EAAA,CACnE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,4BAA4B;EAE/D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,4BAA4B;CAC9C;AACF;;;;;;;;;;;;AAaA,IAAa,aAAa,OAAO,KAAoB,SAAqD;CAExG,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,+CAA+C;CAE/E,IAAI;EAEF,QAAO,MADmD,IAAI,KAAK,SAAS,IAAI,EAAA,CAChE,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,2BAA2B;EAG9D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,2BAA2B;CAC7C;AACF;;;;;;;;;;;;;AAcA,IAAa,aAAa,OAAO,KAAoB,IAAY,SAAqD;CAElH,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,+CAA+C;CAE/E,IAAI;EAEA,QAAO,MADmD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,IAAI,EAAA,CAC1E,KAAK;CACzB,SAAS,OAAgB;EACrB,IAAI,aAAwB,KAAK,GAC7B,MAAM,IAAI,MAAM,MAAM,WAAW,2BAA2B;EAGhE,IAAI,iBAAiB,OACjB,MAAM;EAGV,MAAM,IAAI,MAAM,2BAA2B;CAC/C;AACJ;;;;;;;;;;;;;AAcA,IAAa,aAAa,OAAO,KAAoB,IAAY,cAA8D;CAC7H,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAI;EAEF,QAAO,MADmD,IAAI,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CACnF,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,2BAA2B;EAG9D,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,2BAA2B;CAC7C;AACF"}
+{"version":3,"file":"file.js","names":[],"sources":["../../src/api/file.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { DeleteFileResponse, EveryskFile, FileListResponse, FileSingleResponse } from \"@/types/file\";\nimport type { DeleteEntityDefaultResponse, FilterExpression, QueryObject } from \"@/types/entityQuery\";\n\nconst baseUrl = \"files\";\n\n/**\n * getFile\n *\n * Fetches a single file by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - EveryskFile identifier.\n * @param {string} workspace - Workspace the file belongs to.\n * @returns {Promise<EveryskFile>} The fetched file.\n *\n * @throws {Error} If the request fails.\n */\nexport const getFile = async (api: AxiosInstance, id: string, workspace: string): Promise<EveryskFile> => {\n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<FileSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n    return response.data.file;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n     throw new Error(error.message || \"Error while fetching file\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching file\", { cause: error });\n  }\n};\n\n/**\n * listFiles\n *\n * Fetches a list of files using a query object (filters, order, pagination, etc.).\n *\n * Note: `workspace` is extracted from the query filters and sent as a separate\n * query param alongside the serialized query object.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {QueryObject} query - Query object built via `buildQueryObject`.\n * @returns {Promise<EveryskFile[]>} List of files. Returns an empty array if none found.\n *\n * @throws {Error} If the request fails.\n */\nexport const listFiles = async (api: AxiosInstance, query: QueryObject): Promise<FileListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n  \n  if (!workspace) throw new Error(\"Workspace filter is required to list files\");\n\n  const params: AnyRecord = {\n    workspace,\n    ...(query ? { query: JSON.stringify(query) } : {}),\n  };\n\n  try {\n    const response: AxiosResponse<FileListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching files\", { cause: error });\n    } \n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching files\", { cause: error });\n  }\n};\n\n/**\n * createFile\n *\n * Creates a new file.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Partial<EveryskFile>} data - EveryskFile payload.\n * @returns {Promise<EveryskFile>} The created file.\n *\n * @throws {Error} If the request fails.\n */\nexport const createFile = async (api: AxiosInstance, data: Partial<EveryskFile>): Promise<EveryskFile> => {\n\n  const { workspace } = data;\n  if (!workspace) throw new Error(\"Workspace filter is required to create a file\");\n\n  try {\n    const response: AxiosResponse<FileSingleResponse> = await api.post(baseUrl, data);\n    return response.data.file;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while creating file\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while creating file\", { cause: error });\n  }\n};\n\n/**\n * updateFile\n *\n * Updates an existing file by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - EveryskFile identifier.\n * @param {Partial<EveryskFile>} data - Fields to update.\n * @returns {Promise<EveryskFile>} The updated file.\n *\n * @throws {Error} If the request fails.\n */\nexport const updateFile = async (api: AxiosInstance, id: string, data: Partial<EveryskFile>): Promise<EveryskFile> => {\n\n    const { workspace } = data;\n    if (!workspace) throw new Error(\"Workspace filter is required to update a file\");\n\n    try {\n        const response: AxiosResponse<FileSingleResponse> = await api.put(`${baseUrl}/${id}`, data);\n        return response.data.file;\n    } catch (error: unknown) {\n        if (isAxiosError<AnyRecord>(error)) {\n            throw new Error(error.message || \"Error while updating file\", { cause: error });\n        }\n\n        if (error instanceof Error) {\n            throw error;\n        }\n\n        throw new Error(\"Error while updating file\", { cause: error });\n    }\n};\n\n/**\n * deleteFile\n *\n * Deletes a file by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - EveryskFile identifier.\n * @param {string} workspace - Workspace the file belongs to.\n * @returns {Promise<DeleteEntityDefaultResponse[]>} List of deleted entity records.\n *\n * @throws {Error} If the request fails.\n */\nexport const deleteFile = async (api: AxiosInstance, id: string, workspace: string): Promise<DeleteEntityDefaultResponse[]> => {\n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<DeleteFileResponse> = await api.delete(`${baseUrl}/${id}`, { params });\n    return response.data.files;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while deleting file\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while deleting file\", { cause: error });\n  }\n};"],"mappings":";;AAMA,IAAM,UAAU;;;;;;;;;;;;;AAchB,IAAa,UAAU,OAAO,KAAoB,IAAY,cAA4C;CACxG,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAI;EAEF,QAAO,MADmD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CAChF,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAChC,MAAM,IAAI,MAAM,MAAM,WAAW,6BAA6B,EAAE,OAAO,MAAM,CAAC;EAG/E,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,6BAA6B,EAAE,OAAO,MAAM,CAAC;CAC/D;AACF;;;;;;;;;;;;;;;AAgBA,IAAa,YAAY,OAAO,KAAoB,UAAkD;CACpG,MAAM,kBAAkB,MAAM,QAAQ,MAAM,WAA6B,OAAO,OAAO,WAAW;CAClG,MAAM,YAAY,kBAAkB,gBAAgB,SAAS;CAE7D,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,4CAA4C;CAE5E,MAAM,SAAoB;EACxB;EACA,GAAI,QAAQ,EAAE,OAAO,KAAK,UAAU,KAAK,EAAE,IAAI,CAAC;CAClD;CAEA,IAAI;EAEF,QAAO,MADiD,IAAI,IAAI,SAAS,EAAE,OAAO,CAAC,EAAA,CACnE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,8BAA8B,EAAE,OAAO,MAAM,CAAC;EAEjF,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,8BAA8B,EAAE,OAAO,MAAM,CAAC;CAChE;AACF;;;;;;;;;;;;AAaA,IAAa,aAAa,OAAO,KAAoB,SAAqD;CAExG,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,+CAA+C;CAE/E,IAAI;EAEF,QAAO,MADmD,IAAI,KAAK,SAAS,IAAI,EAAA,CAChE,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,6BAA6B,EAAE,OAAO,MAAM,CAAC;EAGhF,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,6BAA6B,EAAE,OAAO,MAAM,CAAC;CAC/D;AACF;;;;;;;;;;;;;AAcA,IAAa,aAAa,OAAO,KAAoB,IAAY,SAAqD;CAElH,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,+CAA+C;CAE/E,IAAI;EAEA,QAAO,MADmD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,IAAI,EAAA,CAC1E,KAAK;CACzB,SAAS,OAAgB;EACrB,IAAI,aAAwB,KAAK,GAC7B,MAAM,IAAI,MAAM,MAAM,WAAW,6BAA6B,EAAE,OAAO,MAAM,CAAC;EAGlF,IAAI,iBAAiB,OACjB,MAAM;EAGV,MAAM,IAAI,MAAM,6BAA6B,EAAE,OAAO,MAAM,CAAC;CACjE;AACJ;;;;;;;;;;;;;AAcA,IAAa,aAAa,OAAO,KAAoB,IAAY,cAA8D;CAC7H,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAI;EAEF,QAAO,MADmD,IAAI,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CACnF,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,6BAA6B,EAAE,OAAO,MAAM,CAAC;EAGhF,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,6BAA6B,EAAE,OAAO,MAAM,CAAC;CAC/D;AACF"}

package/dist/api/portfolio.js

@@ -19,9 +19,9 @@ var getPortfolio = async (api, id, workspace) => {
 	try {
 		return (await api.get(`${baseUrl}/${id}`, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching portfolio");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching portfolio", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching portfolio");
+		throw new Error("Error while fetching portfolio", { cause: error });
 	}
 };
 /**
@@ -46,9 +46,9 @@ var listPortfolios = async (api, query) => {
 	try {
 		return (await api.get(baseUrl, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching portfolios");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching portfolios", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching portfolios");
+		throw new Error("Error while fetching portfolios", { cause: error });
 	}
 };
 /**
@@ -68,9 +68,9 @@ var createPortfolio = async (api, data) => {
 	try {
 		return (await api.post(baseUrl, data)).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while creating portfolio");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while creating portfolio", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while creating portfolio");
+		throw new Error("Error while creating portfolio", { cause: error });
 	}
 };
 /**
@@ -91,9 +91,9 @@ var updatePortfolio = async (api, id, data) => {
 	try {
 		return (await api.put(`${baseUrl}/${id}`, data)).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while updating portfolio");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while updating portfolio", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while updating portfolio");
+		throw new Error("Error while updating portfolio", { cause: error });
 	}
 };
 /**
@@ -114,9 +114,9 @@ var deletePortfolio = async (api, id, workspace) => {
 	try {
 		return (await api.delete(`${baseUrl}/${id}`, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while deleting portfolio");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while deleting portfolio", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while deleting portfolio");
+		throw new Error("Error while deleting portfolio", { cause: error });
 	}
 };
 //#endregion

package/dist/api/portfolio.js.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio.js","names":[],"sources":["../../src/api/portfolio.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { QueryObject } from \"@/types/entityQuery\";\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { FilterExpression } from \"@/types/entityQuery\";\nimport type { Portfolio, PortfolioListResponse, PortfolioSingleResponse } from \"@/types/portfolio\";\n\nconst baseUrl = \"portfolios\";\n\n/**\n * getPortfolio\n *\n * Fetches a single portfolio by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Portfolio identifier.\n * @param {string} workspace - Workspace the portfolio belongs to.\n * @returns {Promise<PortfolioSingleResponse>} The fetched portfolio response.\n *\n * @throws {Error} If the request fails.\n */\nexport const getPortfolio = async (api: AxiosInstance, id: string, workspace: string): Promise<PortfolioSingleResponse> => {\n  const params: AnyRecord = { workspace };\n\n  if(!workspace){\n    throw new Error(\"Workspace is required to fetch a portfolio\");\n  }\n\n  try {\n    const response: AxiosResponse<PortfolioSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n     throw new Error(error.message || \"Error while fetching portfolio\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching portfolio\");\n  }\n};\n\n/**\n * listPortfolios\n *\n * Fetches a list of portfolios using a query object (filters, order, pagination, etc.).\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {QueryObject} query - Query object built via `buildQueryObject`.\n * @returns {Promise<PortfolioListResponse>} List of portfolios.\n *\n * @throws {Error} If the request fails.\n */\nexport const listPortfolios = async (api: AxiosInstance, query: QueryObject): Promise<PortfolioListResponse> => {\n    const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n    const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n    if (!workspace) {\n      throw new Error(\"Workspace is required to fetch portfolios\");\n    }\n\n    const params: AnyRecord = {\n      workspace,\n      ...(query ? { query: JSON.stringify(query) } : {}),\n    };\n\n    try {\n      const response: AxiosResponse<PortfolioListResponse> = await api.get(baseUrl, { params });\n      return response.data;\n    } catch (error: unknown) {\n      if (isAxiosError<AnyRecord>(error)) {\n        throw new Error(error.message || \"Error while fetching portfolios\");\n      }\n\n      if (error instanceof Error) {\n        throw error;\n      }\n\n      throw new Error(\"Error while fetching portfolios\");\n    }\n}\n\n/**\n * createPortfolio\n *\n * Creates a new portfolio.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Partial<Portfolio>} data - Portfolio payload.\n * @returns {Promise<Portfolio>} The created portfolio.\n *\n * @throws {Error} If the request fails.\n */\nexport const createPortfolio = async (api: AxiosInstance, data: Partial<Portfolio>): Promise<Portfolio> => {\n\n  const { workspace } = data;\n\n   if (!workspace) {\n    throw new Error(\"Workspace is required to post a portfolio\");\n  }\n\n  try {\n    const response: AxiosResponse<Portfolio> = await api.post(baseUrl, data);\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while creating portfolio\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while creating portfolio\");\n  }\n}\n\n/**\n * updatePortfolio\n *\n * Updates an existing portfolio by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Portfolio identifier.\n * @param {Partial<Portfolio>} data - Fields to update.\n * @returns {Promise<Portfolio>} The updated portfolio.\n *\n * @throws {Error} If the request fails.\n */\nexport const updatePortfolio = async (api: AxiosInstance, id: string, data: Partial<Portfolio>): Promise<Portfolio> => {\n\n  const { workspace } = data;\n  \n  if(!workspace) {\n    throw new Error(\"Workspace is required to delete a portfolio\");\n  }\n\n  try {\n    const response: AxiosResponse<Portfolio> = await api.put(`${baseUrl}/${id}`, data);\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while updating portfolio\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while updating portfolio\");\n  }\n}\n\n/**\n * deletePortfolio\n *\n * Deletes a portfolio by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Portfolio identifier.\n * @param {string} workspace - Workspace the portfolio belongs to.\n * @returns {Promise<Portfolio>} The deleted portfolio.\n *\n * @throws {Error} If the request fails.\n */\nexport const deletePortfolio = async (api: AxiosInstance, id: string, workspace: string): Promise<Portfolio> => {\n  \n  if(!workspace) {\n    throw new Error(\"Workspace is required to delete a portfolio\");\n  }\n  \n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<Portfolio> = await api.delete(`${baseUrl}/${id}`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while deleting portfolio\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while deleting portfolio\");\n  }\n}"],"mappings":";;AAOA,IAAM,UAAU;;;;;;;;;;;;;AAchB,IAAa,eAAe,OAAO,KAAoB,IAAY,cAAwD;CACzH,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAG,CAAC,WACF,MAAM,IAAI,MAAM,4CAA4C;CAG9D,IAAI;EAEF,QAAO,MADwD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CACrF;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAChC,MAAM,IAAI,MAAM,MAAM,WAAW,gCAAgC;EAGlE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,gCAAgC;CAClD;AACF;;;;;;;;;;;;AAaA,IAAa,iBAAiB,OAAO,KAAoB,UAAuD;CAC5G,MAAM,kBAAkB,MAAM,QAAQ,MAAM,WAA6B,OAAO,OAAO,WAAW;CAClG,MAAM,YAAY,kBAAkB,gBAAgB,SAAS;CAE7D,IAAI,CAAC,WACH,MAAM,IAAI,MAAM,2CAA2C;CAG7D,MAAM,SAAoB;EACxB;EACA,GAAI,QAAQ,EAAE,OAAO,KAAK,UAAU,KAAK,EAAE,IAAI,CAAC;CAClD;CAEA,IAAI;EAEF,QAAO,MADsD,IAAI,IAAI,SAAS,EAAE,OAAO,CAAC,EAAA,CACxE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,iCAAiC;EAGpE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,iCAAiC;CACnD;AACJ;;;;;;;;;;;;AAaA,IAAa,kBAAkB,OAAO,KAAoB,SAAiD;CAEzG,MAAM,EAAE,cAAc;CAErB,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,2CAA2C;CAG7D,IAAI;EAEF,QAAO,MAD0C,IAAI,KAAK,SAAS,IAAI,EAAA,CACvD;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,gCAAgC;EAGnE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,gCAAgC;CAClD;AACF;;;;;;;;;;;;;AAcA,IAAa,kBAAkB,OAAO,KAAoB,IAAY,SAAiD;CAErH,MAAM,EAAE,cAAc;CAEtB,IAAG,CAAC,WACF,MAAM,IAAI,MAAM,6CAA6C;CAG/D,IAAI;EAEF,QAAO,MAD0C,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,IAAI,EAAA,CACjE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,gCAAgC;EAGnE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,gCAAgC;CAClD;AACF;;;;;;;;;;;;;AAcA,IAAa,kBAAkB,OAAO,KAAoB,IAAY,cAA0C;CAE9G,IAAG,CAAC,WACF,MAAM,IAAI,MAAM,6CAA6C;CAG/D,MAAM,SAAoB,EAAE,UAAU;CAEtC,IAAI;EAEF,QAAO,MAD0C,IAAI,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAA,CAC1E;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,gCAAgC;EAGnE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,gCAAgC;CAClD;AACF"}
+{"version":3,"file":"portfolio.js","names":[],"sources":["../../src/api/portfolio.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { QueryObject } from \"@/types/entityQuery\";\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { FilterExpression } from \"@/types/entityQuery\";\nimport type { Portfolio, PortfolioListResponse, PortfolioSingleResponse } from \"@/types/portfolio\";\n\nconst baseUrl = \"portfolios\";\n\n/**\n * getPortfolio\n *\n * Fetches a single portfolio by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Portfolio identifier.\n * @param {string} workspace - Workspace the portfolio belongs to.\n * @returns {Promise<PortfolioSingleResponse>} The fetched portfolio response.\n *\n * @throws {Error} If the request fails.\n */\nexport const getPortfolio = async (api: AxiosInstance, id: string, workspace: string): Promise<PortfolioSingleResponse> => {\n  const params: AnyRecord = { workspace };\n\n  if(!workspace){\n    throw new Error(\"Workspace is required to fetch a portfolio\");\n  }\n\n  try {\n    const response: AxiosResponse<PortfolioSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n     throw new Error(error.message || \"Error while fetching portfolio\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching portfolio\", { cause: error });\n  }\n};\n\n/**\n * listPortfolios\n *\n * Fetches a list of portfolios using a query object (filters, order, pagination, etc.).\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {QueryObject} query - Query object built via `buildQueryObject`.\n * @returns {Promise<PortfolioListResponse>} List of portfolios.\n *\n * @throws {Error} If the request fails.\n */\nexport const listPortfolios = async (api: AxiosInstance, query: QueryObject): Promise<PortfolioListResponse> => {\n    const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n    const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n    if (!workspace) {\n      throw new Error(\"Workspace is required to fetch portfolios\");\n    }\n\n    const params: AnyRecord = {\n      workspace,\n      ...(query ? { query: JSON.stringify(query) } : {}),\n    };\n\n    try {\n      const response: AxiosResponse<PortfolioListResponse> = await api.get(baseUrl, { params });\n      return response.data;\n    } catch (error: unknown) {\n      if (isAxiosError<AnyRecord>(error)) {\n        throw new Error(error.message || \"Error while fetching portfolios\", { cause: error });\n      }\n\n      if (error instanceof Error) {\n        throw error;\n      }\n\n      throw new Error(\"Error while fetching portfolios\", { cause: error });\n    }\n}\n\n/**\n * createPortfolio\n *\n * Creates a new portfolio.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Partial<Portfolio>} data - Portfolio payload.\n * @returns {Promise<Portfolio>} The created portfolio.\n *\n * @throws {Error} If the request fails.\n */\nexport const createPortfolio = async (api: AxiosInstance, data: Partial<Portfolio>): Promise<Portfolio> => {\n\n  const { workspace } = data;\n\n   if (!workspace) {\n    throw new Error(\"Workspace is required to post a portfolio\");\n  }\n\n  try {\n    const response: AxiosResponse<Portfolio> = await api.post(baseUrl, data);\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while creating portfolio\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while creating portfolio\", { cause: error });\n  }\n}\n\n/**\n * updatePortfolio\n *\n * Updates an existing portfolio by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Portfolio identifier.\n * @param {Partial<Portfolio>} data - Fields to update.\n * @returns {Promise<Portfolio>} The updated portfolio.\n *\n * @throws {Error} If the request fails.\n */\nexport const updatePortfolio = async (api: AxiosInstance, id: string, data: Partial<Portfolio>): Promise<Portfolio> => {\n\n  const { workspace } = data;\n  \n  if(!workspace) {\n    throw new Error(\"Workspace is required to delete a portfolio\");\n  }\n\n  try {\n    const response: AxiosResponse<Portfolio> = await api.put(`${baseUrl}/${id}`, data);\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while updating portfolio\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while updating portfolio\", { cause: error });\n  }\n}\n\n/**\n * deletePortfolio\n *\n * Deletes a portfolio by ID.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} id - Portfolio identifier.\n * @param {string} workspace - Workspace the portfolio belongs to.\n * @returns {Promise<Portfolio>} The deleted portfolio.\n *\n * @throws {Error} If the request fails.\n */\nexport const deletePortfolio = async (api: AxiosInstance, id: string, workspace: string): Promise<Portfolio> => {\n  \n  if(!workspace) {\n    throw new Error(\"Workspace is required to delete a portfolio\");\n  }\n  \n  const params: AnyRecord = { workspace };\n\n  try {\n    const response: AxiosResponse<Portfolio> = await api.delete(`${baseUrl}/${id}`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while deleting portfolio\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while deleting portfolio\", { cause: error });\n  }\n}"],"mappings":"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"}

package/dist/api/profile.js

@@ -60,9 +60,9 @@ var getProfile = async (api, fallback) => {
 	try {
 		return (await api.get(baseUrl)).data.profile;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching profile");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching profile", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching profile");
+		throw new Error("Error while fetching profile", { cause: error });
 	}
 };
 //#endregion

package/dist/api/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","names":[],"sources":["../../src/api/profile.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { Profile, ProfileResponse } from \"@/types/profile\";\n\nconst baseUrl = \"profile\";\n\n/**\n * DEV_PROFILE — the profile served while running the dev server.\n *\n * `GET /api/profile` only works in production: it resolves the user from the session, and in dev\n * the Vite proxy authenticates with OAuth2 client credentials (a machine token, no logged user),\n * so the endpoint has no session to read and the request fails. This stands in for it and covers\n * every field the API returns, so a screen renders with realistic values in dev.\n *\n * The values are deliberately obvious placeholders — see `docs/development.md`.\n */\nexport const DEV_PROFILE: Profile = {\n    email: \"dev@everysk.com\",\n    user_type: \"USER\",\n    region: \"BR\",\n    company_name: \"Everysk (dev)\",\n    first_name: \"Dev\",\n    last_name: \"User\",\n    phone: \"+55 11 0000-0000\",\n    address: \"Dev address, 0\",\n    billing_email: \"dev@everysk.com\",\n    time_zone: \"America/Sao_Paulo\",\n    company_logo: \"\",\n    user_role: \"ADMIN\",\n    skin_theme: \"light\",\n    account_deletion_requested: false,\n    asset: \"\",\n    owner: true,\n    auto_refresh: false,\n};\n\n/**\n * getProfile\n *\n * Fetches the profile of the logged user. The endpoint takes no parameters — the API resolves the\n * user from the session — so an app always gets whoever is using it.\n *\n * When `fallback` is given it is returned as-is and the network is never touched. That is how an\n * app serves `DEV_PROFILE` while running the dev server, where the endpoint cannot resolve.\n *\n * The template decided this itself with `if (import.meta.env.DEV) return DEV_PROFILE`. That\n * cannot live in a published package: Vite replaces `import.meta.env.DEV` with a literal at the\n * build of whoever compiles the file, so the branch would freeze to whatever the SDK's own build\n * was and stop tracking the consuming app entirely. Which environment counts as \"dev\" is the\n * app's question, so the app answers it:\n *\n * ```ts\n * useFetchProfile({ fallback: import.meta.env.DEV ? DEV_PROFILE : undefined });\n * ```\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Profile} [fallback] - Returned instead of calling the API, when present.\n * @returns {Promise<Profile>} The logged user's profile.\n *\n * @throws {Error} If the request fails.\n */\nexport const getProfile = async (api: AxiosInstance, fallback?: Profile): Promise<Profile> => {\n    if (fallback) return fallback;\n\n    try {\n        const response: AxiosResponse<ProfileResponse> = await api.get(baseUrl);\n        return response.data.profile;\n    } catch (error: unknown) {\n        if (isAxiosError<AnyRecord>(error)) {\n            throw new Error(error.message || \"Error while fetching profile\");\n        }\n\n        if (error instanceof Error) {\n            throw error;\n        }\n\n        throw new Error(\"Error while fetching profile\");\n    }\n};\n"],"mappings":";;AAKA,IAAM,UAAU;;;;;;;;;;;AAYhB,IAAa,cAAuB;CAChC,OAAO;CACP,WAAW;CACX,QAAQ;CACR,cAAc;CACd,YAAY;CACZ,WAAW;CACX,OAAO;CACP,SAAS;CACT,eAAe;CACf,WAAW;CACX,cAAc;CACd,WAAW;CACX,YAAY;CACZ,4BAA4B;CAC5B,OAAO;CACP,OAAO;CACP,cAAc;AAClB;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAa,aAAa,OAAO,KAAoB,aAAyC;CAC1F,IAAI,UAAU,OAAO;CAErB,IAAI;EAEA,QAAO,MADgD,IAAI,IAAI,OAAO,EAAA,CACtD,KAAK;CACzB,SAAS,OAAgB;EACrB,IAAI,aAAwB,KAAK,GAC7B,MAAM,IAAI,MAAM,MAAM,WAAW,8BAA8B;EAGnE,IAAI,iBAAiB,OACjB,MAAM;EAGV,MAAM,IAAI,MAAM,8BAA8B;CAClD;AACJ"}
+{"version":3,"file":"profile.js","names":[],"sources":["../../src/api/profile.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { Profile, ProfileResponse } from \"@/types/profile\";\n\nconst baseUrl = \"profile\";\n\n/**\n * DEV_PROFILE — the profile served while running the dev server.\n *\n * `GET /api/profile` only works in production: it resolves the user from the session, and in dev\n * the Vite proxy authenticates with OAuth2 client credentials (a machine token, no logged user),\n * so the endpoint has no session to read and the request fails. This stands in for it and covers\n * every field the API returns, so a screen renders with realistic values in dev.\n *\n * The values are deliberately obvious placeholders — see `docs/development.md`.\n */\nexport const DEV_PROFILE: Profile = {\n    email: \"dev@everysk.com\",\n    user_type: \"USER\",\n    region: \"BR\",\n    company_name: \"Everysk (dev)\",\n    first_name: \"Dev\",\n    last_name: \"User\",\n    phone: \"+55 11 0000-0000\",\n    address: \"Dev address, 0\",\n    billing_email: \"dev@everysk.com\",\n    time_zone: \"America/Sao_Paulo\",\n    company_logo: \"\",\n    user_role: \"ADMIN\",\n    skin_theme: \"light\",\n    account_deletion_requested: false,\n    asset: \"\",\n    owner: true,\n    auto_refresh: false,\n};\n\n/**\n * getProfile\n *\n * Fetches the profile of the logged user. The endpoint takes no parameters — the API resolves the\n * user from the session — so an app always gets whoever is using it.\n *\n * When `fallback` is given it is returned as-is and the network is never touched. That is how an\n * app serves `DEV_PROFILE` while running the dev server, where the endpoint cannot resolve.\n *\n * The template decided this itself with `if (import.meta.env.DEV) return DEV_PROFILE`. That\n * cannot live in a published package: Vite replaces `import.meta.env.DEV` with a literal at the\n * build of whoever compiles the file, so the branch would freeze to whatever the SDK's own build\n * was and stop tracking the consuming app entirely. Which environment counts as \"dev\" is the\n * app's question, so the app answers it:\n *\n * ```ts\n * useFetchProfile({ fallback: import.meta.env.DEV ? DEV_PROFILE : undefined });\n * ```\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {Profile} [fallback] - Returned instead of calling the API, when present.\n * @returns {Promise<Profile>} The logged user's profile.\n *\n * @throws {Error} If the request fails.\n */\nexport const getProfile = async (api: AxiosInstance, fallback?: Profile): Promise<Profile> => {\n    if (fallback) return fallback;\n\n    try {\n        const response: AxiosResponse<ProfileResponse> = await api.get(baseUrl);\n        return response.data.profile;\n    } catch (error: unknown) {\n        if (isAxiosError<AnyRecord>(error)) {\n            throw new Error(error.message || \"Error while fetching profile\", { cause: error });\n        }\n\n        if (error instanceof Error) {\n            throw error;\n        }\n\n        throw new Error(\"Error while fetching profile\", { cause: error });\n    }\n};\n"],"mappings":";;AAKA,IAAM,UAAU;;;;;;;;;;;AAYhB,IAAa,cAAuB;CAChC,OAAO;CACP,WAAW;CACX,QAAQ;CACR,cAAc;CACd,YAAY;CACZ,WAAW;CACX,OAAO;CACP,SAAS;CACT,eAAe;CACf,WAAW;CACX,cAAc;CACd,WAAW;CACX,YAAY;CACZ,4BAA4B;CAC5B,OAAO;CACP,OAAO;CACP,cAAc;AAClB;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAa,aAAa,OAAO,KAAoB,aAAyC;CAC1F,IAAI,UAAU,OAAO;CAErB,IAAI;EAEA,QAAO,MADgD,IAAI,IAAI,OAAO,EAAA,CACtD,KAAK;CACzB,SAAS,OAAgB;EACrB,IAAI,aAAwB,KAAK,GAC7B,MAAM,IAAI,MAAM,MAAM,WAAW,gCAAgC,EAAE,OAAO,MAAM,CAAC;EAGrF,IAAI,iBAAiB,OACjB,MAAM;EAGV,MAAM,IAAI,MAAM,gCAAgC,EAAE,OAAO,MAAM,CAAC;CACpE;AACJ"}

package/dist/api/websocketsConfig.js

@@ -14,9 +14,9 @@ var getWebsocketsConfig = async (api) => {
 	try {
 		return (await api.get(baseUrl)).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error fetching websockets config");
+		if (isAxiosError(error)) throw new Error(error.message || "Error fetching websockets config", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error fetching websockets config");
+		throw new Error("Error fetching websockets config", { cause: error });
 	}
 };
 //#endregion

package/dist/api/websocketsConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocketsConfig.js","names":[],"sources":["../../src/api/websocketsConfig.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { WebsocketsConfig } from \"@/contexts/webSocketContext/types\";\n\nconst baseUrl = \"websockets_config\";\n\n/**\n * getWebsocketsConfig\n *\n * Fetches the Socket.IO connection config for the current user/app.\n *\n * @param {AxiosInstance} api - Axios instance (from `useAxios`).\n * @returns {Promise<WebsocketsConfig>} Connection URL, channel id, and session uid.\n * @throws {Error} If the request fails.\n */\nexport const getWebsocketsConfig = async (api: AxiosInstance): Promise<WebsocketsConfig> => {\n    try {\n        const response: AxiosResponse<WebsocketsConfig> = await api.get(baseUrl);\n        return response.data;\n    } catch (error: unknown) {\n        if (isAxiosError<AnyRecord>(error)) {\n            throw new Error(error.message || \"Error fetching websockets config\");\n        }\n\n        if (error instanceof Error) {\n            throw error;\n        }\n\n        throw new Error(\"Error fetching websockets config\");\n    }\n};\n"],"mappings":";;AAKA,IAAM,UAAU;;;;;;;;;;AAWhB,IAAa,sBAAsB,OAAO,QAAkD;CACxF,IAAI;EAEA,QAAO,MADiD,IAAI,IAAI,OAAO,EAAA,CACvD;CACpB,SAAS,OAAgB;EACrB,IAAI,aAAwB,KAAK,GAC7B,MAAM,IAAI,MAAM,MAAM,WAAW,kCAAkC;EAGvE,IAAI,iBAAiB,OACjB,MAAM;EAGV,MAAM,IAAI,MAAM,kCAAkC;CACtD;AACJ"}
+{"version":3,"file":"websocketsConfig.js","names":[],"sources":["../../src/api/websocketsConfig.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { WebsocketsConfig } from \"@/contexts/webSocketContext/types\";\n\nconst baseUrl = \"websockets_config\";\n\n/**\n * getWebsocketsConfig\n *\n * Fetches the Socket.IO connection config for the current user/app.\n *\n * @param {AxiosInstance} api - Axios instance (from `useAxios`).\n * @returns {Promise<WebsocketsConfig>} Connection URL, channel id, and session uid.\n * @throws {Error} If the request fails.\n */\nexport const getWebsocketsConfig = async (api: AxiosInstance): Promise<WebsocketsConfig> => {\n    try {\n        const response: AxiosResponse<WebsocketsConfig> = await api.get(baseUrl);\n        return response.data;\n    } catch (error: unknown) {\n        if (isAxiosError<AnyRecord>(error)) {\n            throw new Error(error.message || \"Error fetching websockets config\", { cause: error });\n        }\n\n        if (error instanceof Error) {\n            throw error;\n        }\n\n        throw new Error(\"Error fetching websockets config\", { cause: error });\n    }\n};\n"],"mappings":";;AAKA,IAAM,UAAU;;;;;;;;;;AAWhB,IAAa,sBAAsB,OAAO,QAAkD;CACxF,IAAI;EAEA,QAAO,MADiD,IAAI,IAAI,OAAO,EAAA,CACvD;CACpB,SAAS,OAAgB;EACrB,IAAI,aAAwB,KAAK,GAC7B,MAAM,IAAI,MAAM,MAAM,WAAW,oCAAoC,EAAE,OAAO,MAAM,CAAC;EAGzF,IAAI,iBAAiB,OACjB,MAAM;EAGV,MAAM,IAAI,MAAM,oCAAoC,EAAE,OAAO,MAAM,CAAC;CACxE;AACJ"}

package/dist/api/workflow.js

@@ -24,9 +24,9 @@ var runWorkflow = async (api, id, workspace, parameters) => {
 		};
 		return (await api.post(`${baseUrl}/${id}/run`, body)).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "");
+		if (isAxiosError(error)) throw new Error(error.message || "", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while running workflow");
+		throw new Error("Error while running workflow", { cause: error });
 	}
 };
 /**
@@ -148,9 +148,9 @@ var getWorkflow = async (api, id, workspace) => {
 		const params = { workspace };
 		return (await api.get(`${baseUrl}/${id}`, { params })).data.workflow;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workflow");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workflow", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching workflow");
+		throw new Error("Error while fetching workflow", { cause: error });
 	}
 };
 /**
@@ -171,9 +171,9 @@ var listWorkflows = async (api, workspace, pageSize, pageToken) => {
 	try {
 		return (await api.get(baseUrl, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error listing workflows");
+		if (isAxiosError(error)) throw new Error(error.message || "Error listing workflows", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error listing workflows");
+		throw new Error("Error listing workflows", { cause: error });
 	}
 };
 /**
@@ -196,9 +196,9 @@ var getWorkflowExecution = async (api, workflowId, executionId, workspace) => {
 		};
 		return (await api.get(`${baseUrl}/${workflowId}/workflow_executions`, { params })).data.workflow_execution;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error fetching workflow execution");
+		if (isAxiosError(error)) throw new Error(error.message || "Error fetching workflow execution", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error fetching workflow execution");
+		throw new Error("Error fetching workflow execution", { cause: error });
 	}
 };
 /**
@@ -223,9 +223,9 @@ var listWorkflowExecutions = async (api, workflowId, query) => {
 		};
 		return (await api.get(`${baseUrl}/${workflowId}/workflow_executions`, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error listing workflow executions");
+		if (isAxiosError(error)) throw new Error(error.message || "Error listing workflow executions", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error listing workflow executions");
+		throw new Error("Error listing workflow executions", { cause: error });
 	}
 };
 /**
@@ -249,9 +249,9 @@ var getWorkerExecution = async (api, workflowId, workerExecutionId, workspace) =
 		};
 		return (await api.get(`${baseUrl}/${workflowId}/worker_executions`, { params })).data.worker_execution;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error fetching worker execution");
+		if (isAxiosError(error)) throw new Error(error.message || "Error fetching worker execution", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error fetching worker execution");
+		throw new Error("Error fetching worker execution", { cause: error });
 	}
 };
 /**
@@ -278,9 +278,9 @@ var listWorkerExecutions = async (api, workflowId, workflowExecutionId, query) =
 		};
 		return (await api.get(`${baseUrl}/${workflowId}/worker_executions`, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error listing worker executions");
+		if (isAxiosError(error)) throw new Error(error.message || "Error listing worker executions", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error listing worker executions");
+		throw new Error("Error listing worker executions", { cause: error });
 	}
 };
 //#endregion

package/dist/api/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","names":[],"sources":["../../src/api/workflow.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { FilterExpression, QueryObject } from \"@/types/entityQuery\";\nimport type { WorkerExecution, WorkerExecutionListResponse, WorkerExecutionSingleResponse, Workflow, WorkflowExecution, WorkflowExecutionListResponse, WorkflowExecutionSingleResponse, WorkflowListResponse, WorkflowSingleResponse } from \"@/types/workflow\";\n\nconst baseUrl = \"workflows\";\n\n/**\n * Runs a workflow asynchronously.\n *\n * Starts the workflow in a non-blocking way: the response carries a workflow execution\n * with a non-terminal status (e.g. \"RUNNING\"). Use polling to wait for the terminal state.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to run.\n * @param workspace - The workspace in which the workflow will be executed.\n * @param parameters - Key-value parameters to pass to the workflow.\n * @returns A promise that resolves with the workflow execution response data.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const runWorkflow = async (api: AxiosInstance, id: string, workspace: string, parameters: AnyRecord): Promise<AnyRecord> => {\n  \n  if (!workspace) {\n    throw new Error(\"Workspace is required to run workflow\");\n  } \n\n  try {\n    const body: AnyRecord = {\n      workspace,\n      parameters,\n    };\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const response: AxiosResponse<any> = await api.post(`${baseUrl}/${id}/run`, body);\n\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while running workflow\");\n  }\n};\n\n/**\n * Run statuses that indicate a workflow execution has reached a terminal state\n * (i.e. it is no longer running and will not change again).\n *\n * Union of the backend's `WORKFLOW_EXECUTION_STATUS_FINISHED` set and the API's documented\n * terminal `run_status` values (`SUCCEEDED`/`FAILED`/`KILLED`). `KILLED` is included so a\n * killed execution is detected as terminal instead of polling until timeout.\n */\nexport const TERMINAL_RUN_STATUSES = [\"CANCELED\", \"COMPLETED\", \"SUCCEEDED\", \"FAILED\", \"KILLED\"] as const;\n\nconst isTerminalRunStatus = (runStatus: unknown): boolean =>\n  TERMINAL_RUN_STATUSES.includes(String(runStatus ?? \"\").toUpperCase() as (typeof TERMINAL_RUN_STATUSES)[number]);\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nexport type PollWorkflowExecutionOptions = {\n  /** Delay between status checks, in milliseconds. Defaults to 2000ms. */\n  intervalMs?: number;\n  /** Maximum time to wait for a terminal status before giving up, in milliseconds. Defaults to 5 minutes. */\n  timeoutMs?: number;\n  /** Optional abort signal to cancel polling (e.g. on unmount). */\n  signal?: AbortSignal;\n};\n\n/**\n * Polls a workflow execution until it reaches a terminal run status (see {@link TERMINAL_RUN_STATUSES}).\n *\n * This is the interim, non-blocking replacement for synchronous (`synchronous: true`) execution:\n * the workflow is started asynchronously and its status is checked periodically until it completes.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the workflow.\n * @param executionId - The unique identifier of the workflow execution to poll.\n * @param workspace - The workspace in which the workflow execution resides.\n * @param options - Polling configuration (interval, timeout, abort signal).\n * @returns A promise that resolves with the terminal {@link WorkflowExecution}.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If polling is aborted via `options.signal`.\n * @throws {Error} If a terminal status is not reached before `options.timeoutMs` elapses.\n */\nexport const pollWorkflowExecution = async (\n  api: AxiosInstance,\n  workflowId: string,\n  executionId: string,\n  workspace: string,\n  options: PollWorkflowExecutionOptions = {}\n): Promise<WorkflowExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to poll a workflow execution\");\n  }\n\n  const { intervalMs = 2000, timeoutMs = 5 * 60 * 1000, signal } = options;\n  const startedAt = Date.now();\n\n  while (true) {\n    if (signal?.aborted) {\n      throw new Error(\"Workflow execution polling was aborted\");\n    }\n\n    const execution = await getWorkflowExecution(api, workflowId, executionId, workspace);\n\n    if (isTerminalRunStatus(execution.run_status)) {\n      return execution;\n    }\n\n    if (Date.now() - startedAt >= timeoutMs) {\n      throw new Error(\"Timed out while waiting for the workflow execution to complete\");\n    }\n\n    await sleep(intervalMs);\n  }\n};\n\n/**\n * Starts a workflow asynchronously and polls its execution until completion.\n *\n * Interim replacement for synchronous execution: instead of holding the request open with\n * `synchronous: true`, the workflow is started in a non-blocking way and its status is polled\n * until it reaches a terminal state, at which point the final execution (with its result) is returned.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to run.\n * @param workspace - The workspace in which the workflow will be executed.\n * @param parameters - Key-value parameters to pass to the workflow.\n * @param options - Polling configuration (interval, timeout, abort signal).\n * @returns A promise that resolves with the terminal {@link WorkflowExecution}.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the run response does not contain a workflow execution id.\n * @throws {Error} If the workflow execution ends in a \"FAILED\" run status.\n * @throws {Error} If polling times out or is aborted.\n */\nconst runWorkflowAndPoll = async (\n  api: AxiosInstance,\n  id: string,\n  workspace: string,\n  parameters: AnyRecord,\n  options: PollWorkflowExecutionOptions = {}\n): Promise<WorkflowExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to run workflow\");\n  }\n\n  // Start the workflow asynchronously (non-blocking).\n  const startResponse = await runWorkflow(api, id, workspace, parameters);\n  const executionId = (startResponse.workflow_execution as WorkflowExecution | undefined)?.id;\n\n  if (!executionId) {\n    throw new Error(\"Workflow run did not return an execution id to poll\");\n  }\n\n  // Poll the execution status until it completes, then consume the result.\n  const execution = await pollWorkflowExecution(api, id, executionId, workspace, options);\n\n  if (String(execution.run_status ?? \"\").toUpperCase() === \"FAILED\") {\n    throw new Error(\"Workflow execution failed\");\n  }\n\n  return execution;\n};\n\n/**\n * The terminal workflow execution together with the output produced by its final (ender) worker.\n */\nexport type WorkflowResult = {\n  /** The terminal workflow execution. */\n  execution: WorkflowExecution;\n  /** The ender worker execution, or `null` if the execution did not reference one. */\n  workerExecution: WorkerExecution | null;\n  /** The output data produced by the ender worker (`workerExecution.result`), or `null`. */\n  result: Record<string, unknown> | null;\n};\n\n/**\n * Starts a workflow, polls it to completion, then fetches the output produced by its final worker.\n *\n * A workflow execution does not carry the output payload itself — it references the final worker via\n * `ender_worker_execution_id`, and that worker execution's `result` field holds the actual data.\n * This helper performs the full flow: start (async) → poll → fetch ender worker → return its `result`.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to run.\n * @param workspace - The workspace in which the workflow will be executed.\n * @param parameters - Key-value parameters to pass to the workflow.\n * @param options - Polling configuration (interval, timeout, abort signal).\n * @returns A promise that resolves with the {@link WorkflowResult} (execution, ender worker execution, and its result).\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the workflow execution ends in a \"FAILED\" run status.\n * @throws {Error} If polling times out or is aborted.\n */\nexport const runWorkflowAndGetResult = async (\n  api: AxiosInstance,\n  id: string,\n  workspace: string,\n  parameters: AnyRecord,\n  options: PollWorkflowExecutionOptions = {}\n): Promise<WorkflowResult> => {\n  const execution = await runWorkflowAndPoll(api, id, workspace, parameters, options);\n\n  const enderWorkerExecutionId = execution.ender_worker_execution_id;\n  if (!enderWorkerExecutionId) {\n    return { execution, workerExecution: null, result: null };\n  }\n\n  const workerExecution = await getWorkerExecution(api, id, enderWorkerExecutionId, workspace);\n\n  return { execution, workerExecution, result: workerExecution.result ?? null };\n};\n\n/**\n * Fetches a single workflow by ID.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to fetch.\n * @param workspace - The workspace in which the workflow resides.\n * @returns A promise that resolves with the {@link Workflow} object.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const getWorkflow = async (api: AxiosInstance, id: string, workspace: string): Promise<Workflow> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to fetch a workflow\");\n  }\n  \n  try {\n    const params: AnyRecord = { workspace };\n    const response: AxiosResponse<WorkflowSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n\n    return response.data.workflow;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workflow\");\n    } \n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workflow\");\n  }\n};\n\n/**\n * Fetches a paginated list of workflows using the legacy method (workspace as query param).\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workspace - Current workspace name. Sent as a query param via the legacy method, required by some API configurations.\n * @param pageSize - Number of items per page.\n * @param pageToken - Cursor token for the next page.\n * @returns A promise that resolves with a {@link WorkflowListResponse} containing the matched workflows.\n * @throws {Error} If the request fails.\n */\nexport const listWorkflows = async (api: AxiosInstance, workspace?: string, pageSize?: number, pageToken?: string): Promise<WorkflowListResponse> => {\n  const params: AnyRecord = {};\n\n  if (workspace) params.workspace = workspace;\n  if (pageSize) params.page_size = pageSize;\n  if (pageToken) params.page_token = pageToken;\n\n  try {\n    const response: AxiosResponse<WorkflowListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing workflows\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing workflows\");\n  }\n};\n\n/**\n * Fetches a single workflow execution by ID.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the workflow.\n * @param executionId - The unique identifier of the workflow execution to fetch.\n * @param workspace - The workspace in which the workflow execution resides.\n * @returns A promise that resolves with the {@link WorkflowExecution} object.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const getWorkflowExecution = async (api: AxiosInstance, workflowId: string, executionId: string, workspace: string): Promise<WorkflowExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to fetch a workflow execution\");\n  }\n\n  try {\n    const params: AnyRecord = { workspace, workflow_execution_id: executionId };\n    const response: AxiosResponse<WorkflowExecutionSingleResponse> = await api.get(`${baseUrl}/${workflowId}/workflow_executions`, { params });\n    return response.data.workflow_execution;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error fetching workflow execution\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error fetching workflow execution\");\n  }\n};\n\n/**\n * Fetches a paginated list of workflow executions matching the given query.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the workflow whose executions to list.\n * @param query - Query object containing filters, pagination, and sorting options.\n *   Must include a `workspace` filter expression.\n * @returns A promise that resolves with a {@link WorkflowExecutionListResponse} containing the matched executions.\n * @throws {Error} If the `workspace` filter is not present in `query.filters`.\n * @throws {Error} If the request fails.\n */\nexport const listWorkflowExecutions = async (api: AxiosInstance, workflowId: string, query: QueryObject): Promise<WorkflowExecutionListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n  if (!workspace) throw new Error(\"Workspace filter is required to list workflows\");\n\n  try {\n    const params: AnyRecord = {\n      workspace,\n      ...(query ? { query: JSON.stringify(query) } : {}),\n    };\n\n    const response: AxiosResponse<WorkflowExecutionListResponse> = await api.get(`${baseUrl}/${workflowId}/workflow_executions`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing workflow executions\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing workflow executions\");\n  }\n};\n\n/**\n * Fetches a single worker execution by ID.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the parent workflow.\n * @param workerExecutionId - The unique identifier of the worker execution to fetch.\n * @param workspace - The workspace in which the worker execution resides.\n * @returns A promise that resolves with the {@link WorkerExecution} object.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const getWorkerExecution = async (api: AxiosInstance, workflowId: string, workerExecutionId: string, workspace: string): Promise<WorkerExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to fetch a worker execution\");\n  }\n\n  try {\n    const params: AnyRecord = { workspace, worker_execution_id: workerExecutionId, with_result: true };\n    const response: AxiosResponse<WorkerExecutionSingleResponse> = await api.get(`${baseUrl}/${workflowId}/worker_executions`, { params });\n    return response.data.worker_execution;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error fetching worker execution\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error fetching worker execution\");\n  }\n}\n\n/**\n * Fetches a paginated list of worker executions for a given workflow.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the parent workflow.\n * @param workflowExecutionId - The unique identifier of the workflow execution to filter by.\n * @param query - Query object containing filters, pagination, and sorting options.\n *   Must include a `workspace` filter expression.\n * @returns A promise that resolves with a {@link WorkerExecutionListResponse} containing the matched worker executions.\n * @throws {Error} If the `workspace` filter is not present in `query.filters`.\n * @throws {Error} If the request fails.\n */\nexport const listWorkerExecutions = async (api: AxiosInstance, workflowId: string, workflowExecutionId: string, query: QueryObject): Promise<WorkerExecutionListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n  if (!workspace) throw new Error(\"Workspace filter is required to list worker executions\");\n\n  try {\n    const params: AnyRecord = {\n      workspace,\n      workflow_execution_id: workflowExecutionId,\n      ...(query ? { query: JSON.stringify(query) } : {}),\n    };\n\n    const response: AxiosResponse<WorkerExecutionListResponse> = await api.get(`${baseUrl}/${workflowId}/worker_executions`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing worker executions\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing worker executions\");\n  }\n};"],"mappings":"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"}
+{"version":3,"file":"workflow.js","names":[],"sources":["../../src/api/workflow.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { FilterExpression, QueryObject } from \"@/types/entityQuery\";\nimport type { WorkerExecution, WorkerExecutionListResponse, WorkerExecutionSingleResponse, Workflow, WorkflowExecution, WorkflowExecutionListResponse, WorkflowExecutionSingleResponse, WorkflowListResponse, WorkflowSingleResponse } from \"@/types/workflow\";\n\nconst baseUrl = \"workflows\";\n\n/**\n * Runs a workflow asynchronously.\n *\n * Starts the workflow in a non-blocking way: the response carries a workflow execution\n * with a non-terminal status (e.g. \"RUNNING\"). Use polling to wait for the terminal state.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to run.\n * @param workspace - The workspace in which the workflow will be executed.\n * @param parameters - Key-value parameters to pass to the workflow.\n * @returns A promise that resolves with the workflow execution response data.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const runWorkflow = async (api: AxiosInstance, id: string, workspace: string, parameters: AnyRecord): Promise<AnyRecord> => {\n  \n  if (!workspace) {\n    throw new Error(\"Workspace is required to run workflow\");\n  } \n\n  try {\n    const body: AnyRecord = {\n      workspace,\n      parameters,\n    };\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const response: AxiosResponse<any> = await api.post(`${baseUrl}/${id}/run`, body);\n\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while running workflow\", { cause: error });\n  }\n};\n\n/**\n * Run statuses that indicate a workflow execution has reached a terminal state\n * (i.e. it is no longer running and will not change again).\n *\n * Union of the backend's `WORKFLOW_EXECUTION_STATUS_FINISHED` set and the API's documented\n * terminal `run_status` values (`SUCCEEDED`/`FAILED`/`KILLED`). `KILLED` is included so a\n * killed execution is detected as terminal instead of polling until timeout.\n */\nexport const TERMINAL_RUN_STATUSES = [\"CANCELED\", \"COMPLETED\", \"SUCCEEDED\", \"FAILED\", \"KILLED\"] as const;\n\nconst isTerminalRunStatus = (runStatus: unknown): boolean =>\n  TERMINAL_RUN_STATUSES.includes(String(runStatus ?? \"\").toUpperCase() as (typeof TERMINAL_RUN_STATUSES)[number]);\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nexport type PollWorkflowExecutionOptions = {\n  /** Delay between status checks, in milliseconds. Defaults to 2000ms. */\n  intervalMs?: number;\n  /** Maximum time to wait for a terminal status before giving up, in milliseconds. Defaults to 5 minutes. */\n  timeoutMs?: number;\n  /** Optional abort signal to cancel polling (e.g. on unmount). */\n  signal?: AbortSignal;\n};\n\n/**\n * Polls a workflow execution until it reaches a terminal run status (see {@link TERMINAL_RUN_STATUSES}).\n *\n * This is the interim, non-blocking replacement for synchronous (`synchronous: true`) execution:\n * the workflow is started asynchronously and its status is checked periodically until it completes.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the workflow.\n * @param executionId - The unique identifier of the workflow execution to poll.\n * @param workspace - The workspace in which the workflow execution resides.\n * @param options - Polling configuration (interval, timeout, abort signal).\n * @returns A promise that resolves with the terminal {@link WorkflowExecution}.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If polling is aborted via `options.signal`.\n * @throws {Error} If a terminal status is not reached before `options.timeoutMs` elapses.\n */\nexport const pollWorkflowExecution = async (\n  api: AxiosInstance,\n  workflowId: string,\n  executionId: string,\n  workspace: string,\n  options: PollWorkflowExecutionOptions = {}\n): Promise<WorkflowExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to poll a workflow execution\");\n  }\n\n  const { intervalMs = 2000, timeoutMs = 5 * 60 * 1000, signal } = options;\n  const startedAt = Date.now();\n\n  while (true) {\n    if (signal?.aborted) {\n      throw new Error(\"Workflow execution polling was aborted\");\n    }\n\n    const execution = await getWorkflowExecution(api, workflowId, executionId, workspace);\n\n    if (isTerminalRunStatus(execution.run_status)) {\n      return execution;\n    }\n\n    if (Date.now() - startedAt >= timeoutMs) {\n      throw new Error(\"Timed out while waiting for the workflow execution to complete\");\n    }\n\n    await sleep(intervalMs);\n  }\n};\n\n/**\n * Starts a workflow asynchronously and polls its execution until completion.\n *\n * Interim replacement for synchronous execution: instead of holding the request open with\n * `synchronous: true`, the workflow is started in a non-blocking way and its status is polled\n * until it reaches a terminal state, at which point the final execution (with its result) is returned.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to run.\n * @param workspace - The workspace in which the workflow will be executed.\n * @param parameters - Key-value parameters to pass to the workflow.\n * @param options - Polling configuration (interval, timeout, abort signal).\n * @returns A promise that resolves with the terminal {@link WorkflowExecution}.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the run response does not contain a workflow execution id.\n * @throws {Error} If the workflow execution ends in a \"FAILED\" run status.\n * @throws {Error} If polling times out or is aborted.\n */\nconst runWorkflowAndPoll = async (\n  api: AxiosInstance,\n  id: string,\n  workspace: string,\n  parameters: AnyRecord,\n  options: PollWorkflowExecutionOptions = {}\n): Promise<WorkflowExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to run workflow\");\n  }\n\n  // Start the workflow asynchronously (non-blocking).\n  const startResponse = await runWorkflow(api, id, workspace, parameters);\n  const executionId = (startResponse.workflow_execution as WorkflowExecution | undefined)?.id;\n\n  if (!executionId) {\n    throw new Error(\"Workflow run did not return an execution id to poll\");\n  }\n\n  // Poll the execution status until it completes, then consume the result.\n  const execution = await pollWorkflowExecution(api, id, executionId, workspace, options);\n\n  if (String(execution.run_status ?? \"\").toUpperCase() === \"FAILED\") {\n    throw new Error(\"Workflow execution failed\");\n  }\n\n  return execution;\n};\n\n/**\n * The terminal workflow execution together with the output produced by its final (ender) worker.\n */\nexport type WorkflowResult = {\n  /** The terminal workflow execution. */\n  execution: WorkflowExecution;\n  /** The ender worker execution, or `null` if the execution did not reference one. */\n  workerExecution: WorkerExecution | null;\n  /** The output data produced by the ender worker (`workerExecution.result`), or `null`. */\n  result: Record<string, unknown> | null;\n};\n\n/**\n * Starts a workflow, polls it to completion, then fetches the output produced by its final worker.\n *\n * A workflow execution does not carry the output payload itself — it references the final worker via\n * `ender_worker_execution_id`, and that worker execution's `result` field holds the actual data.\n * This helper performs the full flow: start (async) → poll → fetch ender worker → return its `result`.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to run.\n * @param workspace - The workspace in which the workflow will be executed.\n * @param parameters - Key-value parameters to pass to the workflow.\n * @param options - Polling configuration (interval, timeout, abort signal).\n * @returns A promise that resolves with the {@link WorkflowResult} (execution, ender worker execution, and its result).\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the workflow execution ends in a \"FAILED\" run status.\n * @throws {Error} If polling times out or is aborted.\n */\nexport const runWorkflowAndGetResult = async (\n  api: AxiosInstance,\n  id: string,\n  workspace: string,\n  parameters: AnyRecord,\n  options: PollWorkflowExecutionOptions = {}\n): Promise<WorkflowResult> => {\n  const execution = await runWorkflowAndPoll(api, id, workspace, parameters, options);\n\n  const enderWorkerExecutionId = execution.ender_worker_execution_id;\n  if (!enderWorkerExecutionId) {\n    return { execution, workerExecution: null, result: null };\n  }\n\n  const workerExecution = await getWorkerExecution(api, id, enderWorkerExecutionId, workspace);\n\n  return { execution, workerExecution, result: workerExecution.result ?? null };\n};\n\n/**\n * Fetches a single workflow by ID.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param id - The unique identifier of the workflow to fetch.\n * @param workspace - The workspace in which the workflow resides.\n * @returns A promise that resolves with the {@link Workflow} object.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const getWorkflow = async (api: AxiosInstance, id: string, workspace: string): Promise<Workflow> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to fetch a workflow\");\n  }\n  \n  try {\n    const params: AnyRecord = { workspace };\n    const response: AxiosResponse<WorkflowSingleResponse> = await api.get(`${baseUrl}/${id}`, { params });\n\n    return response.data.workflow;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workflow\", { cause: error });\n    } \n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workflow\", { cause: error });\n  }\n};\n\n/**\n * Fetches a paginated list of workflows using the legacy method (workspace as query param).\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workspace - Current workspace name. Sent as a query param via the legacy method, required by some API configurations.\n * @param pageSize - Number of items per page.\n * @param pageToken - Cursor token for the next page.\n * @returns A promise that resolves with a {@link WorkflowListResponse} containing the matched workflows.\n * @throws {Error} If the request fails.\n */\nexport const listWorkflows = async (api: AxiosInstance, workspace?: string, pageSize?: number, pageToken?: string): Promise<WorkflowListResponse> => {\n  const params: AnyRecord = {};\n\n  if (workspace) params.workspace = workspace;\n  if (pageSize) params.page_size = pageSize;\n  if (pageToken) params.page_token = pageToken;\n\n  try {\n    const response: AxiosResponse<WorkflowListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing workflows\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing workflows\", { cause: error });\n  }\n};\n\n/**\n * Fetches a single workflow execution by ID.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the workflow.\n * @param executionId - The unique identifier of the workflow execution to fetch.\n * @param workspace - The workspace in which the workflow execution resides.\n * @returns A promise that resolves with the {@link WorkflowExecution} object.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const getWorkflowExecution = async (api: AxiosInstance, workflowId: string, executionId: string, workspace: string): Promise<WorkflowExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to fetch a workflow execution\");\n  }\n\n  try {\n    const params: AnyRecord = { workspace, workflow_execution_id: executionId };\n    const response: AxiosResponse<WorkflowExecutionSingleResponse> = await api.get(`${baseUrl}/${workflowId}/workflow_executions`, { params });\n    return response.data.workflow_execution;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error fetching workflow execution\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error fetching workflow execution\", { cause: error });\n  }\n};\n\n/**\n * Fetches a paginated list of workflow executions matching the given query.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the workflow whose executions to list.\n * @param query - Query object containing filters, pagination, and sorting options.\n *   Must include a `workspace` filter expression.\n * @returns A promise that resolves with a {@link WorkflowExecutionListResponse} containing the matched executions.\n * @throws {Error} If the `workspace` filter is not present in `query.filters`.\n * @throws {Error} If the request fails.\n */\nexport const listWorkflowExecutions = async (api: AxiosInstance, workflowId: string, query: QueryObject): Promise<WorkflowExecutionListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n  if (!workspace) throw new Error(\"Workspace filter is required to list workflows\");\n\n  try {\n    const params: AnyRecord = {\n      workspace,\n      ...(query ? { query: JSON.stringify(query) } : {}),\n    };\n\n    const response: AxiosResponse<WorkflowExecutionListResponse> = await api.get(`${baseUrl}/${workflowId}/workflow_executions`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing workflow executions\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing workflow executions\", { cause: error });\n  }\n};\n\n/**\n * Fetches a single worker execution by ID.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the parent workflow.\n * @param workerExecutionId - The unique identifier of the worker execution to fetch.\n * @param workspace - The workspace in which the worker execution resides.\n * @returns A promise that resolves with the {@link WorkerExecution} object.\n * @throws {Error} If `workspace` is not provided.\n * @throws {Error} If the request fails.\n */\nexport const getWorkerExecution = async (api: AxiosInstance, workflowId: string, workerExecutionId: string, workspace: string): Promise<WorkerExecution> => {\n  if (!workspace) {\n    throw new Error(\"Workspace is required to fetch a worker execution\");\n  }\n\n  try {\n    const params: AnyRecord = { workspace, worker_execution_id: workerExecutionId, with_result: true };\n    const response: AxiosResponse<WorkerExecutionSingleResponse> = await api.get(`${baseUrl}/${workflowId}/worker_executions`, { params });\n    return response.data.worker_execution;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error fetching worker execution\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error fetching worker execution\", { cause: error });\n  }\n}\n\n/**\n * Fetches a paginated list of worker executions for a given workflow.\n *\n * @param api - Axios instance used to make the HTTP request.\n * @param workflowId - The unique identifier of the parent workflow.\n * @param workflowExecutionId - The unique identifier of the workflow execution to filter by.\n * @param query - Query object containing filters, pagination, and sorting options.\n *   Must include a `workspace` filter expression.\n * @returns A promise that resolves with a {@link WorkerExecutionListResponse} containing the matched worker executions.\n * @throws {Error} If the `workspace` filter is not present in `query.filters`.\n * @throws {Error} If the request fails.\n */\nexport const listWorkerExecutions = async (api: AxiosInstance, workflowId: string, workflowExecutionId: string, query: QueryObject): Promise<WorkerExecutionListResponse> => {\n  const workspaceFilter = query.filters.find((filter: FilterExpression) => filter[0] === \"workspace\");\n  const workspace = workspaceFilter?.[workspaceFilter.length - 1];\n\n  if (!workspace) throw new Error(\"Workspace filter is required to list worker executions\");\n\n  try {\n    const params: AnyRecord = {\n      workspace,\n      workflow_execution_id: workflowExecutionId,\n      ...(query ? { query: JSON.stringify(query) } : {}),\n    };\n\n    const response: AxiosResponse<WorkerExecutionListResponse> = await api.get(`${baseUrl}/${workflowId}/worker_executions`, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error listing worker executions\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error listing worker executions\", { cause: error });\n  }\n};"],"mappings":"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"}

package/dist/api/workspace.js

@@ -17,9 +17,9 @@ var getWorkspace = async (api, name) => {
 	try {
 		return (await api.get(`${baseUrl}/${name}`)).data.workspace;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workspace");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workspace", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching workspace");
+		throw new Error("Error while fetching workspace", { cause: error });
 	}
 };
 /**
@@ -43,9 +43,9 @@ var listWorkspaces = async (api, workspace, pageSize, pageToken) => {
 	try {
 		return (await api.get(baseUrl, { params })).data;
 	} catch (error) {
-		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workspaces");
+		if (isAxiosError(error)) throw new Error(error.message || "Error while fetching workspaces", { cause: error });
 		if (error instanceof Error) throw error;
-		throw new Error("Error while fetching workspaces");
+		throw new Error("Error while fetching workspaces", { cause: error });
 	}
 };
 //#endregion

package/dist/api/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","names":[],"sources":["../../src/api/workspace.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { Workspace, WorkspaceListResponse, WorkspaceSingleResponse } from \"@/types/workspace\";\n\nconst baseUrl = \"workspaces\";\n\n/**\n * getWorkspace\n *\n * Fetches a single workspace by name.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} name - Workspace name.\n * @returns {Promise<Workspace>} The fetched workspace.\n *\n * @throws {Error} If the request fails.\n */\nexport const getWorkspace = async (api: AxiosInstance, name: string): Promise<Workspace> => {\n  if (!name) throw new Error(\"Workspace name is required to fetch a workspace\");\n\n  try {\n    const response: AxiosResponse<WorkspaceSingleResponse> = await api.get(`${baseUrl}/${name}`);\n    return response.data.workspace;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workspace\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workspace\");\n  }\n};\n\n/**\n * listWorkspaces\n *\n * Fetches a list of workspaces with optional cursor-based pagination.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} [workspace] - Current workspace name. Sent as a query param via the legacy method, required by some API configurations.\n * @param {number} [pageSize] - Number of items per page.\n * @param {string} [pageToken] - Cursor token for the next page.\n * @returns {Promise<WorkspaceListResponse>} List of workspaces.\n *\n * @throws {Error} If the request fails.\n */\nexport const listWorkspaces = async (api: AxiosInstance, workspace?: string, pageSize?: number, pageToken?: string): Promise<WorkspaceListResponse> => {\n  const params: AnyRecord = {};\n\n  if (workspace) params.workspace = workspace;\n  if (pageSize) params.page_size = pageSize;\n  if (pageToken) params.page_token = pageToken;\n\n  try {\n    const response: AxiosResponse<WorkspaceListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workspaces\");\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workspaces\");\n  }\n};\n"],"mappings":";;AAKA,IAAM,UAAU;;;;;;;;;;;;AAahB,IAAa,eAAe,OAAO,KAAoB,SAAqC;CAC1F,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,iDAAiD;CAE5E,IAAI;EAEF,QAAO,MADwD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAA,CAC3E,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,gCAAgC;EAGnE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,gCAAgC;CAClD;AACF;;;;;;;;;;;;;;AAeA,IAAa,iBAAiB,OAAO,KAAoB,WAAoB,UAAmB,cAAuD;CACrJ,MAAM,SAAoB,CAAC;CAE3B,IAAI,WAAW,OAAO,YAAY;CAClC,IAAI,UAAU,OAAO,YAAY;CACjC,IAAI,WAAW,OAAO,aAAa;CAEnC,IAAI;EAEF,QAAO,MADsD,IAAI,IAAI,SAAS,EAAE,OAAO,CAAC,EAAA,CACxE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,iCAAiC;EAGpE,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,iCAAiC;CACnD;AACF"}
+{"version":3,"file":"workspace.js","names":[],"sources":["../../src/api/workspace.ts"],"sourcesContent":["import { isAxiosError, type AxiosInstance, type AxiosResponse } from \"axios\";\n\nimport type { AnyRecord } from \"@/types/anyRecord\";\nimport type { Workspace, WorkspaceListResponse, WorkspaceSingleResponse } from \"@/types/workspace\";\n\nconst baseUrl = \"workspaces\";\n\n/**\n * getWorkspace\n *\n * Fetches a single workspace by name.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} name - Workspace name.\n * @returns {Promise<Workspace>} The fetched workspace.\n *\n * @throws {Error} If the request fails.\n */\nexport const getWorkspace = async (api: AxiosInstance, name: string): Promise<Workspace> => {\n  if (!name) throw new Error(\"Workspace name is required to fetch a workspace\");\n\n  try {\n    const response: AxiosResponse<WorkspaceSingleResponse> = await api.get(`${baseUrl}/${name}`);\n    return response.data.workspace;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workspace\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workspace\", { cause: error });\n  }\n};\n\n/**\n * listWorkspaces\n *\n * Fetches a list of workspaces with optional cursor-based pagination.\n *\n * @param {AxiosInstance} api - Axios instance.\n * @param {string} [workspace] - Current workspace name. Sent as a query param via the legacy method, required by some API configurations.\n * @param {number} [pageSize] - Number of items per page.\n * @param {string} [pageToken] - Cursor token for the next page.\n * @returns {Promise<WorkspaceListResponse>} List of workspaces.\n *\n * @throws {Error} If the request fails.\n */\nexport const listWorkspaces = async (api: AxiosInstance, workspace?: string, pageSize?: number, pageToken?: string): Promise<WorkspaceListResponse> => {\n  const params: AnyRecord = {};\n\n  if (workspace) params.workspace = workspace;\n  if (pageSize) params.page_size = pageSize;\n  if (pageToken) params.page_token = pageToken;\n\n  try {\n    const response: AxiosResponse<WorkspaceListResponse> = await api.get(baseUrl, { params });\n    return response.data;\n  } catch (error: unknown) {\n    if (isAxiosError<AnyRecord>(error)) {\n      throw new Error(error.message || \"Error while fetching workspaces\", { cause: error });\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n\n    throw new Error(\"Error while fetching workspaces\", { cause: error });\n  }\n};\n"],"mappings":";;AAKA,IAAM,UAAU;;;;;;;;;;;;AAahB,IAAa,eAAe,OAAO,KAAoB,SAAqC;CAC1F,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,iDAAiD;CAE5E,IAAI;EAEF,QAAO,MADwD,IAAI,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAA,CAC3E,KAAK;CACvB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,kCAAkC,EAAE,OAAO,MAAM,CAAC;EAGrF,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,kCAAkC,EAAE,OAAO,MAAM,CAAC;CACpE;AACF;;;;;;;;;;;;;;AAeA,IAAa,iBAAiB,OAAO,KAAoB,WAAoB,UAAmB,cAAuD;CACrJ,MAAM,SAAoB,CAAC;CAE3B,IAAI,WAAW,OAAO,YAAY;CAClC,IAAI,UAAU,OAAO,YAAY;CACjC,IAAI,WAAW,OAAO,aAAa;CAEnC,IAAI;EAEF,QAAO,MADsD,IAAI,IAAI,SAAS,EAAE,OAAO,CAAC,EAAA,CACxE;CAClB,SAAS,OAAgB;EACvB,IAAI,aAAwB,KAAK,GAC/B,MAAM,IAAI,MAAM,MAAM,WAAW,mCAAmC,EAAE,OAAO,MAAM,CAAC;EAGtF,IAAI,iBAAiB,OACnB,MAAM;EAGR,MAAM,IAAI,MAAM,mCAAmC,EAAE,OAAO,MAAM,CAAC;CACrE;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everysk/apps-sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Shared runtime for Everysk client applications: EveryskApp, the contexts, entity slices, UI components and the MUI theme.",
   "keywords": [
     "everysk",
@@ -78,7 +78,7 @@
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "socket.io-client": "^4.8.3",
-    "vitest": "^4.1.8"
+    "vitest": "^5.0.1"
   },
   "peerDependenciesMeta": {
     "@testing-library/jest-dom": {
@@ -106,7 +106,7 @@
   "devDependencies": {
     "@emotion/react": "^11.14.0",
     "@emotion/styled": "^11.14.1",
-    "@eslint/js": "^9.39.4",
+    "@eslint/js": "^10.0.1",
     "@mui/material": "^9.0.1",
     "@mui/x-date-pickers": "^9.3.0",
     "@tanstack/react-query": "^5.101.0",
@@ -118,11 +118,11 @@
     "@types/react": "^19.2.16",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.2",
-    "@vitest/coverage-v8": "^4.1.8",
+    "@vitest/coverage-v8": "^5.0.1",
     "ag-grid-community": "^35.3.1",
     "ag-grid-enterprise": "^35.3.1",
     "axios": "^1.17.0",
-    "eslint": "^9.39.4",
+    "eslint": "^10.10.0",
     "eslint-plugin-react-hooks": "^7.1.1",
     "globals": "^17.6.0",
     "jsdom": "^29.1.1",
@@ -133,7 +133,7 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.1",
     "vite": "^8.0.16",
-    "vitest": "^4.1.8"
+    "vitest": "^5.0.1"
   },
   "publishConfig": {
     "access": "public"

package/src/api/datastore.ts

@@ -28,14 +28,14 @@ export const getDatastore = async (api: AxiosInstance, id: string, workspace: st
     return response.data.datastore;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error fetching datastore");
+      throw new Error(error.message || "Error fetching datastore", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error fetching datastore");
+    throw new Error("Error fetching datastore", { cause: error });
   }
 };
 
@@ -67,14 +67,14 @@ export const listDatastores = async (api: AxiosInstance, query: QueryObject): Pr
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error listing datastores");
+      throw new Error(error.message || "Error listing datastores", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error listing datastores");
+    throw new Error("Error listing datastores", { cause: error });
   }
 };
 
@@ -99,14 +99,14 @@ export const createDatastore = async (api: AxiosInstance, data: Partial<Datastor
     return response.data.datastore;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error creating datastore");
+      throw new Error(error.message || "Error creating datastore", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error creating datastore");
+    throw new Error("Error creating datastore", { cause: error });
   }
 };
 
@@ -132,14 +132,14 @@ export const updateDatastore = async (api: AxiosInstance, id: string, data: Part
     return response.data.datastore;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error updating datastore");
+      throw new Error(error.message || "Error updating datastore", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error updating datastore");
+    throw new Error("Error updating datastore", { cause: error });
   }
 };
 
@@ -163,13 +163,13 @@ export const deleteDatastore = async (api: AxiosInstance, id: string, workspace:
     return response.data.datastores;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error removing datastore");
+      throw new Error(error.message || "Error removing datastore", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error removing datastore");
+    throw new Error("Error removing datastore", { cause: error });
   }
 };

package/src/api/file.ts

@@ -26,14 +26,14 @@ export const getFile = async (api: AxiosInstance, id: string, workspace: string)
     return response.data.file;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-     throw new Error(error.message || "Error while fetching file");
+     throw new Error(error.message || "Error while fetching file", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while fetching file");
+    throw new Error("Error while fetching file", { cause: error });
   }
 };
 
@@ -67,13 +67,13 @@ export const listFiles = async (api: AxiosInstance, query: QueryObject): Promise
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while fetching files");
+      throw new Error(error.message || "Error while fetching files", { cause: error });
     } 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while fetching files");
+    throw new Error("Error while fetching files", { cause: error });
   }
 };
 
@@ -98,14 +98,14 @@ export const createFile = async (api: AxiosInstance, data: Partial<EveryskFile>)
     return response.data.file;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while creating file");
+      throw new Error(error.message || "Error while creating file", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while creating file");
+    throw new Error("Error while creating file", { cause: error });
   }
 };
 
@@ -131,14 +131,14 @@ export const updateFile = async (api: AxiosInstance, id: string, data: Partial<E
         return response.data.file;
     } catch (error: unknown) {
         if (isAxiosError<AnyRecord>(error)) {
-            throw new Error(error.message || "Error while updating file");
+            throw new Error(error.message || "Error while updating file", { cause: error });
         }
 
         if (error instanceof Error) {
             throw error;
         }
 
-        throw new Error("Error while updating file");
+        throw new Error("Error while updating file", { cause: error });
     }
 };
 
@@ -162,13 +162,13 @@ export const deleteFile = async (api: AxiosInstance, id: string, workspace: stri
     return response.data.files;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while deleting file");
+      throw new Error(error.message || "Error while deleting file", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while deleting file");
+    throw new Error("Error while deleting file", { cause: error });
   }
 };

package/src/api/portfolio.ts

@@ -31,14 +31,14 @@ export const getPortfolio = async (api: AxiosInstance, id: string, workspace: st
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-     throw new Error(error.message || "Error while fetching portfolio");
+     throw new Error(error.message || "Error while fetching portfolio", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while fetching portfolio");
+    throw new Error("Error while fetching portfolio", { cause: error });
   }
 };
 
@@ -71,14 +71,14 @@ export const listPortfolios = async (api: AxiosInstance, query: QueryObject): Pr
       return response.data;
     } catch (error: unknown) {
       if (isAxiosError<AnyRecord>(error)) {
-        throw new Error(error.message || "Error while fetching portfolios");
+        throw new Error(error.message || "Error while fetching portfolios", { cause: error });
       }
 
       if (error instanceof Error) {
         throw error;
       }
 
-      throw new Error("Error while fetching portfolios");
+      throw new Error("Error while fetching portfolios", { cause: error });
     }
 }
 
@@ -106,14 +106,14 @@ export const createPortfolio = async (api: AxiosInstance, data: Partial<Portfoli
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while creating portfolio");
+      throw new Error(error.message || "Error while creating portfolio", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while creating portfolio");
+    throw new Error("Error while creating portfolio", { cause: error });
   }
 }
 
@@ -142,14 +142,14 @@ export const updatePortfolio = async (api: AxiosInstance, id: string, data: Part
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while updating portfolio");
+      throw new Error(error.message || "Error while updating portfolio", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while updating portfolio");
+    throw new Error("Error while updating portfolio", { cause: error });
   }
 }
 
@@ -178,13 +178,13 @@ export const deletePortfolio = async (api: AxiosInstance, id: string, workspace:
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while deleting portfolio");
+      throw new Error(error.message || "Error while deleting portfolio", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while deleting portfolio");
+    throw new Error("Error while deleting portfolio", { cause: error });
   }
 }

package/src/api/profile.ts

@@ -68,13 +68,13 @@ export const getProfile = async (api: AxiosInstance, fallback?: Profile): Promis
         return response.data.profile;
     } catch (error: unknown) {
         if (isAxiosError<AnyRecord>(error)) {
-            throw new Error(error.message || "Error while fetching profile");
+            throw new Error(error.message || "Error while fetching profile", { cause: error });
         }
 
         if (error instanceof Error) {
             throw error;
         }
 
-        throw new Error("Error while fetching profile");
+        throw new Error("Error while fetching profile", { cause: error });
     }
 };

package/src/api/websocketsConfig.ts

@@ -20,13 +20,13 @@ export const getWebsocketsConfig = async (api: AxiosInstance): Promise<Websocket
         return response.data;
     } catch (error: unknown) {
         if (isAxiosError<AnyRecord>(error)) {
-            throw new Error(error.message || "Error fetching websockets config");
+            throw new Error(error.message || "Error fetching websockets config", { cause: error });
         }
 
         if (error instanceof Error) {
             throw error;
         }
 
-        throw new Error("Error fetching websockets config");
+        throw new Error("Error fetching websockets config", { cause: error });
     }
 };

package/src/api/workflow.ts

@@ -38,14 +38,14 @@ export const runWorkflow = async (api: AxiosInstance, id: string, workspace: str
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "");
+      throw new Error(error.message || "", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while running workflow");
+    throw new Error("Error while running workflow", { cause: error });
   }
 };
 
@@ -239,13 +239,13 @@ export const getWorkflow = async (api: AxiosInstance, id: string, workspace: str
     return response.data.workflow;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while fetching workflow");
+      throw new Error(error.message || "Error while fetching workflow", { cause: error });
     } 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while fetching workflow");
+    throw new Error("Error while fetching workflow", { cause: error });
   }
 };
 
@@ -271,14 +271,14 @@ export const listWorkflows = async (api: AxiosInstance, workspace?: string, page
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error listing workflows");
+      throw new Error(error.message || "Error listing workflows", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error listing workflows");
+    throw new Error("Error listing workflows", { cause: error });
   }
 };
 
@@ -304,14 +304,14 @@ export const getWorkflowExecution = async (api: AxiosInstance, workflowId: strin
     return response.data.workflow_execution;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error fetching workflow execution");
+      throw new Error(error.message || "Error fetching workflow execution", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error fetching workflow execution");
+    throw new Error("Error fetching workflow execution", { cause: error });
   }
 };
 
@@ -342,14 +342,14 @@ export const listWorkflowExecutions = async (api: AxiosInstance, workflowId: str
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error listing workflow executions");
+      throw new Error(error.message || "Error listing workflow executions", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error listing workflow executions");
+    throw new Error("Error listing workflow executions", { cause: error });
   }
 };
 
@@ -375,14 +375,14 @@ export const getWorkerExecution = async (api: AxiosInstance, workflowId: string,
     return response.data.worker_execution;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error fetching worker execution");
+      throw new Error(error.message || "Error fetching worker execution", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error fetching worker execution");
+    throw new Error("Error fetching worker execution", { cause: error });
   }
 }
 
@@ -415,13 +415,13 @@ export const listWorkerExecutions = async (api: AxiosInstance, workflowId: strin
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error listing worker executions");
+      throw new Error(error.message || "Error listing worker executions", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error listing worker executions");
+    throw new Error("Error listing worker executions", { cause: error });
   }
 };

package/src/api/workspace.ts

@@ -24,14 +24,14 @@ export const getWorkspace = async (api: AxiosInstance, name: string): Promise<Wo
     return response.data.workspace;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while fetching workspace");
+      throw new Error(error.message || "Error while fetching workspace", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while fetching workspace");
+    throw new Error("Error while fetching workspace", { cause: error });
   }
 };
 
@@ -60,13 +60,13 @@ export const listWorkspaces = async (api: AxiosInstance, workspace?: string, pag
     return response.data;
   } catch (error: unknown) {
     if (isAxiosError<AnyRecord>(error)) {
-      throw new Error(error.message || "Error while fetching workspaces");
+      throw new Error(error.message || "Error while fetching workspaces", { cause: error });
     }
 
     if (error instanceof Error) {
       throw error;
     }
 
-    throw new Error("Error while fetching workspaces");
+    throw new Error("Error while fetching workspaces", { cause: error });
   }
 };