@env-hopper/backend-core 2.0.1-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Igor Golovin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/esm/__tests__/dummy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/index.d.ts

@@ -0,0 +1,7 @@
+export { trpcRouter } from './server/controller.js';
+export type { TRPCRouter } from './server/controller.js';
+export { createEhTrpcContext } from './server/ehTrpcContext.js';
+export type { EhTrpcContext, EhTrpcContextOptions, } from './server/ehTrpcContext.js';
+export { staticControllerContract } from './server/ehStaticControllerContract.js';
+export type { EhStaticControllerContract } from './server/ehStaticControllerContract.js';
+export * from './types/index.js';

package/dist/esm/index.js

@@ -0,0 +1,9 @@
+import { trpcRouter } from "./server/controller.js";
+import { createEhTrpcContext } from "./server/ehTrpcContext.js";
+import { staticControllerContract } from "./server/ehStaticControllerContract.js";
+export {
+  createEhTrpcContext,
+  staticControllerContract,
+  trpcRouter
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/esm/server/controller.d.ts

@@ -0,0 +1,32 @@
+import { EhTrpcContext } from './ehTrpcContext.js';
+export declare const trpcRouter: import('@trpc/server').TRPCBuiltRouter<{
+    ctx: EhTrpcContext;
+    meta: {};
+    errorShape: import('@trpc/server').TRPCDefaultErrorShape;
+    transformer: false;
+}, import('@trpc/server').TRPCDecorateCreateRouterOptions<{
+    bootstrap: import('@trpc/server').TRPCQueryProcedure<{
+        input: void;
+        output: import('..').BootstrapConfigData;
+        meta: {};
+    }>;
+    availabilityMatrix: import('@trpc/server').TRPCQueryProcedure<{
+        input: void;
+        output: import('..').AvailiabilityMatrixData;
+        meta: {};
+    }>;
+    tryFindRenameRule: import('@trpc/server').TRPCQueryProcedure<{
+        input: {
+            envSlug?: string | undefined;
+            resourceSlug?: string | undefined;
+        };
+        output: false | import('..').RenameRule;
+        meta: {};
+    }>;
+    resourceJumps: import('@trpc/server').TRPCQueryProcedure<{
+        input: void;
+        output: import('..').ResourceJumpsData;
+        meta: {};
+    }>;
+}>>;
+export type TRPCRouter = typeof trpcRouter;

package/dist/esm/server/controller.js

@@ -0,0 +1,35 @@
+import { initTRPC } from "@trpc/server";
+import z from "zod";
+const t = initTRPC.context().create();
+const router = t.router;
+const publicProcedure = t.procedure;
+const trpcRouter = router({
+  bootstrap: publicProcedure.query(async ({ ctx }) => {
+    return await ctx.companySpecificBackend.getBootstrapData();
+  }),
+  availabilityMatrix: publicProcedure.query(async ({ ctx }) => {
+    return await ctx.companySpecificBackend.getAvailabilityMatrix();
+  }),
+  tryFindRenameRule: publicProcedure.input(
+    z.object({
+      envSlug: z.string().optional(),
+      resourceSlug: z.string().optional()
+    })
+  ).query(async ({ input, ctx }) => {
+    return await ctx.companySpecificBackend.getNameMigrations(input);
+  }),
+  resourceJumps: publicProcedure.query(async ({ ctx }) => {
+    return await ctx.companySpecificBackend.getResourceJumps();
+  })
+  // specificEnvs: publicProcedure
+  //   .query(async ({ctx}) => {
+  //     return await ctx.companySpecificBackend.getDeployments({
+  //       envNames: ['dev', 'prod'],
+  //       appNames: ['app1', 'app2'],
+  //     })
+  //   }),
+});
+export {
+  trpcRouter
+};
+//# sourceMappingURL=controller.js.map

package/dist/esm/server/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sources":["../../../src/server/controller.ts"],"sourcesContent":["import { initTRPC } from '@trpc/server'\nimport z from 'zod'\nimport type { EhTrpcContext } from './ehTrpcContext'\nimport type { TRPCRootObject } from '@trpc/server'\n\n/**\n * Initialization of tRPC backend\n * Should be done only once per backend!\n */\nconst t: TRPCRootObject<EhTrpcContext, {}, {}> = initTRPC\n  .context<EhTrpcContext>()\n  .create()\n\n/**\n * Export reusable router and procedure helpers\n * that can be used throughout the router\n */\nconst router: typeof t.router = t.router\nconst publicProcedure: typeof t.procedure = t.procedure\n\nexport const trpcRouter = router({\n  bootstrap: publicProcedure.query(async ({ ctx }) => {\n    return await ctx.companySpecificBackend.getBootstrapData()\n  }),\n\n  availabilityMatrix: publicProcedure.query(async ({ ctx }) => {\n    return await ctx.companySpecificBackend.getAvailabilityMatrix()\n  }),\n\n  tryFindRenameRule: publicProcedure\n    .input(\n      z.object({\n        envSlug: z.string().optional(),\n        resourceSlug: z.string().optional(),\n      }),\n    )\n    .query(async ({ input, ctx }) => {\n      return await ctx.companySpecificBackend.getNameMigrations(input)\n    }),\n\n  resourceJumps: publicProcedure.query(async ({ ctx }) => {\n    return await ctx.companySpecificBackend.getResourceJumps()\n  }),\n\n  // specificEnvs: publicProcedure\n  //   .query(async ({ctx}) => {\n  //     return await ctx.companySpecificBackend.getDeployments({\n  //       envNames: ['dev', 'prod'],\n  //       appNames: ['app1', 'app2'],\n  //     })\n  //   }),\n})\n\nexport type TRPCRouter = typeof trpcRouter\n"],"names":[],"mappings":";;AASA,MAAM,IAA2C,SAC9C,QAAA,EACA,OAAA;AAMH,MAAM,SAA0B,EAAE;AAClC,MAAM,kBAAsC,EAAE;AAEvC,MAAM,aAAa,OAAO;AAAA,EAC/B,WAAW,gBAAgB,MAAM,OAAO,EAAE,UAAU;AAClD,WAAO,MAAM,IAAI,uBAAuB,iBAAA;AAAA,EAC1C,CAAC;AAAA,EAED,oBAAoB,gBAAgB,MAAM,OAAO,EAAE,UAAU;AAC3D,WAAO,MAAM,IAAI,uBAAuB,sBAAA;AAAA,EAC1C,CAAC;AAAA,EAED,mBAAmB,gBAChB;AAAA,IACC,EAAE,OAAO;AAAA,MACP,SAAS,EAAE,OAAA,EAAS,SAAA;AAAA,MACpB,cAAc,EAAE,OAAA,EAAS,SAAA;AAAA,IAAS,CACnC;AAAA,EAAA,EAEF,MAAM,OAAO,EAAE,OAAO,UAAU;AAC/B,WAAO,MAAM,IAAI,uBAAuB,kBAAkB,KAAK;AAAA,EACjE,CAAC;AAAA,EAEH,eAAe,gBAAgB,MAAM,OAAO,EAAE,UAAU;AACtD,WAAO,MAAM,IAAI,uBAAuB,iBAAA;AAAA,EAC1C,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASH,CAAC;"}

package/dist/esm/server/db.d.ts

@@ -0,0 +1,2 @@
+import { PrismaClient } from '@prisma/client';
+export declare const db: PrismaClient<import("@prisma/client").Prisma.PrismaClientOptions, never, import('@prisma/client/runtime/library').DefaultArgs>;

package/dist/esm/server/ehStaticControllerContract.d.ts

@@ -0,0 +1,9 @@
+export interface EhStaticControllerContract {
+    methods: {
+        getIcon: {
+            method: string;
+            url: string;
+        };
+    };
+}
+export declare const staticControllerContract: EhStaticControllerContract;

package/dist/esm/server/ehStaticControllerContract.js

@@ -0,0 +1,12 @@
+const staticControllerContract = {
+  methods: {
+    getIcon: {
+      method: "get",
+      url: "icon/:icon"
+    }
+  }
+};
+export {
+  staticControllerContract
+};
+//# sourceMappingURL=ehStaticControllerContract.js.map

package/dist/esm/server/ehStaticControllerContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ehStaticControllerContract.js","sources":["../../../src/server/ehStaticControllerContract.ts"],"sourcesContent":["export interface EhStaticControllerContract {\n  methods: { getIcon: { method: string; url: string } }\n}\n\nexport const staticControllerContract: EhStaticControllerContract = {\n  methods: {\n    getIcon: {\n      method: 'get',\n      url: 'icon/:icon',\n    },\n  },\n}\n"],"names":[],"mappings":"AAIO,MAAM,2BAAuD;AAAA,EAClE,SAAS;AAAA,IACP,SAAS;AAAA,MACP,QAAQ;AAAA,MACR,KAAK;AAAA,IAAA;AAAA,EACP;AAEJ;"}

package/dist/esm/server/ehTrpcContext.d.ts

@@ -0,0 +1,8 @@
+import { EhBackendCompanySpecificBackend } from '../types.js';
+export interface EhTrpcContext {
+    companySpecificBackend: EhBackendCompanySpecificBackend;
+}
+export interface EhTrpcContextOptions {
+    companySpecificBackend: EhBackendCompanySpecificBackend;
+}
+export declare function createEhTrpcContext({ companySpecificBackend, }: EhTrpcContextOptions): EhTrpcContext;

package/dist/esm/server/ehTrpcContext.js

@@ -0,0 +1,11 @@
+function createEhTrpcContext({
+  companySpecificBackend
+}) {
+  return {
+    companySpecificBackend
+  };
+}
+export {
+  createEhTrpcContext
+};
+//# sourceMappingURL=ehTrpcContext.js.map

package/dist/esm/server/ehTrpcContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ehTrpcContext.js","sources":["../../../src/server/ehTrpcContext.ts"],"sourcesContent":["import type { EhBackendCompanySpecificBackend } from '../types'\n\nexport interface EhTrpcContext {\n  companySpecificBackend: EhBackendCompanySpecificBackend\n}\n\nexport interface EhTrpcContextOptions {\n  companySpecificBackend: EhBackendCompanySpecificBackend\n}\n\nexport function createEhTrpcContext({\n  companySpecificBackend,\n}: EhTrpcContextOptions): EhTrpcContext {\n  return {\n    companySpecificBackend,\n  }\n}\n\n// const createContext = ({\n//                          req,\n//                          res\n//                        }: trpcExpress.CreateExpressContextOptions) => ({}); // no context\n// type Context = Awaited<ReturnType<typeof createContext>>;\n"],"names":[],"mappings":"AAUO,SAAS,oBAAoB;AAAA,EAClC;AACF,GAAwC;AACtC,SAAO;AAAA,IACL;AAAA,EAAA;AAEJ;"}

package/dist/esm/types/backend/api.d.ts

@@ -0,0 +1,71 @@
+import { AvailiabilityMatrixData, BootstrapConfigData, ResourceJumpsData } from '../common/dataRootTypes.js';
+import { EhAppIndexed } from '../common/app/appTypes.js';
+import { EhAppPageIndexed, EhAppUiIndexed } from '../common/app/ui/appUiTypes.js';
+import { EhBackendCredentialInput, EhBackendUiDefaultsInput } from './common.js';
+import { EhBackendDataSourceInput } from './dataSources.js';
+export interface EhBackendVersionsRequestParams {
+    envNames: Array<string>;
+    appNames: Array<string>;
+}
+export interface EhBackendVersionsReturn {
+    envIds: Array<string>;
+    appIds: Array<string>;
+}
+export interface EhBackendPageInput extends EhAppPageIndexed {
+    slug: string;
+    title?: string;
+    url: string;
+    credentialsRefs?: Array<string>;
+}
+export interface EhBackendAppUIBaseInput {
+    credentials?: Array<EhBackendCredentialInput>;
+    defaults?: EhBackendUiDefaultsInput;
+}
+export interface EhBackendAppUIInput extends EhBackendAppUIBaseInput, EhAppUiIndexed {
+    pages: Array<EhBackendPageInput>;
+}
+export interface EhBackendTagsDescriptionDataIndexed {
+    descriptions: Array<EhBackendTagDescriptionDataIndexed>;
+}
+export interface EhBackendTagDescriptionDataIndexed {
+    tagKey: string;
+    displayName?: string;
+    fixedTagValues?: Array<EhBackendTagFixedTagValue>;
+}
+export interface EhBackendTagFixedTagValue {
+    tagValue: string;
+    displayName: string;
+}
+export interface EhBackendAppInput extends EhAppIndexed {
+    ui?: EhBackendAppUIInput;
+    dataSources?: Array<EhBackendDataSourceInput>;
+}
+export interface EhContextIndexed {
+    slug: string;
+    displayName: string;
+    /**
+     * The value is shared across envs (By default: false)
+     */
+    isSharedAcrossEnvs?: boolean;
+    defaultFixedValues?: Array<string>;
+}
+export type EhBackendAppDto = EhAppIndexed;
+export interface EhAppsMeta {
+    defaultIcon?: string;
+    tags: EhBackendTagsDescriptionDataIndexed;
+}
+export interface RenameRuleParams {
+    envSlug?: string;
+    resourceSlug?: string;
+}
+export interface RenameRule {
+    type: 'resourceRename' | 'envRename';
+    oldSlug: string;
+    targetSlug: string;
+}
+export interface EhBackendCompanySpecificBackend {
+    getBootstrapData: () => Promise<BootstrapConfigData>;
+    getAvailabilityMatrix: () => Promise<AvailiabilityMatrixData>;
+    getNameMigrations: (params: RenameRuleParams) => Promise<RenameRule | false>;
+    getResourceJumps: () => Promise<ResourceJumpsData>;
+}

package/dist/esm/types/backend/common.d.ts

@@ -0,0 +1,9 @@
+export interface EhBackendUiDefaultsInput {
+    credentialsRefs: Array<string>;
+}
+export interface EhBackendCredentialInput {
+    slug: string;
+    desc?: string;
+    username: string;
+    password: string;
+}

package/dist/esm/types/backend/dataSources.d.ts

@@ -0,0 +1,20 @@
+import { EhMetaDictionary } from '../common/sharedTypes.js';
+export interface EhBackendDataSourceInputCommon {
+    meta?: EhMetaDictionary;
+}
+export interface EhBackendDataSourceInputDb {
+    slug?: string;
+    type: 'db';
+    url: string;
+    username: string;
+    password: string;
+}
+export interface EhBackendDataSourceInputKafka {
+    slug?: string;
+    type: 'kafka';
+    topics: {
+        consumer?: Array<string>;
+        producer?: Array<string>;
+    };
+}
+export type EhBackendDataSourceInput = EhBackendDataSourceInputCommon & (EhBackendDataSourceInputDb | EhBackendDataSourceInputKafka);

package/dist/esm/types/backend/deployments.d.ts

@@ -0,0 +1,34 @@
+import { EhMetaDictionary } from '../common/sharedTypes.js';
+export interface EhBackendEnvironmentInput {
+    slug: string;
+    displayName?: string;
+    description?: string;
+    meta?: EhMetaDictionary;
+}
+export interface EhBackendDeploymentInput {
+    envId: string;
+    appId: string;
+    displayVersion: string;
+    meta?: EhMetaDictionary;
+}
+export interface EhBackendDeployableInput {
+    slug: string;
+    meta?: {
+        config: string;
+    };
+}
+/**
+ * Latest - backend returned latest data.
+ * Cached - backend in process of updating data, but returned cached data.
+ */
+export type EhBackendDataFreshness = 'latest' | 'cached';
+export interface EhBackendDataVersion {
+    version: string;
+    freshness: EhBackendDataFreshness;
+}
+export interface EhBackendDeployment {
+    appName: string;
+    deployableServiceName: string;
+    envName: string;
+    version: EhBackendDataVersion;
+}

package/dist/esm/types/common/app/appTypes.d.ts

@@ -0,0 +1,12 @@
+import { EhMetaDictionary, Tag } from '../sharedTypes.js';
+import { EhAppUiIndexed } from './ui/appUiTypes.js';
+export interface EhAppIndexed {
+    slug: string;
+    displayName: string;
+    abbr?: string;
+    aliases?: Array<string>;
+    ui?: EhAppUiIndexed;
+    tags?: Array<Tag>;
+    iconName?: string;
+    meta?: EhMetaDictionary;
+}

package/dist/esm/types/common/app/ui/appUiTypes.d.ts

@@ -0,0 +1,10 @@
+import { Tag } from '../../sharedTypes.js';
+export interface EhAppPageIndexed {
+    slug: string;
+    displayName: string;
+    url: string;
+    tags?: Array<Tag>;
+}
+export interface EhAppUiIndexed {
+    pages: Array<EhAppPageIndexed>;
+}

package/dist/esm/types/common/appCatalogTypes.d.ts

@@ -0,0 +1,16 @@
+export interface EhAppCatalogData {
+    apps: Array<EhAppCatalogDto>;
+}
+export interface EhAppCatalogDto {
+    slug: string;
+    groups: Array<EhAppCatalogGroupDto>;
+}
+export interface EhAppCatalogGroupDto {
+    slug: string;
+    displayName: string;
+    pages: Array<EhAppCatalogPageDto>;
+}
+export interface EhAppCatalogPageDto {
+    slug: string;
+    displayName: string;
+}

package/dist/esm/types/common/dataRootTypes.d.ts

@@ -0,0 +1,32 @@
+import { EhAppsMeta, EhContextIndexed } from '../backend/api.js';
+import { EhEnvIndexed } from './env/envTypes.js';
+import { EhAppIndexed } from './app/appTypes.js';
+export type JumpResouceSlug = string;
+export type EnvSlug = string;
+export interface BootstrapConfigData {
+    envs: Record<EnvSlug, EhEnvIndexed>;
+    apps: Record<string, EhAppIndexed>;
+    appsMeta: EhAppsMeta;
+    contexts: Array<EhContextIndexed>;
+    defaults: {
+        envSlug: EnvSlug;
+        resourceJumpSlug: JumpResouceSlug;
+    };
+}
+export interface AvailiabilityMatrixData {
+    envSlugs: Array<EnvSlug>;
+    resourceJumpSlugs: Array<JumpResouceSlug>;
+    availabilityVariants: Array<AvailabilityVariant>;
+    matrix: Array<Array<number>>;
+}
+export interface AvailabilityVariant {
+    isDeployed: boolean;
+    isHealthy?: boolean;
+    hasData?: boolean;
+}
+export interface ResourceJumpsData {
+    baseResouceJumpUrls: Record<JumpResouceSlug, string>;
+    resourceJumpsData: Record<JumpResouceSlug, Record<string, string>>;
+    envData: Record<EnvSlug, Record<string, string>>;
+    overrideResoucesJumpsUrls: Record<EnvSlug, Record<JumpResouceSlug, string>>;
+}

package/dist/esm/types/common/env/envTypes.d.ts

@@ -0,0 +1,6 @@
+import { EhMetaDictionary } from '../sharedTypes.js';
+export interface EhEnvIndexed {
+    slug: string;
+    displayName: string;
+    meta?: EhMetaDictionary;
+}

package/dist/esm/types/common/resourceTypes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resources like kafka topics, database tables, etc.
+ */
+export interface EhResourceIndexed {
+    slug: string;
+    displayName: string;
+    defaultFixedValues?: Array<string>;
+}

package/dist/esm/types/common/sharedTypes.d.ts

@@ -0,0 +1,4 @@
+export interface EhMetaDictionary {
+    [key: string]: string | null | Record<string, string | null>;
+}
+export type Tag = string;

package/dist/esm/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from './common/sharedTypes.js';
+export * from './common/resourceTypes.js';
+export * from './common/dataRootTypes.js';
+export * from './common/appCatalogTypes.js';
+export * from './common/env/envTypes.js';
+export * from './common/app/appTypes.js';
+export * from './common/app/ui/appUiTypes.js';
+export * from './backend/api.js';
+export * from './backend/common.js';
+export * from './backend/dataSources.js';
+export * from './backend/deployments.js';

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@env-hopper/backend-core",
+  "version": "2.0.1-alpha",
+  "description": "Backend core library for Env Hopper",
+  "homepage": "https://github.com/lislon/env-hopper",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lislon/env-hopper.git",
+    "directory": "packages/backend-core"
+  },
+  "license": "MIT",
+  "author": "Igor Golovin",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "my-custom-condition": "./src/index.ts",
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@kubernetes/client-node": "^1.2.0",
+    "@prisma/client": "^6.9.0",
+    "@trpc/client": "^11.4.2",
+    "@trpc/server": "^11.4.2",
+    "cors": "^2.8.5",
+    "dotenv-defaults": "5.0.2",
+    "express": "^5.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "reflect-metadata": "^0.2.2",
+    "tsyringe": "^4.10.0",
+    "yaml": "^2.8.0",
+    "zod": "^3.25.49"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.18",
+    "@types/dotenv-defaults": "^2.0.4",
+    "@types/jsonwebtoken": "^9.0.9",
+    "@types/node": "^24.3.0",
+    "esbuild": "^0.25.5",
+    "prisma": "^6.8.2",
+    "tsx": "^4.19.4",
+    "typescript": "5.8.3",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "premove ./dist ./coverage ./dist-ts",
+    "compile": "tsc --build",
+    "dev": "tsx watch src/index.ts",
+    "prisma:generate": "prisma generate",
+    "test:eslint": "eslint ./src",
+    "test:unit": "vitest",
+    "test:unit:dev": "pnpm run test:unit --watch"
+  }
+}

