@superblocksteam/sdk 2.0.102 → 2.0.103

package/src/sdk.ts

@@ -1,9 +1,29 @@
 import {
   CommitType,
   ExportViewMode,
+  type AssignmentDto,
+  type OCSFAuditEvent,
+  type AuditLogDto,
+  type AuditLogEntity,
+  type FactDto,
+  type FactListQuery,
   type GetPublicOrganizationSummaryResponseBody,
+  type IHomepageApplicationV2Dto,
 } from "@superblocksteam/shared";
+import type {
+  ComponentEvent,
+  LocalGitRepoState,
+  SuperblocksResourceType,
+} from "@superblocksteam/util";
+
 import {
+  createFolder,
+  createIntegration,
+  createRbacAssignments,
+  createApplication,
+  deleteFolder,
+  deleteIntegration,
+  deleteRbacAssignment,
   fetchApi,
   fetchApiCommits,
   fetchApis,
@@ -12,8 +32,20 @@ import {
   fetchApplicationCommits,
   fetchApplications,
   fetchApplicationWithComponents,
+  fetchAuditEntities,
+  fetchAuditEvents,
+  fetchAuditLogs,
+  fetchBillingPlanSummary,
+  fetchBillingUsageDaily,
+  fetchBillingUsageRecords,
   fetchCurrentUser,
+  fetchFact,
+  fetchFacts,
+  fetchFolders,
+  fetchIntegrationById,
+  fetchIntegrations,
   fetchOrganizationSummary,
+  fetchRbacAssignments,
   getApplicationGitConfig,
   getGitFreshToken,
   sync,
@@ -22,10 +54,32 @@ import {
   pushApplicationCodeMode,
   registerComponents,
   uploadComponents,
+  updateFolder,
+  updateIntegration,
+  updateRbacAssignment,
   validateGitSetup,
   deployApplication,
   deployApi,
 } from "./client.js";
+import type {
+  ApplicationGitConfig,
+  CreateApplicationResult,
+  CreateRbacAssignmentsRequest,
+  DailyUsageRow,
+  FolderMutationPayload,
+  FolderSummary,
+  GitFreshToken,
+  IntegrationDetail,
+  IntegrationMutationPayload,
+  IntegrationSummary,
+  PlanSummary,
+  PushApiWithCommitConfig,
+  PushMultiPageApplicationWithCommitConfig,
+  SyncRequest,
+  SyncResponse,
+  UpdateRbacAssignmentRequest,
+  UsageRecordRow,
+} from "./client.js";
 import {
   downloadApplicationDirectory,
   downloadDirectoryByHash,
@@ -37,20 +91,7 @@ import {
 } from "./dbfs/client.js";
 import { hashLocalDirectory } from "./dbfs/local.js";
 import { FeatureFlags } from "./flag.js";
-import type {
-  ApplicationGitConfig,
-  GitFreshToken,
-  SyncRequest,
-  SyncResponse,
-  PushApiWithCommitConfig,
-  PushMultiPageApplicationWithCommitConfig,
-} from "./client.js";
 import type { UserMeDto } from "./types/index.js";
-import type {
-  ComponentEvent,
-  LocalGitRepoState,
-  SuperblocksResourceType,
-} from "@superblocksteam/util";
 
 // Exporting here instead of index.ts because only sdk.ts is exposed outside in package.json
 export * from "./errors.js";
@@ -220,7 +261,9 @@ export class SuperblocksSdk {
     });
   }
 
-  async fetchApplications(headers?: Record<string, string>) {
+  async fetchApplications(
+    headers?: Record<string, string>,
+  ): Promise<IHomepageApplicationV2Dto[]> {
     return fetchApplications(
       this.cliVersion,
       this.token,
@@ -229,6 +272,214 @@ export class SuperblocksSdk {
     );
   }
 
+  async fetchRbacAssignments(
+    resourceType: string,
+    resourceId: string,
+  ): Promise<AssignmentDto[]> {
+    return fetchRbacAssignments({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      resourceType,
+      resourceId,
+    });
+  }
+
+  async createRbacAssignments(
+    payload: CreateRbacAssignmentsRequest,
+  ): Promise<AssignmentDto[]> {
+    return createRbacAssignments({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      payload,
+    });
+  }
+
+  async updateRbacAssignment(
+    assignmentRecordId: string,
+    payload: UpdateRbacAssignmentRequest,
+  ): Promise<AssignmentDto> {
+    return updateRbacAssignment({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      assignmentRecordId,
+      payload,
+    });
+  }
+
+  async deleteRbacAssignment(
+    assignmentRecordId: string,
+  ): Promise<AssignmentDto> {
+    return deleteRbacAssignment({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      assignmentRecordId,
+    });
+  }
+
+  async fetchAuditLogs(filters: {
+    startTime: string;
+    endTime: string;
+    entityType?: number;
+    auditEntityId?: string;
+    auditEntityType?: number;
+    status?: string;
+    deployed?: boolean;
+    triggeredBy?: string[];
+  }): Promise<AuditLogDto[]> {
+    return fetchAuditLogs({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      filters,
+    });
+  }
+
+  async fetchAuditEvents(filters: {
+    timeStart: string;
+    timeEnd: string;
+    classUid?: number;
+    status?: number;
+    severity?: number;
+    actor?: string;
+    resourceType?: string;
+    resourceId?: string;
+    search?: string;
+    cursor?: string;
+    limit?: number;
+  }): Promise<{ events: OCSFAuditEvent[]; next_cursor: string | null }> {
+    return fetchAuditEvents({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      filters,
+    });
+  }
+
+  async fetchAuditEntities(): Promise<AuditLogEntity[]> {
+    return fetchAuditEntities({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+    });
+  }
+
+  async fetchFacts(query?: FactListQuery): Promise<FactDto[]> {
+    return fetchFacts({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      query,
+    });
+  }
+
+  async fetchFact(factId: string): Promise<FactDto> {
+    return fetchFact({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      factId,
+    });
+  }
+
+  async fetchIntegrations(filters?: {
+    kind?: string[];
+    slug?: string[];
+  }): Promise<IntegrationSummary[]> {
+    return fetchIntegrations({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      filters,
+    });
+  }
+
+  async fetchIntegrationById(
+    integrationId: string,
+  ): Promise<IntegrationDetail> {
+    return fetchIntegrationById({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      integrationId,
+    });
+  }
+
+  async createIntegration(
+    payload: IntegrationMutationPayload,
+  ): Promise<IntegrationDetail> {
+    return createIntegration({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      payload,
+    });
+  }
+
+  async updateIntegration(
+    integrationId: string,
+    payload: IntegrationMutationPayload,
+  ): Promise<IntegrationDetail> {
+    return updateIntegration({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      integrationId,
+      payload,
+    });
+  }
+
+  async deleteIntegration(integrationId: string): Promise<IntegrationDetail> {
+    return deleteIntegration({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      integrationId,
+    });
+  }
+
+  async fetchFolders(): Promise<FolderSummary[]> {
+    return fetchFolders({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+    });
+  }
+
+  async createFolder(payload: FolderMutationPayload): Promise<FolderSummary> {
+    return createFolder({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      payload,
+    });
+  }
+
+  async updateFolder(
+    folderId: string,
+    payload: FolderMutationPayload,
+  ): Promise<FolderSummary> {
+    return updateFolder({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      folderId,
+      payload,
+    });
+  }
+
+  async deleteFolder(folderId: string): Promise<FolderSummary> {
+    return deleteFolder({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      folderId,
+    });
+  }
+
   async fetchApi({
     apiId,
     branch,
@@ -502,6 +753,31 @@ export class SuperblocksSdk {
     return await hashLocalDirectory(localDirectoryPath);
   }
 
+  async createApplication({
+    name,
+    organizationId,
+    codeMode,
+    templateName,
+    folderId,
+  }: {
+    name: string;
+    organizationId: string;
+    codeMode?: boolean;
+    templateName?: string;
+    folderId?: string;
+  }): Promise<CreateApplicationResult> {
+    return createApplication({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      name,
+      organizationId,
+      codeMode,
+      templateName,
+      folderId,
+    });
+  }
+
   async deployApplication(applicationId: string, commitId?: string) {
     return deployApplication(
       this.cliVersion,
@@ -522,6 +798,40 @@ export class SuperblocksSdk {
     );
   }
 
+  async fetchBillingUsageDaily(
+    startDate: string,
+    endDate: string,
+  ): Promise<DailyUsageRow[]> {
+    return fetchBillingUsageDaily({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      startDate,
+      endDate,
+    });
+  }
+
+  async fetchBillingUsageRecords(
+    startDate: string,
+    endDate: string,
+  ): Promise<UsageRecordRow[]> {
+    return fetchBillingUsageRecords({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+      startDate,
+      endDate,
+    });
+  }
+
+  async fetchBillingPlanSummary(): Promise<PlanSummary> {
+    return fetchBillingPlanSummary({
+      cliVersion: this.cliVersion,
+      token: this.token,
+      superblocksBaseUrl: this.superblocksBaseUrl,
+    });
+  }
+
   async sync({
     applicationId,
     payload,

package/src/socket/handlers.ts

@@ -1,5 +1,3 @@
-import { signResource, verifyResources } from "./signing.js";
-import type { AppToSign, AppToVerify, MethodHandlers } from "../types/index.js";
 import type {
   ApiToSign,
   ApiToVerify,
@@ -9,6 +7,9 @@ import type {
 } from "@superblocksteam/shared";
 import type { Signature } from "@superblocksteam/util";
 
+import type { AppToSign, AppToVerify, MethodHandlers } from "../types/index.js";
+import { signResource, verifyResources } from "./signing.js";
+
 // This file contains the definition of the protocol used for communication between the SB server and clients
 
 export type ResponseMeta = {

package/src/socket/index.ts

@@ -3,15 +3,16 @@ import {
   createISocketClient,
   ISocketWithClientAuth,
 } from "@superblocksteam/shared";
-import { getTracer } from "../telemetry/index.js";
-import { createRequestHandlers } from "./handlers.js";
-import type { ISocketClient } from "../types/index.js";
 import type {
   ClientMethods,
   RequestContextBase,
   ServerMethods,
 } from "@superblocksteam/shared";
 
+import { getTracer } from "../telemetry/index.js";
+import type { ISocketClient } from "../types/index.js";
+import { createRequestHandlers } from "./handlers.js";
+
 export type StdISocketRPCClient = ISocketClient<ServerMethods>;
 
 export async function connectToISocketRPCServer({

package/src/socket/signing.ts

@@ -1,12 +1,14 @@
 import axios from "axios";
-import { getSanitizedApi } from "../utils.js";
+import type { AxiosRequestConfig, Method } from "axios";
+
+import type { Signature } from "@superblocksteam/util";
+
 import type {
   ApiResource,
   GenericResource,
   SignatureResponse,
 } from "../types/index.js";
-import type { Signature } from "@superblocksteam/util";
-import type { AxiosRequestConfig, Method } from "axios";
+import { getSanitizedApi } from "../utils.js";
 
 export async function signResource({
   token,

package/src/telemetry/index.ts

@@ -1,8 +1,11 @@
 import os from "node:os";
+
 import { trace, type Tracer } from "@opentelemetry/api";
 import { logs, type Logger } from "@opentelemetry/api-logs";
 import { ExpressInstrumentation } from "@opentelemetry/instrumentation-express";
 import { HttpInstrumentation } from "@opentelemetry/instrumentation-http";
+import type ddTraceDefault from "dd-trace";
+
 import {
   DeploymentTypeEnum,
   OBS_TAG_APPLICATION_ID,
@@ -18,7 +21,9 @@ import {
   resetTelemetry,
   getDefaultPolicy,
 } from "@superblocksteam/telemetry";
+
 import packageJson from "../../package.json" with { type: "json" };
+import type { ApplicationConfigWithTokenConfigAndUserInfo } from "../types/index.js";
 import {
   ATTR_SUPERBLOCKS_BASE_URL,
   ATTR_SUPERBLOCKS_CLI_TOKEN,
@@ -30,8 +35,6 @@ import {
 import { applyLocalObsEnvVars, isLocalObsEnabled } from "./local-obs.js";
 import { getLogger as getStandardLogger } from "./logging.js";
 import { getConfiguration, SERVICE_NAME } from "./util.js";
-import type { ApplicationConfigWithTokenConfigAndUserInfo } from "../types/index.js";
-import type ddTraceDefault from "dd-trace";
 
 // Apply local observability env vars early, before dd-trace auto-init
 applyLocalObsEnvVars();

package/src/telemetry/logging.ts

@@ -1,10 +1,11 @@
 import { SeverityNumber } from "@opentelemetry/api-logs";
-import { createLogger, format, transports } from "winston";
-import { safeStringify } from "./safe-stringify.js";
-import { getLogger as getTracedLogger } from "./index.js";
 import type { AnyValueMap } from "@opentelemetry/api-logs";
+import { createLogger, format, transports } from "winston";
 import type winston from "winston";
 
+import { getLogger as getTracedLogger } from "./index.js";
+import { safeStringify } from "./safe-stringify.js";
+
 const activeTransports: winston.transport[] = [];
 
 if (process.env.SUPERBLOCKS_IS_CSB === "true") {

package/src/types/common.ts

@@ -1,6 +1,7 @@
-import type { FeatureFlags } from "../flag.js";
 import type { Api } from "@superblocksteam/util";
 
+import type { FeatureFlags } from "../flag.js";
+
 export interface UserMeDto {
   user: User;
   organizations: Organization[];

package/src/utils.ts

@@ -1,12 +1,14 @@
 import axios from "axios";
+import type { AxiosRequestConfig } from "axios";
+
+import type { Api } from "@superblocksteam/util";
+
 import {
   AgentStatus,
   OpenAiPluginId,
   transcribeAudioToTextTranslateToEnglishTruthyValues,
 } from "./types/index.js";
 import type { Agent, AgentType } from "./types/index.js";
-import type { Api } from "@superblocksteam/util";
-import type { AxiosRequestConfig } from "axios";
 
 export async function getAgentUrl(
   agents: Agent[],

package/src/version-control.mts

@@ -1,6 +1,16 @@
 import * as https from "https";
 import path from "node:path";
 import { dirname } from "path";
+
+import { bold } from "colorette";
+import fs from "fs-extra";
+import { isEmpty, isArray, isObject, get } from "lodash-es";
+import * as semver from "semver";
+import { simpleGit } from "simple-git";
+import type { SimpleGit, StatusResult } from "simple-git";
+import slugify from "slugify";
+import { parse, stringify as ymlstringify } from "yaml";
+
 import { DEFAULT_BRANCH, ExportViewMode } from "@superblocksteam/shared";
 import {
   RESOURCE_CONFIG_PATH,
@@ -13,23 +23,6 @@ import {
   writeApiFiles,
   DEFAULT_LINES_FOR_LARGE_STEPS,
 } from "@superblocksteam/util";
-import { bold } from "colorette";
-import fs from "fs-extra";
-import { isEmpty, isArray, isObject, get } from "lodash-es";
-import * as semver from "semver";
-import { simpleGit } from "simple-git";
-import slugify from "slugify";
-import { parse, stringify as ymlstringify } from "yaml";
-import { getLogger } from "./telemetry/logging.js";
-import type {
-  ApplicationWrapper,
-  MultiPageApplicationWrapper,
-  MultiPageApplicationWrapperWithComponents,
-  CodeModeApplicationWrapper,
-} from "./client.js";
-import type { FeatureFlags } from "./flag.js";
-import type { SuperblocksSdk } from "./sdk.js";
-import type { ApiWithPb, Page } from "./types/index.js";
 import type {
   LocalGitRepoState,
   SuperblocksBackendConfig,
@@ -44,7 +37,17 @@ import type {
   ApiWrapper,
   AdditionalStepFiles,
 } from "@superblocksteam/util";
-import type { SimpleGit, StatusResult } from "simple-git";
+
+import type {
+  ApplicationWrapper,
+  MultiPageApplicationWrapper,
+  MultiPageApplicationWrapperWithComponents,
+  CodeModeApplicationWrapper,
+} from "./client.js";
+import type { FeatureFlags } from "./flag.js";
+import type { SuperblocksSdk } from "./sdk.js";
+import { getLogger } from "./telemetry/logging.js";
+import type { ApiWithPb, Page } from "./types/index.js";
 
 export { DEFAULT_BRANCH };
 

package/src/vite-plugin-generate-api-build-manifest.mts

@@ -1,19 +1,22 @@
 import path from "node:path";
+
+import { yellow, red } from "colorette";
+import fg from "fast-glob";
+import fs from "fs-extra";
+import { createLogger } from "vite";
+import type { Plugin } from "vite";
+import yaml from "yaml";
+
+import type { DeleteMeLibraryApi } from "@superblocksteam/library-shared/types";
 import { isSdkApiTemplate } from "@superblocksteam/shared";
 import { resolveLanguageSpecificStepContentFromBlocks } from "@superblocksteam/util";
 import {
   getPageName,
   getScopeIdFromName,
 } from "@superblocksteam/vite-plugin-file-sync";
-import { yellow, red } from "colorette";
-import fg from "fast-glob";
-import fs from "fs-extra";
-import { createLogger } from "vite";
-import yaml from "yaml";
+
 import { collectSdkApisFromRegistry } from "./collect-sdk-apis.mjs";
 import { getLogger } from "./telemetry/logging.js";
-import type { DeleteMeLibraryApi } from "@superblocksteam/library-shared/types";
-import type { Plugin } from "vite";
 
 type ApiDependency = {
   apiName: string;

package/src/vite-plugin-inject-sb-ids-transform.mts

@@ -1,13 +1,16 @@
 import path from "node:path";
+
 import { transformFromAstSync } from "@babel/core";
 import { parse } from "@babel/parser";
 import tsTransformPlugin from "@babel/plugin-transform-typescript";
-import { supplementElementIds } from "@superblocksteam/vite-plugin-file-sync";
 import { red, yellow } from "colorette";
 import { createLogger } from "vite";
-import { getLogger } from "./telemetry/logging.js";
 import type { Plugin } from "vite";
 
+import { supplementElementIds } from "@superblocksteam/vite-plugin-file-sync";
+
+import { getLogger } from "./telemetry/logging.js";
+
 /**
  * Creates a Vite plugin that injects Superblocks IDs into the application.
  * This will primarily be used during builds, as the dev server leverages the

package/src/vite-plugin-sdk-api-entry-point.mts

@@ -1,4 +1,5 @@
 import path from "node:path";
+
 import type { Plugin } from "vite";
 
 /**

package/src/vite-plugin-sdk-api-entry-point.test.mts

@@ -1,5 +1,7 @@
 import path from "node:path";
+
 import { describe, it, expect } from "vitest";
+
 import { sdkApiEntryPointPlugin } from "./vite-plugin-sdk-api-entry-point.mjs";
 
 type TransformResult = {

package/test/clients.test.mts

@@ -1,9 +1,12 @@
 import fs from "fs";
 import path from "path";
+
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
+
+import type { SuperblocksDevEnvironmentConfig } from "@superblocksteam/util";
+
 import { BranchSource, getCurrentBranchInfo } from "../src/client.js";
 import { getCurrentGitBranch } from "../src/version-control.mjs";
-import type { SuperblocksDevEnvironmentConfig } from "@superblocksteam/util";
 
 // The .superblocks folder is located in the 'test' directory, so we need to prefix the path in order to find it.
 const testPathPrefix = "test";

package/test/safe-stringify.test.mts

@@ -1,4 +1,5 @@
 import { describe, expect, it } from "vitest";
+
 import { safeStringify } from "../src/telemetry/safe-stringify.js";
 
 describe("safeStringify", () => {