@celljs/cli 3.0.0

package/templates/admin-app/src/node/user-service.ts

@@ -0,0 +1,41 @@
+import { Transactional, OrmContext } from '@celljs/typeorm/lib/node';
+import { Rpc } from '@celljs/rpc';
+import { Anonymous } from '@celljs/security/lib/node'
+import { User } from './entity';
+import { UserService } from '../common';
+
+@Rpc(UserService)
+@Anonymous()
+export class UserServiceImpl implements UserService {
+    
+    @Transactional({ readOnly: true })
+    list(): Promise<User[]> {
+        const repo = OrmContext.getRepository(User);
+        return repo.find();
+    }
+
+    @Transactional({ readOnly: true })
+    get(id: number): Promise<User | null> {
+        const repo = OrmContext.getRepository(User);
+        return repo.findOneBy({ id });
+    }
+
+    @Transactional()
+    async remove(id: number): Promise<void> {
+        const repo = OrmContext.getRepository(User);
+        await repo.delete(id);
+    }
+
+    @Transactional()
+    async modify(user: User): Promise<void> {
+        const repo = OrmContext.getRepository(User);
+        await repo.update(user.id, user);
+    }
+
+    @Transactional()
+    create(user: User): Promise<User> {
+        const repo = OrmContext.getRepository(User);
+        return repo.save(user);
+    }
+
+}

package/templates/admin-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/backend-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/backend-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/backend-app/README.md

@@ -0,0 +1,92 @@
+# 开发说明
+
+## 安装依赖
+
+以下使用 yarn 工具来说明，你也可以使用 npm。
+
+```bash
+# 通过 cell init 初始化应用的时候已经自动安装了依赖，所以你只需要安装你额外需要的依赖即可
+
+$ yarn add xxxx
+```
+
+## 本地运行
+
+```bash
+# 启动本地服务，端口默认 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/backend-app/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "backend-app",
+  "keywords": [
+    "cell-component"
+  ],
+  "version": "0.0.0",
+  "license": "MIT",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@celljs/core": "{{ version }}",
+    "@celljs/mvc": "{{ 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/backend-app/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/backend-app/src/module.ts

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

package/templates/backend-app/src/user-controller.ts

@@ -0,0 +1,48 @@
+import { Controller, Get, Param, Delete, Put, Post, Body } from '@celljs/mvc/lib/node';
+
+export interface User {
+    name: string;
+    age: number;
+}
+
+const users = [ { name: 'Tom', age: 20 }, { name: 'Alice', age: 23 }]
+
+@Controller('users')
+export class UserController {
+    
+    @Get()
+    list(): User[] {
+        return users;
+    }
+
+    @Get(':name')
+    get(@Param('name') name: string): User | undefined {
+        for (const user of users) {
+            if (user.name === name) {
+                return user;
+            }
+        }
+    }
+
+    @Delete(':name')
+    remove(@Param('name') name: string): void {
+        const index = users.findIndex(user => user.name === name);
+        if (index !== -1) {
+            users.splice(index, 1);
+        }
+    }
+
+    @Put()
+    modify(@Body() user: User): void {
+        const target = users.find(u => u.name == user.name);
+        if (target) { 
+            target.age = user.age;
+        }
+    }
+
+    @Post()
+    create(@Body() user: User): void {
+        users.push(user);
+    }
+
+}

package/templates/backend-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/backend-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/cell-component/.eslintrc.js

@@ -0,0 +1,10 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+    extends: [
+        require.resolve('@celljs/component/configs/build.eslintrc.json')
+    ],
+    parserOptions: {
+        tsconfigRootDir: __dirname,
+        project: 'tsconfig.json'
+    }
+};

package/templates/cell-component/README.md

@@ -0,0 +1,36 @@
+# Cell Component
+
+Cell 组件本质上是一个 npm 包，为了统一组件项目风格，Cell 提供了一个 `@celljs/component` 组件，帮助开发者标准化组件开发流程。`@celljs/component` 主要提供一套通用的配置，包括编译、代码风格检查、单元测试等配置，并且提供了相应的命令行工具 `cell-component`。
+
+## 代码风格检查
+
+```bash
+cell-component lint
+```
+
+## 代码构建
+
+```bash
+cell-component build
+```
+
+## Watch 代码
+
+```bash
+cell-component watch
+```
+
+## 代码测试
+
+```bash
+cell-component test
+```
+
+## 清理文件
+
+```bash
+cell-component clean
+```
+
+
+

package/templates/cell-component/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "cell-component",
+  "version": "0.0.0",
+  "description": "",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "dependencies": {
+    "@celljs/core": "{{ version }}"
+  },
+  "devDependencies": {
+    "@celljs/component": "{{ version }}"
+  },
+  "keywords": [
+    "cell-component"
+  ],
+  "license": "MIT",
+  "files": [
+    "lib",
+    "src",
+    "cell.yml"
+  ],
+  "scripts": {
+    "lint": "cell-component lint",
+    "build": "cell-component build",
+    "watch": "cell-component watch",
+    "clean": "cell-component clean",
+    "test": "cell-component test"
+  }
+}

package/templates/cell-component/src/echo-service.ts

@@ -0,0 +1,16 @@
+import { Component } from "@celljs/core";
+
+export const EchoService = Symbol('EchoService');
+
+export interface EchoService {
+    echo(text: string): string; 
+}
+
+@Component(EchoService)
+export class EchoServiceImpl implements EchoService {
+    echo(text: string): string {
+        return text;
+    }
+    
+}
+

package/templates/cell-component/src/index.ts

@@ -0,0 +1 @@
+export * from './echo-service';

package/templates/cell-component/src/module.ts

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

package/templates/cell-component/src/package.spec.ts

@@ -0,0 +1,4 @@
+describe('cell-component package', () => {
+
+    it('support code coverage statistics', () => {});
+});

package/templates/cell-component/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends":"@celljs/component/configs/base.tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": "src",
+    "outDir": "lib"
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/database-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/database-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/database-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/database-app/cell.yml

@@ -0,0 +1,17 @@
+cell: 
+  typeorm:
+    ormConfig:
+      - type: better-sqlite3
+        database: mydb.sql
+        synchronize: true
+        logging: true
+# cell:
+#   typeorm:
+#     ormConfig:
+#       - type: mysql
+#         host: localhost
+#         port: 3306
+#         synchronize: true
+#         username: root
+#         password: root
+#         database: test