package/src/__tests__/dummy.test.ts

@@ -0,0 +1,7 @@
+import { describe, expect, it } from 'vitest'
+
+describe('dummy', () => {
+  it('always passes', () => {
+    expect(true).toBe(true)
+  })
+})

package/src/index.ts

@@ -0,0 +1,18 @@
+// common
+
+export { trpcRouter } from './server/controller'
+export type { TRPCRouter } from './server/controller'
+export { createEhTrpcContext } from './server/ehTrpcContext'
+export type {
+  EhTrpcContext,
+  EhTrpcContextOptions,
+} from './server/ehTrpcContext'
+
+export { staticControllerContract } from './server/ehStaticControllerContract'
+export type { EhStaticControllerContract } from './server/ehStaticControllerContract'
+
+// ui-only
+
+// backend-only
+
+export * from './types/index'

package/src/server/controller.ts

@@ -0,0 +1,54 @@
+import { initTRPC } from '@trpc/server'
+import z from 'zod'
+import type { EhTrpcContext } from './ehTrpcContext'
+import type { TRPCRootObject } from '@trpc/server'
+
+/**
+ * Initialization of tRPC backend
+ * Should be done only once per backend!
+ */
+const t: TRPCRootObject<EhTrpcContext, {}, {}> = initTRPC
+  .context<EhTrpcContext>()
+  .create()
+
+/**
+ * Export reusable router and procedure helpers
+ * that can be used throughout the router
+ */
+const router: typeof t.router = t.router
+const publicProcedure: typeof t.procedure = t.procedure
+
+export const trpcRouter = router({
+  bootstrap: publicProcedure.query(async ({ ctx }) => {
+    return await ctx.companySpecificBackend.getBootstrapData()
+  }),
+
+  availabilityMatrix: publicProcedure.query(async ({ ctx }) => {
+    return await ctx.companySpecificBackend.getAvailabilityMatrix()
+  }),
+
+  tryFindRenameRule: publicProcedure
+    .input(
+      z.object({
+        envSlug: z.string().optional(),
+        resourceSlug: z.string().optional(),
+      }),
+    )
+    .query(async ({ input, ctx }) => {
+      return await ctx.companySpecificBackend.getNameMigrations(input)
+    }),
+
+  resourceJumps: publicProcedure.query(async ({ ctx }) => {
+    return await ctx.companySpecificBackend.getResourceJumps()
+  }),
+
+  // specificEnvs: publicProcedure
+  //   .query(async ({ctx}) => {
+  //     return await ctx.companySpecificBackend.getDeployments({
+  //       envNames: ['dev', 'prod'],
+  //       appNames: ['app1', 'app2'],
+  //     })
+  //   }),
+})
+
+export type TRPCRouter = typeof trpcRouter

