@superblocksteam/sdk 2.0.102 → 2.0.103-next.0

package/dist/client.js

@@ -1,11 +1,11 @@
 import * as fs from "node:fs";
 import path from "node:path";
-import { Bucketeer, FileDescriptor } from "@superblocksteam/bucketeer-sdk";
-import { CommitType, ExportViewMode, } from "@superblocksteam/shared";
-import { COMPONENT_EVENT_HEADER, ComponentEvent, ForbiddenError, getBucketeerUrlFromSuperblocksUrl, getContentType, NotFoundError, BadRequestError, unreachable, getSuperblocksDevEnvironmentConfigJson, } from "@superblocksteam/util";
 import axios, { AxiosError } from "axios";
 import FormData from "form-data";
 import { isEqual, isEmpty } from "lodash-es";
+import { Bucketeer, FileDescriptor } from "@superblocksteam/bucketeer-sdk";
+import { CommitType, ExportViewMode, } from "@superblocksteam/shared";
+import { COMPONENT_EVENT_HEADER, ComponentEvent, ForbiddenError, getBucketeerUrlFromSuperblocksUrl, getContentType, NotFoundError, BadRequestError, unreachable, getSuperblocksDevEnvironmentConfigJson, } from "@superblocksteam/util";
 import { doUploadLocalDirectory } from "./dbfs/local.js";
 import { BranchNotCheckedOutError, CommitAlreadyExistsError, ValidateGitSetupError, } from "./errors.js";
 import { signingEnabled } from "./flag.js";
@@ -14,6 +14,7 @@ import { AgentType } from "./types/index.js";
 import { getAgentUrl } from "./utils.js";
 import { DEFAULT_BRANCH, findGitRepositoryRoot, getCurrentGitBranchIfGit, } from "./version-control.mjs";
 const BASE_BUCKETEER_URL = "api";
+const BASE_SERVER_API_URL_V1 = "api/v1";
 const BASE_SERVER_PUBLIC_API_URL_V1 = "api/v1/public";
 const BASE_SERVER_PUBLIC_API_URL_v2 = "api/v2/public";
 const BASE_SERVER_API_URL_V2 = "api/v2";
@@ -621,6 +622,49 @@ export async function fetchOrganizationSummary(cliVersion, token, superblocksBas
         throw new Error(`Could not fetch organization summary: ${message}`);
     }
 }
