@flowgram.ai/runtime-nodejs 0.1.0-alpha.10

package/src/api/trpc.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { OpenApiMeta } from 'trpc-openapi';
+import { initTRPC } from '@trpc/server';
+
+import type { Context } from '../server/context';
+
+const t = initTRPC
+  .context<Context>()
+  .meta<OpenApiMeta>()
+  .create({
+    errorFormatter({ shape }) {
+      return shape;
+    },
+  });
+
+export const router = t.router;
+export const publicProcedure = t.procedure;

package/src/api/type.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { BuildProcedure } from '@trpc/server';
+import { FlowGramAPIDefine } from '@flowgram.ai/runtime-interface';
+
+export interface APIHandler {
+  define: FlowGramAPIDefine;
+  procedure: BuildProcedure<any, any, any>;
+}
+
+export type APIRouter = Record<FlowGramAPIDefine['path'], APIHandler['procedure']>;

package/src/config/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import type { ServerParams } from '@server/type';
+
+export const ServerConfig: ServerParams = {
+  name: 'flowgram-runtime',
+  title: 'FlowGram Runtime',
+  description: 'FlowGram Runtime Demo',
+  runtime: 'nodejs',
+  version: '0.0.1',
+  dev: false,
+  port: 4000,
+  basePath: '/api',
+  docsPath: '/docs',
+};

package/src/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { createServer } from '@server/index';
+
+async function main() {
+  const server = await createServer();
+  server.start();
+}
+
+main();

package/src/server/context.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import type { CreateFastifyContextOptions } from '@trpc/server/adapters/fastify';
+
+export function createContext(ctx: CreateFastifyContextOptions) {
+  const { req, res } = ctx;
+  return { req, res };
+}
+
+export type Context = Awaited<ReturnType<typeof createContext>>;

package/src/server/docs.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { generateOpenApiDocument } from 'trpc-openapi';
+
+import { ServerConfig } from '@config/index';
+import { appRouter } from '@api/index';
+
+// Generate OpenAPI schema document
+export const serverDocument = generateOpenApiDocument(appRouter, {
+  title: ServerConfig.title,
+  description: ServerConfig.description,
+  version: ServerConfig.version,
+  baseUrl: `http://localhost:${ServerConfig.port}${ServerConfig.basePath}`,
+  docsUrl: 'https://flowgram.ai',
+  tags: ['Task'],
+});

package/src/server/index.ts

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { fastifyTRPCOpenApiPlugin } from 'trpc-openapi';
+import fastify from 'fastify';
+import { fastifyTRPCPlugin } from '@trpc/server/adapters/fastify';
+import { ServerInfoDefine, type ServerInfoOutput } from '@flowgram.ai/runtime-interface';
+import ws from '@fastify/websocket';
+import fastifySwaggerUI from '@fastify/swagger-ui';
+import fastifySwagger from '@fastify/swagger';
+import cors from '@fastify/cors';
+
+import { ServerConfig } from '@config/index';
+import { appRouter } from '@api/index';
+import { serverDocument } from './docs';
+import { createContext } from './context';
+
+export async function createServer() {
+  const server = fastify({ logger: ServerConfig.dev });
+
+  await server.register(cors);
+  await server.register(ws);
+  await server.register(fastifyTRPCPlugin, {
+    prefix: '/trpc',
+    useWss: false,
+    trpcOptions: { router: appRouter, createContext },
+  });
+  await server.register(fastifyTRPCOpenApiPlugin, {
+    basePath: ServerConfig.basePath,
+    router: appRouter,
+    createContext,
+  } as any);
+
+  await server.register(fastifySwagger, {
+    mode: 'static',
+    specification: { document: serverDocument },
+    uiConfig: { displayOperationId: true },
+    exposeRoute: true,
+  } as any);
+
+  await server.register(fastifySwaggerUI, {
+    routePrefix: ServerConfig.docsPath,
+    uiConfig: {
+      docExpansion: 'full',
+      deepLinking: false,
+    },
+    uiHooks: {
+      onRequest: function (request, reply, next) {
+        next();
+      },
+      preHandler: function (request, reply, next) {
+        next();
+      },
+    },
+    staticCSP: true,
+    transformStaticCSP: (header) => header,
+    transformSpecification: (swaggerObject, request, reply) => swaggerObject,
+    transformSpecificationClone: true,
+  });
+
+  server.get(ServerInfoDefine.path, async (): Promise<ServerInfoOutput> => {
+    const serverTime = new Date();
+    const output: ServerInfoOutput = {
+      name: ServerConfig.name,
+      title: ServerConfig.title,
+      description: ServerConfig.description,
+      runtime: ServerConfig.runtime,
+      version: ServerConfig.version,
+      time: serverTime.toISOString(),
+    };
+    return output;
+  });
+
+  const stop = async () => {
+    await server.close();
+  };
+  const start = async () => {
+    try {
+      const address = await server.listen({ port: ServerConfig.port });
+      await server.ready();
+      server.swagger();
+      console.log(
+        `> Listen Port: ${ServerConfig.port}\n> Server Address: ${address}\n> API Docs: http://localhost:4000/docs`
+      );
+    } catch (err) {
+      server.log.error(err);
+      process.exit(1);
+    }
+  };
+
+  return { server, start, stop };
+}

package/src/server/type.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { ServerInfoOutput } from '@flowgram.ai/runtime-interface';
+
+export interface ServerParams extends Omit<ServerInfoOutput, 'time'> {
+  dev: boolean;
+  port: number;
+  basePath: string;
+  docsPath: string;
+}

package/tsconfig.json

@@ -0,0 +1,48 @@
+{
+  "extends": "@flowgram.ai/ts-config/tsconfig.flow.path.json",
+  "compilerOptions": {
+    "target": "esnext",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "plugins": [],
+    "baseUrl": "src",
+    "paths": {
+      "@api/*": [
+        "api/*"
+      ],
+      "@application/*": [
+        "application/*"
+      ],
+      "@server/*": [
+        "server/*"
+      ],
+      "@config/*": [
+        "config/*"
+      ],
+      "@workflow/*": [
+        "workflow/*"
+      ]
+    }
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "src/workflow/executor/condition/constant.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/vitest.config.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { config } from "dotenv";
+import path from 'path';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  build: {
+    commonjsOptions: {
+      transformMixedEsModules: true,
+    },
+  },
+  resolve: {
+    alias: [
+      {find: "@api", replacement: path.resolve(__dirname, './src/api') },
+      {find: "@application", replacement: path.resolve(__dirname, './src/application') },
+      {find: "@server", replacement: path.resolve(__dirname, './src/server') },
+      {find: "@config", replacement: path.resolve(__dirname, './src/config') },
+      {find: "@workflow", replacement: path.resolve(__dirname, './src/workflow') },
+    ],
+  },
+  test: {
+    globals: true,
+    mockReset: false,
+    environment: 'jsdom',
+    testTimeout: 15000,
+    setupFiles: [path.resolve(__dirname, './src/workflow/__tests__/setup.ts')],
+    include: ['**/?(*.){test,spec}.?(c|m)[jt]s?(x)'],
+    exclude: [
+      '**/__mocks__**',
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/lib/**', // lib 编译结果忽略掉
+      '**/cypress/**',
+      '**/.{idea,git,cache,output,temp}/**',
+      '**/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build}.config.*',
+    ],
+    env: {
+      ...config({ path: path.resolve(__dirname, './.env/.env.test') }).parsed
+    }
+  },
+});