package/src/server/db.ts

@@ -0,0 +1,4 @@
+import { PrismaClient } from '@prisma/client'
+import 'dotenv-defaults/config'
+
+export const db = new PrismaClient()

package/src/server/ehStaticControllerContract.ts

@@ -0,0 +1,12 @@
+export interface EhStaticControllerContract {
+  methods: { getIcon: { method: string; url: string } }
+}
+
+export const staticControllerContract: EhStaticControllerContract = {
+  methods: {
+    getIcon: {
+      method: 'get',
+      url: 'icon/:icon',
+    },
+  },
+}

package/src/server/ehTrpcContext.ts

@@ -0,0 +1,23 @@
+import type { EhBackendCompanySpecificBackend } from '../types'
+
+export interface EhTrpcContext {
+  companySpecificBackend: EhBackendCompanySpecificBackend
+}
+
+export interface EhTrpcContextOptions {
+  companySpecificBackend: EhBackendCompanySpecificBackend
+}
+
+export function createEhTrpcContext({
+  companySpecificBackend,
+}: EhTrpcContextOptions): EhTrpcContext {
+  return {
+    companySpecificBackend,
+  }
+}
+
+// const createContext = ({
+//                          req,
+//                          res
+//                        }: trpcExpress.CreateExpressContextOptions) => ({}); // no context
+// type Context = Awaited<ReturnType<typeof createContext>>;

