@celljs/cli 3.0.0

package/templates/file-service/src/file-controller.ts

@@ -0,0 +1,47 @@
+import { Autowired, Value } from '@celljs/core';
+import { HttpError, Context } from '@celljs/web/lib/node';
+import { HttpHeaders, HttpStatus } from '@celljs/http';
+import { ObjectStorageService, RawCloudService } from '@celljs/cloud';
+import { Controller, Get, Query } from '@celljs/mvc/lib/node';
+import { contentType } from 'mime-types';
+
+@Controller('files')
+export class FileController {
+
+    @Autowired(ObjectStorageService)
+    protected readonly objectStorageService: ObjectStorageService<RawCloudService>;
+
+    @Value('app.bucket')
+    protected readonly bucket: string;
+
+    @Get()
+    async merge(@Query('key') key: string) {
+        return this.doMerge(key);
+    }
+
+    private async doMerge(key: string) {
+        if (!key) {
+            throw new HttpError(HttpStatus.BAD_REQUEST, 'Missing request parameter "key".');
+        }
+        const keys = key.split(',');
+
+        const res = Context.getResponse();
+        res.set(HttpHeaders.CONTENT_TYPE, contentType(key) || '');
+        res.set(HttpHeaders.CACHE_CONTROL, 'max-age=360000');
+
+        for (const k of keys) {
+            const stream = await this.objectStorageService.getStream({ bucket: this.bucket, key: k });
+            await new Promise<void>((resolve, reject) => {
+                stream.on('error', (err) => {
+                    reject(err);
+                });
+    
+                stream.on('end', () => {
+                    resolve();
+                });
+                stream.pipe(res, { end: false });
+            });
+        }
+        
+    }
+}

package/templates/file-service/src/home-controller.ts

@@ -0,0 +1,11 @@
+import { Controller, Get, Text } from '@celljs/mvc/lib/node';
+
+@Controller()
+export class HomeController {
+    
+    @Get()
+    @Text()
+    home(): string {
+        return 'Welcome to Cell';
+    }
+}

package/templates/file-service/src/module.ts

@@ -0,0 +1,5 @@
+import './home-controller';
+import './file-controller';
+import { autoBind } from '@celljs/core';
+
+export default autoBind();

package/templates/file-service/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noImplicitAny": true,
+    "noEmitOnError": false,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "strictNullChecks": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "downlevelIteration": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "jsx": "react",
+    "target": "ES2017",
+    "lib": [
+      "ES2017",
+      "dom"
+    ],
+    "sourceMap": true,
+    "rootDir": "src",
+    "outDir": "lib"
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/jwt-app/.github/workflows/deploy.yml

@@ -0,0 +1,25 @@
+name: Cell Deploy
+
+on: push
+
+jobs:
+  cell-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup node
+        uses: actions/setup-node@v1
+        with:
+          node-version: '12'
+      - uses: bahmutov/npm-install@v1
+      - run: npm run lint --if-present
+      - run: npm test
+      - if: ${{ github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' }}
+        env: ${{ secrets }}
+        run: npx cell deploy -m prod
+      - if: ${{ github.ref == 'refs/heads/pre' }}
+        env: ${{ secrets }}
+        run: npx cell deploy -m pre
+      - if: ${{ github.ref != 'refs/heads/master' && github.ref == 'refs/heads/main' && github.ref != 'refs/heads/pre' }}
+        env: ${{ secrets }}
+        run: npx cell deploy -m test

package/templates/jwt-app/.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Cell Debug",
+            "request": "launch",
+            "runtimeArgs": [
+                "cell",
+                "serve"
+            ],
+            "runtimeExecutable": "npx",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "env": {
+                "NODE_ENV": "development"
+            },
+            "internalConsoleOptions": "openOnSessionStart",
+            "outputCapture": "std",
+            "type": "pwa-node"
+        }
+    ]
+}

package/templates/jwt-app/README.md