+export async function createApplication({ cliVersion, token, superblocksBaseUrl, name, organizationId, codeMode = true, templateName, folderId, }) {
+    const body = {
+        name,
+        organizationId,
+    };
+    if (codeMode) {
+        body.createUsingReact = true;
+        if (templateName) {
+            body.templateName = templateName;
+        }
+    }
+    if (folderId) {
+        body.folderId = folderId;
+    }
+    try {
+        const config = {
+            method: "post",
+            url: new URL(`${BASE_SERVER_API_URL_V2}/applications/`, superblocksBaseUrl).toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                "Content-Type": "application/json",
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+            data: body,
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not create application: ${message}`);
+    }
+}
 const createSocketConnectionIfNeeded = async (cliVersion, token, superblocksBaseUrl) => {
     const userMe = await fetchCurrentUser(cliVersion, token, superblocksBaseUrl);
     const organization = userMe.organizations[0];
@@ -913,9 +957,9 @@ export async function fetchApiCommits({ cliVersion, applicationId, branch, commi
     }
     catch (e) {
         if (axios.isAxiosError(e) && e.response?.status === 404) {
-            throw new NotFoundError(`Application ${applicationId} was not found`);
+            throw new NotFoundError(`API ${applicationId} was not found`);
         }
-        throw new Error("Could not fetch application");
+        throw new Error("Could not fetch API commits");
     }
 }
 export async function deployApplication(cliVersion, applicationId, token, superblocksBaseUrl, commitId) {
@@ -983,6 +1027,719 @@ export async function uploadApplication({ files, scopedJwt, url, cliVersion, app
     });
     await bucketeer.uploadApplication(fds);
 }
+export async function fetchRbacAssignments({ cliVersion, token, superblocksBaseUrl, resourceType, resourceId, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V2}/rbac/assignments`, superblocksBaseUrl);
+        url.searchParams.set("resourceType", resourceType);
+        url.searchParams.set("resourceId", resourceId);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch RBAC assignments: ${message}`);
+    }
+}
+export async function createRbacAssignments({ cliVersion, token, superblocksBaseUrl, payload, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V2}/rbac/assignments`, superblocksBaseUrl);
+        const config = {
+            method: "post",
+            url: url.toString(),
+            data: payload,
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not create RBAC assignments: ${message}`);
+    }
+}
+export async function updateRbacAssignment({ cliVersion, token, superblocksBaseUrl, assignmentRecordId, payload, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V2}/rbac/assignments/${assignmentRecordId}`, superblocksBaseUrl);
+        const config = {
+            method: "put",
+            url: url.toString(),
+            data: payload,
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not update RBAC assignment: ${message}`);
+    }
+}
+export async function deleteRbacAssignment({ cliVersion, token, superblocksBaseUrl, assignmentRecordId, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V2}/rbac/assignments/${assignmentRecordId}`, superblocksBaseUrl);
+        const config = {
+            method: "delete",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not delete RBAC assignment: ${message}`);
+    }
+}
+export async function fetchAuditLogs({ cliVersion, token, superblocksBaseUrl, filters, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V2}/audit`, superblocksBaseUrl);
+        url.searchParams.set("startTime", filters.startTime);
+        url.searchParams.set("endTime", filters.endTime);
+        if (filters.entityType !== undefined) {
+            url.searchParams.set("entity_type", String(filters.entityType));
+        }
+        if (filters.auditEntityId !== undefined) {
+            url.searchParams.set("audit_entity_id", filters.auditEntityId);
+        }
+        if (filters.auditEntityType !== undefined) {
+            url.searchParams.set("audit_entity_type", String(filters.auditEntityType));
+        }
+        if (filters.status !== undefined) {
+            url.searchParams.set("status", filters.status);
+        }
+        if (filters.deployed !== undefined) {
+            url.searchParams.set("deployed", String(filters.deployed));
+        }
+        if (filters.triggeredBy?.length) {
+            for (const src of filters.triggeredBy) {
+                url.searchParams.append("triggered_by", src);
+            }
+        }
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch audit logs: ${message}`);
+    }
+}
+export async function fetchAuditEvents({ cliVersion, token, superblocksBaseUrl, filters, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V2}/audit/events`, superblocksBaseUrl);
+        url.searchParams.set("time_start", filters.timeStart);
+        url.searchParams.set("time_end", filters.timeEnd);
+        if (filters.classUid !== undefined) {
+            url.searchParams.set("class_uid", String(filters.classUid));
+        }
+        if (filters.status !== undefined) {
+            url.searchParams.set("status", String(filters.status));
+        }
+        if (filters.severity !== undefined) {
+            url.searchParams.set("severity", String(filters.severity));
+        }
+        if (filters.actor !== undefined) {
+            url.searchParams.set("actor", filters.actor);
+        }
+        if (filters.resourceType !== undefined) {
+            url.searchParams.set("resource_type", filters.resourceType);
+        }
+        if (filters.resourceId !== undefined) {
+            url.searchParams.set("resource_id", filters.resourceId);
+        }
+        if (filters.search !== undefined) {
+            url.searchParams.set("search", filters.search);
+        }
+        if (filters.cursor !== undefined) {
+            url.searchParams.set("cursor", filters.cursor);
+        }
+        if (filters.limit !== undefined) {
+            url.searchParams.set("limit", String(filters.limit));
+        }
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        const responseData = response.data;
+        if (responseData &&
+            typeof responseData === "object" &&
+            "data" in responseData &&
+            responseData.data !== undefined) {
+            return responseData.data;
+        }
+        return responseData;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch audit events: ${message}`);
+    }
+}
+export async function fetchIntegrations({ cliVersion, token, superblocksBaseUrl, filters, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/integrations`, superblocksBaseUrl);
+        if (filters?.kind) {
+            for (const k of filters.kind) {
+                url.searchParams.append("kind", k);
+            }
+        }
+        if (filters?.slug) {
+            for (const s of filters.slug) {
+                url.searchParams.append("slug", s);
+            }
+        }
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch integrations: ${message}`);
+    }
+}
+export async function fetchIntegrationById({ cliVersion, token, superblocksBaseUrl, integrationId, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/integrations/${integrationId}`, superblocksBaseUrl);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch integration: ${message}`);
+    }
+}
+export async function createIntegration({ cliVersion, token, superblocksBaseUrl, payload, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/integrations`, superblocksBaseUrl);
+        const config = {
+            method: "post",
+            url: url.toString(),
+            data: payload,
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not create integration: ${message}`);
+    }
+}
+export async function updateIntegration({ cliVersion, token, superblocksBaseUrl, integrationId, payload, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/integrations/${integrationId}`, superblocksBaseUrl);
+        const config = {
+            method: "put",
+            url: url.toString(),
+            data: payload,
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not update integration: ${message}`);
+    }
+}
+export async function deleteIntegration({ cliVersion, token, superblocksBaseUrl, integrationId, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/integrations/${integrationId}`, superblocksBaseUrl);
+        const config = {
+            method: "delete",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not delete integration: ${message}`);
+    }
+}
+export async function fetchFolders({ cliVersion, token, superblocksBaseUrl, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/folders`, superblocksBaseUrl);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch folders: ${message}`);
+    }
+}
+export async function createFolder({ cliVersion, token, superblocksBaseUrl, payload, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/folders`, superblocksBaseUrl);
+        const config = {
+            method: "post",
+            url: url.toString(),
+            data: { folder: payload },
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not create folder: ${message}`);
+    }
+}
+export async function updateFolder({ cliVersion, token, superblocksBaseUrl, folderId, payload, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/folders/${folderId}`, superblocksBaseUrl);
+        const config = {
+            method: "put",
+            url: url.toString(),
+            data: { folder: payload },
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not update folder: ${message}`);
+    }
+}
+export async function deleteFolder({ cliVersion, token, superblocksBaseUrl, folderId, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/folders/${folderId}`, superblocksBaseUrl);
+        const config = {
+            method: "delete",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not delete folder: ${message}`);
+    }
+}
+export async function fetchBillingUsageDaily({ cliVersion, token, superblocksBaseUrl, startDate, endDate, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/billing/usage-daily`, superblocksBaseUrl);
+        url.searchParams.set("start", startDate);
+        url.searchParams.set("end", endDate);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data.dailyUsage;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch billing daily usage: ${message}`);
+    }
+}
+export async function fetchBillingUsageRecords({ cliVersion, token, superblocksBaseUrl, startDate, endDate, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/billing/usage-records`, superblocksBaseUrl);
+        url.searchParams.set("start", startDate);
+        url.searchParams.set("end", endDate);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data.rows;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch billing usage records: ${message}`);
+    }
+}
+export async function fetchBillingPlanSummary({ cliVersion, token, superblocksBaseUrl, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/billing/plan-summary`, superblocksBaseUrl);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch billing plan summary: ${message}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Knowledge (Facts)
+// ---------------------------------------------------------------------------
+export async function fetchFacts({ cliVersion, token, superblocksBaseUrl, query, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/facts`, superblocksBaseUrl);
+        if (query?.entityScope)
+            url.searchParams.set("entityScope", query.entityScope);
+        if (query?.entityId)
+            url.searchParams.set("entityId", query.entityId);
+        if (query?.accessType)
+            url.searchParams.set("accessType", query.accessType);
+        if (query?.isEnabled !== undefined)
+            url.searchParams.set("isEnabled", String(query.isEnabled));
+        if (query?.search)
+            url.searchParams.set("search", query.search);
+        if (query?.limit !== undefined)
+            url.searchParams.set("limit", String(query.limit));
+        if (query?.offset !== undefined)
+            url.searchParams.set("offset", String(query.offset));
+        if (query?.sortBy)
+            url.searchParams.set("sortBy", query.sortBy);
+        if (query?.sortOrder)
+            url.searchParams.set("sortOrder", query.sortOrder);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data.facts;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch knowledge entries: ${message}`);
+    }
+}
+export async function fetchFact({ cliVersion, token, superblocksBaseUrl, factId, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V1}/facts/${encodeURIComponent(factId)}`, superblocksBaseUrl);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch knowledge entry: ${message}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Audit entities
+// ---------------------------------------------------------------------------
+export async function fetchAuditEntities({ cliVersion, token, superblocksBaseUrl, }) {
+    try {
+        const url = new URL(`${BASE_SERVER_API_URL_V2}/audit/entities`, superblocksBaseUrl);
+        const config = {
+            method: "get",
+            url: url.toString(),
+            headers: {
+                Authorization: "Bearer " + token,
+                [CLI_VERSION_HEADER]: cliVersion,
+            },
+        };
+        const response = await axios(config);
+        return response.data.data;
+    }
+    catch (e) {
+        let message;
+        if (e instanceof AxiosError) {
+            message =
+                e.response?.data?.responseMeta?.message ??
+                    JSON.stringify(e.response?.data) ??
+                    e.response?.statusText ??
+                    e?.message;
+        }
+        else {
+            message = `${e?.message ? e?.message : e}`;
+        }
+        throw new Error(`Could not fetch audit entities: ${message}`);
+    }
+}
 function filesToFileDescriptors(files, appRoot) {
     const fds = files.map((file) => {
         const relativePath = appRoot ? path.relative(appRoot, file) : undefined;