package/src/types/backend/api.ts

@@ -0,0 +1,97 @@
+import type {
+  AvailiabilityMatrixData,
+  BootstrapConfigData,
+  ResourceJumpsData,
+} from '../common/dataRootTypes'
+import type { EhAppIndexed } from '../common/app/appTypes'
+import type {
+  EhAppPageIndexed,
+  EhAppUiIndexed,
+} from '../common/app/ui/appUiTypes'
+import type {
+  EhBackendCredentialInput,
+  EhBackendUiDefaultsInput,
+} from './common'
+import type { EhBackendDataSourceInput } from './dataSources'
+
+export interface EhBackendVersionsRequestParams {
+  envNames: Array<string>
+  appNames: Array<string>
+}
+
+export interface EhBackendVersionsReturn {
+  envIds: Array<string>
+  appIds: Array<string>
+}
+
+export interface EhBackendPageInput extends EhAppPageIndexed {
+  slug: string
+  title?: string
+  url: string
+  credentialsRefs?: Array<string>
+}
+
+export interface EhBackendAppUIBaseInput {
+  credentials?: Array<EhBackendCredentialInput>
+  defaults?: EhBackendUiDefaultsInput
+}
+
+export interface EhBackendAppUIInput
+  extends EhBackendAppUIBaseInput,
+    EhAppUiIndexed {
+  pages: Array<EhBackendPageInput>
+}
+
+export interface EhBackendTagsDescriptionDataIndexed {
+  descriptions: Array<EhBackendTagDescriptionDataIndexed>
+}
+
+export interface EhBackendTagDescriptionDataIndexed {
+  tagKey: string
+  displayName?: string
+  fixedTagValues?: Array<EhBackendTagFixedTagValue>
+}
+
+export interface EhBackendTagFixedTagValue {
+  tagValue: string
+  displayName: string
+}
+
+export interface EhBackendAppInput extends EhAppIndexed {
+  ui?: EhBackendAppUIInput
+  dataSources?: Array<EhBackendDataSourceInput>
+}
+
+export interface EhContextIndexed {
+  slug: string
+  displayName: string
+  /**
+   * The value is shared across envs (By default: false)
+   */
+  isSharedAcrossEnvs?: boolean
+  defaultFixedValues?: Array<string>
+}
+export type EhBackendAppDto = EhAppIndexed
+
+export interface EhAppsMeta {
+  defaultIcon?: string
+  tags: EhBackendTagsDescriptionDataIndexed
+}
+
+export interface RenameRuleParams {
+  envSlug?: string
+  resourceSlug?: string
+}
+
+export interface RenameRule {
+  type: 'resourceRename' | 'envRename'
+  oldSlug: string
+  targetSlug: string
+}
+
+export interface EhBackendCompanySpecificBackend {
+  getBootstrapData: () => Promise<BootstrapConfigData>
+  getAvailabilityMatrix: () => Promise<AvailiabilityMatrixData>
+  getNameMigrations: (params: RenameRuleParams) => Promise<RenameRule | false>
+  getResourceJumps: () => Promise<ResourceJumpsData>
+}