@@ -0,0 +1,92 @@
+# 开发说明
+
+## 安装依赖
+
+以下使用 yarn 工具来说明，你也可以使用 npm。
+
+```bash
+# 通过 cell init 初始化应用的时候已经自动安装了依赖，所以你只需要安装你额外需要的依赖即可
+
+$ yarn add xxxx
+```
+
+## 本地运行
+
+```shell
+# 启动本地服务，端口默认 3000
+# 在终端中会输出本地服务的 URL 链接
+
+$ yarn start  # 或者执行 cell serve 命令
+```
+
+## 构建部署
+
+模板默认提供了四套隔离环境：本地（local）、测试（test）、预发（pre）、线上（prod）。每个环境对应着一个 cell 配置文件（可选），类似 cell-test.yml。而 cell.yml 文件一般用于放所有环境的公共配置。第一次部署的时候可能会提示你填写相关云厂商 ak 信息。如果是 Vercel 云平台的模板，会提示你需要登录到 Vercel 平台。你也可以在项目通过 .env 提供云厂商的 ak 信息。
+
+```bash
+
+$ cell deploy -m scf            # 部署到腾讯云函数测试环境
+$ cell deploy -m scf -m test    # 部署到腾讯云测试环境
+$ cell deploy -m scf -m pre     # 部署到腾讯云预发环境
+$ cell deploy -m scf -m prod    # 部署到腾讯云线上环境
+
+```
+
+## 关于 Cell Framework
+
+Cell 是基于 TypeScript 的 Serverless First、组件化、平台无关的渐进式应用框架。
+
+## 特征
+
+-   约定大于配置，零配置，开箱即用
+-   TypeScript 版 Spring Boot
+-   Serverless First
+-   平台不锁定
+-   支持前后端一体化，前端框架不锁定
+-   支持微服务
+-   组件化，渐进式
+-   命令行工具插件化
+-   依赖注入
+-   面向切面编程（AOP）
+-   集成了流行的 ORM 框架，使用装饰器声明式事务管理
+-   支持 OIDC 认证
+-   支持 OAuth2 授权
+-   使用 rxjs 管理状态
+-   提供 REST 和 RPC 两种接口风格
+
+Cell 名字由来：在我的家乡，谐音“吗啦咕”是小石头的意思，小石头堆砌起来可以建成高楼大厦、道路桥梁，而 Cell 组件编排可以实现千变万化的应用。
+
+## 快速开始
+
+```bash
+# 安装命令行工具
+npm install -g @celljs/cli
+
+# 初始化
+cell init -o project-name
+cd project-name            # 进入项目根目录
+
+# 运行
+cell serve
+
+# 部署
+cell deploy
+```
+
+[![Quick Start](https://asciinema.org/a/474104.svg)](https://asciinema.org/a/474104?speed=2.5&autoplay=1)
+
+### 文档
+
+-   [介绍](https://cell.cellbang.com/guide/%E4%BB%8B%E7%BB%8D)
+-   [创建第一个应用](https://cell.cellbang.com/guide/%E5%88%9B%E5%BB%BA%E7%AC%AC%E4%B8%80%E4%B8%AA%E5%BA%94%E7%94%A8)
+-   [命令行工具](https://cell.cellbang.com/guide/%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7)
+-   [控制器](https://cell.cellbang.com/guide/%E6%8E%A7%E5%88%B6%E5%99%A8)
+-   [数据库操作](https://cell.cellbang.com/guide/%E6%95%B0%E6%8D%AE%E5%BA%93typeorm)
+-   [微服务](https://cell.cellbang.com/dev/%E5%BE%AE%E6%9C%8D%E5%8A%A1)
+-   [认证与授权](https://cell.cellbang.com/guide/%E8%AE%A4%E8%AF%81%E4%B8%8E%E6%8E%88%E6%9D%83)
+-   [云平台适配](https://cell.cellbang.com/cloud/%E4%BA%91%E5%B9%B3%E5%8F%B0%E9%80%82%E9%85%8D)
+-   [依赖注入](https://cell.cellbang.com/guide/%E4%BE%9D%E8%B5%96%E6%B3%A8%E5%85%A5)
+-   [组件设计](https://cell.cellbang.com/guide/%E7%BB%84%E4%BB%B6%E8%AE%BE%E8%AE%A1)
+-   [前端架构](https://cell.cellbang.com/guide/%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84)
+-   [React 开发](https://cell.cellbang.com/dev/react)
+-   [前后端一体化开发](https://cell.cellbang.com/dev/%E5%89%8D%E5%90%8E%E7%AB%AF%E4%B8%80%E4%BD%93%E5%8C%96%E5%BC%80%E5%8F%91)

package/templates/jwt-app/cell.yml

@@ -0,0 +1,4 @@
+
+cell:
+  jwt:
+    secret: abcdefg

package/templates/jwt-app/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "jwt-app",
+  "keywords": [
+    "cell-component"
+  ],
+  "version": "0.0.0",
+  "license": "MIT",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@celljs/core": "{{ version }}",
+    "@celljs/http": "{{ version }}",
+    "@celljs/web": "{{ version }}",
+    "@celljs/mvc": "{{ version }}",
+    "@celljs/jwt": "{{ version }}"
+  },
+  "devDependencies": {
+    "@celljs/cli": "{{ version }}",
+    "@celljs/component": "{{ version }}",
+    "@celljs/testing": "{{ version }}",
+    "@types/supertest": "^2.0.12",
+    "supertest": "^6.2.4"
+  },
+  "scripts": {
+    "clean": "rimraf lib dist .cell",
+    "test": "cell-component test",
+    "build": "cell build",
+    "start": "cell serve",
+    "deploy": "cell deploy -m scf -m test",
+    "deploy:test": "cell deploy -m scf -m test",
+    "deploy:pre": "cell deploy -m scf -m pre",
+    "deploy:prod": "cell deploy -m scf -m prod"
+  }
+}

package/templates/jwt-app/src/context.ts

@@ -0,0 +1,16 @@
+import { Context, AttributeScope } from '@celljs/web/lib/node';
+export const CURRENT_SECURITY_CONTEXT_REQUEST_KEY = 'CurrentSecurityContextRequest';
+
+export interface Authentication {}
+
+export namespace SecurityContext {
+
+    export function getAuthentication(): Authentication {
+        return  Context.getAttr(CURRENT_SECURITY_CONTEXT_REQUEST_KEY, AttributeScope.Request);
+    }
+
+    export function setAuthentication(authentication: Authentication): void {
+        Context.setAttr(CURRENT_SECURITY_CONTEXT_REQUEST_KEY, authentication, AttributeScope.Request);
+    }
+
+}

package/templates/jwt-app/src/error-handler.ts

@@ -0,0 +1,30 @@
+import { AuthenticationError } from './error';
+import { ErrorHandler, Context, RedirectStrategy, DEFALUT_ERROR_HANDLER_PRIORITY } from '@celljs/web/lib/node';
+import { Component, Autowired } from '@celljs/core';
+import { HttpStatus, HttpHeaders, XML_HTTP_REQUEST } from '@celljs/http';
+
+@Component(ErrorHandler)
+export class AuthenticationErrorHandler implements ErrorHandler {
+
+    /**
+     * 优先级的值一定要大于默认 Error Handler 的优先级：DEFALUT_ERROR_HANDLER_PRIORITY，否则将永远不会被执行.
+     */
+    readonly priority: number = DEFALUT_ERROR_HANDLER_PRIORITY + 100;
+
+    @Autowired(RedirectStrategy)
+    protected readonly redirectStrategy: RedirectStrategy;
+
+    canHandle(ctx: Context, err: Error): Promise<boolean> {
+        return Promise.resolve(err instanceof AuthenticationError);
+    }
+
+    async handle(ctx: Context, err: AuthenticationError): Promise<void> {
+        if (ctx.request.get(HttpHeaders.X_REQUESTED_WITH) !== XML_HTTP_REQUEST) {
+            await this.redirectStrategy.send('/login');
+            ctx.response.end(err.message);
+        } else {
+            ctx.response.statusCode = HttpStatus.UNAUTHORIZED;
+            ctx.response.end(err.message);
+        }
+    }
+}

package/templates/jwt-app/src/error.ts

@@ -0,0 +1,4 @@
+import { CustomError } from '@celljs/core';
+
+export class AuthenticationError extends CustomError {}
+

package/templates/jwt-app/src/home-controller.ts

@@ -0,0 +1,23 @@
+import { Autowired } from '@celljs/core';
+import { JwtService } from '@celljs/jwt';
+import { Controller, Get, Text } from '@celljs/mvc/lib/node';
+
+@Controller()
+export class HomeController {
+
+    @Autowired(JwtService)
+    protected readonly jwtService: JwtService;
+    
+    @Get()
+    @Text()
+    home(): string {
+        return 'Welcome to Cell';
+    }
+
+    @Get('/login')
+    @Text()
+    login(): Promise<string> {
+        const token = this.jwtService.sign({ name: 'cell' });
+        return token;
+    }
+}

package/templates/jwt-app/src/index.ts

@@ -0,0 +1,5 @@
+export * from './context';
+export * from './error';
+export * from './jwt-middleware';
+export * from './home-controller';
+export * from './error-handler';

package/templates/jwt-app/src/jwt-middleware.ts

@@ -0,0 +1,36 @@
+import { Autowired, Component } from '@celljs/core';
+import { HttpHeaders } from '@celljs/http';
+import { Context, Middleware, HTTP_MIDDLEWARE_PRIORITY } from '@celljs/web/lib/node';
+import { AuthenticationError } from './error';
+import { JwtService } from '@celljs/jwt'
+import { SecurityContext } from './context';
+
+export const AUTHENTICATION_SCHEME_BEARER = 'Bearer';
+
+@Component(Middleware)
+export class JwtMiddleware implements Middleware {
+
+    @Autowired(JwtService)
+    protected readonly jwtService: JwtService;
+
+    async handle(ctx: Context, next: () => Promise<void>): Promise<void> {
+        const request = ctx.request;
+        let header = request.get(HttpHeaders.AUTHORIZATION) ?? '';
+        header = header.trim();
+
+        if (header.toLowerCase().startsWith(AUTHENTICATION_SCHEME_BEARER.toLowerCase())) {
+            const token = header.substring(7);
+            try {
+                const decoded = await this.jwtService.verify(token);
+                SecurityContext.setAuthentication(decoded);
+            } catch (error) {
+                throw new AuthenticationError('Authentication failed');
+            }
+        }
+        
+        await next();
+    }
+
+    priority: number = HTTP_MIDDLEWARE_PRIORITY - 10;
+
+}

package/templates/jwt-app/src/module.ts

@@ -0,0 +1,3 @@
+import './index';
+import { autoBind } from '@celljs/core';
+export default autoBind();

package/templates/jwt-app/test/home-controller.spec.ts

@@ -0,0 +1,16 @@
+import { Test } from '@celljs/testing';
+import * as request from 'supertest';
+
+describe('HomeController (e2e)', function () {
+    let server: string;
+
+    before(async function () {
+        this.timeout(20000);
+        server = await Test.createHttpServer();
+    });
+
+    it('/ (GET)', () => request(server)
+        .get('/')
+        .expect(200)
+        .expect('Welcome to Cell'));
+});

package/templates/jwt-app/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noImplicitAny": true,
+    "noEmitOnError": false,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "strictNullChecks": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "downlevelIteration": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "jsx": "react",
+    "target": "ES2017",
+    "lib": [
+      "ES2017",
+      "dom"
+    ],
+    "sourceMap": true,
+    "rootDir": "src",
+    "outDir": "lib"
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/koa-app/app.js

@@ -0,0 +1,8 @@
+const Koa = require('koa');
+const app = new Koa();
+
+app.use(async ctx => {
+  ctx.body = 'Hello World';
+});
+
+module.exports = app;

package/templates/koa-app/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "koa-app",
+  "version": "1.0.0",
+  "description": "",
+  "main": "app.js",
+  "dependencies": {
+    "koa": "^2.13.4"
+  }
+}

package/templates/microservice/.github/workflows/deploy.yml

@@ -0,0 +1,28 @@
+name: Cell Deploy
+
+on: push
+
+jobs:
+  cell-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup node
+        uses: actions/setup-node@v1
+        with:
+          node-version: '12'
+      - uses: bahmutov/npm-install@v1
+      - run: npm run lint --if-present
+      - run: npm test
+      - if: ${{ github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' }}
+        env: ${{ secrets }}
+        working-directory: examples/backend-app
+        run: npx cell deploy -m prod
+      - if: ${{ github.ref == 'refs/heads/pre' }}
+        env: ${{ secrets }}
+        working-directory: examples/backend-app
+        run: npx cell deploy -m pre
+      - if: ${{ github.ref != 'refs/heads/master' && github.ref == 'refs/heads/main' && github.ref != 'refs/heads/pre' }}
+        env: ${{ secrets }}
+        working-directory: examples/backend-app
+        run: npx cell deploy -m test

package/templates/microservice/.vscode/launch.json

@@ -0,0 +1,24 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Cell Debug",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/examples/backend-app",
+            "runtimeArgs": [
+                "cell",
+                "serve"
+            ],
+            "runtimeExecutable": "npx",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "env": {
+                "NODE_ENV": "development"
+            },
+            "internalConsoleOptions": "openOnSessionStart",
+            "outputCapture": "std",
+            "type": "pwa-node"
+        }
+    ]
+}

package/templates/microservice/README.md

@@ -0,0 +1,92 @@
+# 开发说明
+
+## 安装依赖
+
+以下使用 yarn 工具来说明，你也可以使用 npm。
+
+```bash
+# 通过 cell init 初始化应用的时候已经自动安装了依赖，所以你只需要安装你额外需要的依赖即可
+
+$ yarn add xxxx
+```
+
+## 本地运行
+
+```shell
+# 启动本地服务，端口默认 3000
+# 在终端中会输出本地服务的 URL 链接
+
+$ yarn start  # 或者执行 cell serve 命令
+```
+
+## 构建部署
+
+模板默认提供了四套隔离环境：本地（local）、测试（test）、预发（pre）、线上（prod）。每个环境对应着一个 cell 配置文件（可选），类似 cell-test.yml。而 cell.yml 文件一般用于放所有环境的公共配置。第一次部署的时候可能会提示你填写相关云厂商 ak 信息。如果是 Vercel 云平台的模板，会提示你需要登录到 Vercel 平台。你也可以在项目通过 .env 提供云厂商的 ak 信息。
+
+```bash
+
+$ cell deploy -m scf            # 部署到腾讯云函数测试环境
+$ cell deploy -m scf -m test    # 部署到腾讯云测试环境
+$ cell deploy -m scf -m pre     # 部署到腾讯云预发环境
+$ cell deploy -m scf -m prod    # 部署到腾讯云线上环境
+
+```
+
+## 关于 Cell Framework
+
+Cell 是基于 TypeScript 的 Serverless First、组件化、平台无关的渐进式应用框架。
+
+## 特征
+
+-   约定大于配置，零配置，开箱即用
+-   TypeScript 版 Spring Boot
+-   Serverless First
+-   平台不锁定
+-   支持前后端一体化，前端框架不锁定
+-   支持微服务
+-   组件化，渐进式
+-   命令行工具插件化
+-   依赖注入
+-   面向切面编程（AOP）
+-   集成了流行的 ORM 框架，使用装饰器声明式事务管理
+-   支持 OIDC 认证
+-   支持 OAuth2 授权
+-   使用 rxjs 管理状态
+-   提供 REST 和 RPC 两种接口风格
+
+Cell 名字由来：在我的家乡，谐音“吗啦咕”是小石头的意思，小石头堆砌起来可以建成高楼大厦、道路桥梁，而 Cell 组件编排可以实现千变万化的应用。
+
+## 快速开始
+
+```bash
+# 安装命令行工具
+npm install -g @celljs/cli
+
+# 初始化
+cell init -o project-name
+cd project-name            # 进入项目根目录
+
+# 运行
+cell serve
+
+# 部署
+cell deploy
+```
+
+[![Quick Start](https://asciinema.org/a/474104.svg)](https://asciinema.org/a/474104?speed=2.5&autoplay=1)
+
+### 文档
+
+-   [介绍](https://cell.cellbang.com/guide/%E4%BB%8B%E7%BB%8D)
+-   [创建第一个应用](https://cell.cellbang.com/guide/%E5%88%9B%E5%BB%BA%E7%AC%AC%E4%B8%80%E4%B8%AA%E5%BA%94%E7%94%A8)
+-   [命令行工具](https://cell.cellbang.com/guide/%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7)
+-   [控制器](https://cell.cellbang.com/guide/%E6%8E%A7%E5%88%B6%E5%99%A8)
+-   [数据库操作](https://cell.cellbang.com/guide/%E6%95%B0%E6%8D%AE%E5%BA%93typeorm)
+-   [微服务](https://cell.cellbang.com/dev/%E5%BE%AE%E6%9C%8D%E5%8A%A1)
+-   [认证与授权](https://cell.cellbang.com/guide/%E8%AE%A4%E8%AF%81%E4%B8%8E%E6%8E%88%E6%9D%83)
+-   [云平台适配](https://cell.cellbang.com/cloud/%E4%BA%91%E5%B9%B3%E5%8F%B0%E9%80%82%E9%85%8D)
+-   [依赖注入](https://cell.cellbang.com/guide/%E4%BE%9D%E8%B5%96%E6%B3%A8%E5%85%A5)
+-   [组件设计](https://cell.cellbang.com/guide/%E7%BB%84%E4%BB%B6%E8%AE%BE%E8%AE%A1)
+-   [前端架构](https://cell.cellbang.com/guide/%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84)
+-   [React 开发](https://cell.cellbang.com/dev/react)
+-   [前后端一体化开发](https://cell.cellbang.com/dev/%E5%89%8D%E5%90%8E%E7%AB%AF%E4%B8%80%E4%BD%93%E5%8C%96%E5%BC%80%E5%8F%91)