Entries schemas (#2629)

Co-authored-by: Vladimir Stepanenko 🏴‍☠️ <[email protected]>

Author: Serge Pavlyuk

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-lock.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",

package.json

@@ -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/app-env.ts

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

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

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

src/server/components/api-docs/index.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;
+};