package/src/types/backend/common.ts

@@ -0,0 +1,10 @@
+export interface EhBackendUiDefaultsInput {
+  credentialsRefs: Array<string>
+}
+
+export interface EhBackendCredentialInput {
+  slug: string
+  desc?: string
+  username: string
+  password: string
+}

package/src/types/backend/dataSources.ts

@@ -0,0 +1,25 @@
+import type { EhMetaDictionary } from '../common/sharedTypes'
+
+export interface EhBackendDataSourceInputCommon {
+  meta?: EhMetaDictionary
+}
+
+export interface EhBackendDataSourceInputDb {
+  slug?: string
+  type: 'db'
+  url: string
+  username: string
+  password: string
+}
+
+export interface EhBackendDataSourceInputKafka {
+  slug?: string
+  type: 'kafka'
+  topics: {
+    consumer?: Array<string>
+    producer?: Array<string>
+  }
+}
+
+export type EhBackendDataSourceInput = EhBackendDataSourceInputCommon &
+  (EhBackendDataSourceInputDb | EhBackendDataSourceInputKafka)

package/src/types/backend/deployments.ts

@@ -0,0 +1,40 @@
+import type { EhMetaDictionary } from '../common/sharedTypes'
+
+export interface EhBackendEnvironmentInput {
+  slug: string
+  displayName?: string
+  description?: string
+  meta?: EhMetaDictionary
+}
+
+export interface EhBackendDeploymentInput {
+  envId: string
+  appId: string
+  displayVersion: string
+  meta?: EhMetaDictionary
+}
+
+export interface EhBackendDeployableInput {
+  slug: string
+  meta?: {
+    config: string
+  }
+}
+
+/**
+ * Latest - backend returned latest data.
+ * Cached - backend in process of updating data, but returned cached data.
+ */
+export type EhBackendDataFreshness = 'latest' | 'cached'
+
+export interface EhBackendDataVersion {
+  version: string
+  freshness: EhBackendDataFreshness
+}
+
+export interface EhBackendDeployment {
+  appName: string
+  deployableServiceName: string
+  envName: string
+  version: EhBackendDataVersion
+}

