Public api schemas v2

api/server/app-env.ts

@@ -4,4 +4,5 @@ export {
     isDatalensMode,
     isFullMode,
     isApiMode,
+    isPublicApiMode,
 } from '../../src/server/app-env';

api/server/components.ts

@@ -19,3 +19,12 @@ export {
 } from '../../src/server/components/charts-engine';
 
 export {renderHTML} from '../../src/server/components/charts-engine/components/markdown';
+
+export {initPublicApiSwagger} from '../../src/server/components/public-api';
+
+export {PUBLIC_API_PROXY_MAP, PUBLIC_API_ROUTE} from '../../src/server/components/public-api';
+export type {
+    PublicApiRpcMap,
+    PublicApiConfig,
+    PublicApiSecuritySchemes,
+} from '../../src/server/components/public-api/types';

api/server/constants.ts

@@ -1,2 +1,3 @@
 export {SERVICE_NAME_DATALENS} from '../../src/server/constants';
 export {IPV6_AXIOS_OPTIONS} from '../../src/server/constants/axios';
+export {PUBLIC_API_ORG_ID_HEADER} from '../../src/server/constants/public-api';

api/server/controllers.ts

@@ -1,2 +1,3 @@
 export {ping} from '../../src/server/controllers/ping';
 export {chartsController} from '../../src/server/components/charts-engine/controllers/charts';
+export {createPublicApiController} from '../../src/server/controllers';

package.json

@@ -54,6 +54,7 @@
   "author": "DataLens Team <https://github.com/datalens-tech>",
   "license": "Apache-2.0",
   "dependencies": {
+    "@asteasolutions/zod-to-openapi": "^7.3.4",
     "@braintree/sanitize-url": "^6.0.0",
     "@datalens-tech/ui-sandbox-modules": "^0.36.0",
     "@datalens-tech/xlsx": "^0.20.1",
@@ -118,7 +119,9 @@
     "request-ip": "^3.3.0",
     "request-promise-native": "^1.0.9",
     "set-cookie-parser": "^2.7.1",
-    "workerpool": "^9.1.1"
+    "swagger-ui-express": "^5.0.1",
+    "workerpool": "^9.1.1",
+    "zod": "^3.25.64"
   },
   "devDependencies": {
     "@floating-ui/react": "^0.27.13",
@@ -181,6 +184,7 @@
     "@types/request-ip": "^0.0.41",
     "@types/request-promise-native": "^1.0.21",
     "@types/set-cookie-parser": "^2.4.10",
+    "@types/swagger-ui-express": "^4.1.8",
     "@types/uuid": "^9.0.8",
     "@types/webpack-env": "^1.16.0",
     "bem-cn-lite": "^4.0.0",

src/server/app-env.ts

@@ -10,4 +10,6 @@ export const isFullMode = mode === AppMode.Full;
 export const isDatalensMode = mode === AppMode.Datalens;
 export const isChartsMode = mode === AppMode.Charts;
 export const isApiMode = mode === AppMode.Api;
+export const isPublicApiMode = mode === AppMode.PublicApi;
+
 export const isOpensourceInstallation = appInstallation === AppInstallation.Opensource;

src/server/components/api-docs/constants.ts

@@ -0,0 +1 @@
+export const CONTENT_TYPE_JSON = 'application/json';

src/server/components/api-docs/index.ts

@@ -0,0 +1 @@
+export type {SecuritySchemeObject} from './types';

src/server/components/api-docs/types.ts

@@ -0,0 +1,14 @@
+// Copied from @asteasolutions/zod-to-openapi
+export type Method = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options' | 'trace';
+
+export type SecuritySchemeType = 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+
+export type SecuritySchemeObject = {
+    type: SecuritySchemeType;
+    description?: string;
+    name?: string;
+    in?: string;
+    scheme?: string;
+    bearerFormat?: string;
+    openIdConnectUrl?: string;
+};

src/server/components/charts-engine/components/storage/united-storage/provider.ts

@@ -27,6 +27,7 @@ import {
     TRACE_ID_HEADER,
     US_PUBLIC_API_TOKEN_HEADER,
     WORKBOOK_ID_HEADER,
+    mapChartsConfigToLatestVersion,
 } from '../../../../../../shared';
 import {ErrorCode, TIMEOUT_10_SEC} from '../../../../../../shared/constants';
 import {createErrorHandler} from '../../error-handler';
@@ -226,7 +227,7 @@ export type ProviderCreateParams = {
     recursion?: boolean;
     meta?: Record<string, string>;
     includePermissionsInfo?: boolean | string;
-    workbookId: string;
+    workbookId: string | null;
     name: string;
     mode?: EntryUpdateMode;
     annotation?: EntryAnnotationArgs;
@@ -357,6 +358,29 @@ export class USProvider {
             });
     }
 
+    static async retrieveParsedWizardChart(
+        ctx: AppContext,
+        props: {
+            id: string;
+            storageApiPath?: string;
+            extraAllowedHeaders?: string[];
+            unreleased: boolean | string;
+            includeLinks?: boolean | string;
+            includePermissionsInfo?: boolean | string;
+            revId?: string;
+            headers: Request['headers'];
+            workbookId?: WorkbookId;
+            includeServicePlan?: boolean;
+            includeTenantFeatures?: boolean;
+        },
+    ) {
+        const result = await USProvider.retrieveById(ctx, props);
+
+        result.data = mapChartsConfigToLatestVersion(JSON.parse(result.data.shared)) as any;
+
+        return result;
+    }
+
     static retrieveByKey(
         ctx: AppContext,
         {
@@ -610,7 +634,7 @@ export class USProvider {
             recursion: boolean;
             links?: unknown;
             meta: Record<string, string>;
-            workbookId: string;
+            workbookId: string | null;
             name: string;
             includePermissionsInfo?: boolean;
             mode: EntryUpdateMode;