package/src/types/common/app/appTypes.ts

@@ -0,0 +1,13 @@
+import type { EhMetaDictionary, Tag } from '../sharedTypes'
+import type { EhAppUiIndexed } from './ui/appUiTypes'
+
+export interface EhAppIndexed {
+  slug: string
+  displayName: string
+  abbr?: string
+  aliases?: Array<string>
+  ui?: EhAppUiIndexed
+  tags?: Array<Tag>
+  iconName?: string
+  meta?: EhMetaDictionary
+}

package/src/types/common/app/ui/appUiTypes.ts

@@ -0,0 +1,12 @@
+import type { Tag } from '../../sharedTypes'
+
+export interface EhAppPageIndexed {
+  slug: string
+  displayName: string
+  url: string
+  tags?: Array<Tag>
+}
+
+export interface EhAppUiIndexed {
+  pages: Array<EhAppPageIndexed>
+}

package/src/types/common/appCatalogTypes.ts

@@ -0,0 +1,19 @@
+export interface EhAppCatalogData {
+  apps: Array<EhAppCatalogDto>
+}
+
+export interface EhAppCatalogDto {
+  slug: string
+  groups: Array<EhAppCatalogGroupDto>
+}
+
+export interface EhAppCatalogGroupDto {
+  slug: string
+  displayName: string
+  pages: Array<EhAppCatalogPageDto>
+}
+
+export interface EhAppCatalogPageDto {
+  slug: string
+  displayName: string
+}

package/src/types/common/dataRootTypes.ts

@@ -0,0 +1,38 @@
+import type { EhAppsMeta, EhContextIndexed } from '../backend/api.js'
+import type { EhEnvIndexed } from './env/envTypes.js'
+import type { EhAppIndexed } from './app/appTypes.js'
+
+export type JumpResouceSlug = string
+export type EnvSlug = string
+
+export interface BootstrapConfigData {
+  envs: Record<EnvSlug, EhEnvIndexed>
+  apps: Record<string, EhAppIndexed>
+  appsMeta: EhAppsMeta
+  contexts: Array<EhContextIndexed>
+  defaults: {
+    envSlug: EnvSlug
+    resourceJumpSlug: JumpResouceSlug
+  }
+}
+
+export interface AvailiabilityMatrixData {
+  envSlugs: Array<EnvSlug>
+  resourceJumpSlugs: Array<JumpResouceSlug>
+  availabilityVariants: Array<AvailabilityVariant>
+  matrix: Array<Array<number>>
+}
+
+export interface AvailabilityVariant {
+  isDeployed: boolean
+  isHealthy?: boolean
+  hasData?: boolean
+}
+
+export interface ResourceJumpsData {
+  // key - jump Resouce
+  baseResouceJumpUrls: Record<JumpResouceSlug, string>
+  resourceJumpsData: Record<JumpResouceSlug, Record<string, string>>
+  envData: Record<EnvSlug, Record<string, string>>
+  overrideResoucesJumpsUrls: Record<EnvSlug, Record<JumpResouceSlug, string>>
+}

package/src/types/common/env/envTypes.ts

@@ -0,0 +1,7 @@
+import type { EhMetaDictionary } from '../sharedTypes'
+
+export interface EhEnvIndexed {
+  slug: string
+  displayName: string
+  meta?: EhMetaDictionary
+}

package/src/types/common/resourceTypes.ts

@@ -0,0 +1,8 @@
+/**
+ * Resources like kafka topics, database tables, etc.
+ */
+export interface EhResourceIndexed {
+  slug: string
+  displayName: string
+  defaultFixedValues?: Array<string>
+}

package/src/types/common/sharedTypes.ts

@@ -0,0 +1,5 @@
+export interface EhMetaDictionary {
+  [key: string]: string | null | Record<string, string | null>
+}
+
+export type Tag = string

package/src/types/index.ts

@@ -0,0 +1,19 @@
+// Export all common types
+export * from './common/sharedTypes.js'
+export * from './common/resourceTypes.js'
+export * from './common/dataRootTypes.js'
+export * from './common/appCatalogTypes.js'
+export * from './common/env/envTypes.js'
+export * from './common/app/appTypes.js'
+export * from './common/app/ui/appUiTypes.js'
+
+// Main API interfaces
+export * from './backend/api.js'
+
+// Common types
+export * from './backend/common.js'
+// Data source types
+export * from './backend/dataSources.js'
+
+// Deployment and version types
+export * from './backend/deployments.js'