@celljs/cli 3.0.0

package/templates/accounts/src/node/entity/user.ts

@@ -0,0 +1,73 @@
+import { Entity, Column } from 'typeorm';
+import { Exclude } from 'class-transformer';
+import { BaseEntity } from './base-entity';
+
+@Entity()
+export class Identity extends BaseEntity {
+
+    @Column()
+    userId: number;
+
+    @Column()
+    provider: string;
+
+    @Column()
+    connection: string;
+
+    @Column()
+    isSocial: boolean;
+
+    @Column()
+    identifier: string;
+
+}
+
+@Entity()
+export class User extends BaseEntity {
+
+    @Column({ length: 256, nullable: true })
+    email?: string;
+
+    @Column({ default: false })
+    emailVerified: boolean;
+
+    @Column({ length: 128, nullable: true })
+    username?: string;
+
+    @Column({ length: 64, nullable: true })
+    phoneNumber?: string;
+
+    @Column({ default: false })
+    phoneVerified: boolean;
+
+    @Column({ length: 512, nullable: true  })
+    appMetadata?: string;
+
+    @Column({ length: 512, nullable: true })
+    userMetadata?: string;
+
+    @Column({ length: 512, nullable: true })
+    picture?: string;
+
+    @Column({ length: 64, nullable: true  })
+    nickname?: string;
+
+    @Column({ nullable: true })
+    multifactor?: string;
+
+    @Column({ length: 32, nullable: true })
+    lastIp?: string;
+
+    @Column({ nullable: true })
+    lastLogin?: Date;
+
+    @Column({ default: 0 })
+    loginsCount: number;
+
+    @Column({ default: false })
+    blocked: boolean;
+
+    @Column({ length: 256, nullable: true })
+    @Exclude()
+    password!: string;
+}

package/templates/accounts/src/node/error/error.ts

@@ -0,0 +1,14 @@
+import { CustomError } from '@celljs/core';
+
+export class UserNotFoundError extends CustomError {
+    constructor(public userIdOrEmail: number | string) {
+        super(`No user found: ${userIdOrEmail}`);
+    }
+}
+
+export class IdentityNotFoundError extends CustomError {
+
+    constructor(public identity: number, public provider: string) {
+        super(`No identity found: ${provider}(${identity})`);
+    }
+}

package/templates/accounts/src/node/error/index.ts

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

package/templates/accounts/src/node/index.ts

@@ -0,0 +1,2 @@
+export * from './authentication';
+export * from './user';

package/templates/accounts/src/node/module.ts

@@ -0,0 +1,9 @@
+
+import { autoBind } from '@celljs/core';
+import { autoBindEntities } from '@celljs/typeorm';
+import * as entities from './entity';
+import './index';
+
+autoBindEntities(entities);
+
+export default autoBind();

package/templates/accounts/src/node/user/index.ts

@@ -0,0 +1,4 @@
+export * from './user-service';
+export * from './user-protocol';
+export * from './user-repository';
+

package/templates/accounts/src/node/user/user-protocol.ts

@@ -0,0 +1,19 @@
+import { Identity, User } from '../entity';
+export const UserRepository = Symbol('UserRepository');
+
+export interface UserRepository {
+
+    getByConnectionAndIdentifier(connection: string, identity: string): Promise<User | null>;
+
+    getByEmail(email: string): Promise<User | null>;
+
+    getByUsername(username: string): Promise<User | null>;
+
+    get(id: number): Promise<User | null>;
+
+    update(user: User): Promise<User>;
+
+    create(user: User, identity: Identity): Promise<User>;
+
+}
+

package/templates/accounts/src/node/user/user-repository.ts

@@ -0,0 +1,72 @@
+import { Component } from '@celljs/core';
+import { Transactional, OrmContext } from '@celljs/typeorm/lib/node';
+import { Identity, User } from '../entity';
+import { UserNotFoundError } from '../error';
+import { plainToClassFromExist, classToPlain } from 'class-transformer';
+import { UserRepository } from './user-protocol';
+
+@Component(UserRepository)
+export class UserRepositoryImpl implements UserRepository {
+
+    @Transactional({ readOnly: true })
+    getByConnectionAndIdentifier(connection: string, identifier: string): Promise<User | null> {
+        const repo = OrmContext.getRepository(User);
+
+        const identityQb = OrmContext.getRepository(Identity).createQueryBuilder('identity')
+            .select('identity.userId')
+            .where('identity.identifier = :identifier and identity.connection = :connection', { connection, identifier });
+        return repo.createQueryBuilder('user')
+            .where(`user.id IN (${identityQb.getQuery()})`)
+            .setParameters(identityQb.getParameters())
+            .getOne();
+
+    }
+
+    @Transactional({ readOnly: true })
+    getByEmail(email: string): Promise<User | null> {
+        const repo = OrmContext.getRepository(User);
+        return repo.createQueryBuilder('user')
+            .where('user.email = :email', { email })
+            .getOne();
+    }
+
+    @Transactional({ readOnly: true })
+    getByUsername(username: string): Promise<User | null> {
+        const repo = OrmContext.getRepository(User);
+        return repo.createQueryBuilder('user')
+            .where('user.username = :email', { username })
+            .getOne();
+    }
+
+    @Transactional({ readOnly: true })
+    async get(id: number): Promise<User> {
+        const repo = OrmContext.getRepository(User);
+        const user = await repo.findOneBy({ id });
+        if (user) {
+            return user;
+        }
+        throw new UserNotFoundError(id);
+    }
+
+    @Transactional()
+    async update(user: User): Promise<User> {
+        const repo = OrmContext.getRepository(User);
+        const oldUser = await repo.findOneBy({ id: user.id });
+        if (oldUser) {
+            const newUser = plainToClassFromExist(oldUser, classToPlain(user));
+            return repo.save(newUser);
+        }
+        throw new UserNotFoundError(user.id);
+    }
+
+    @Transactional()
+    async create(user: User, identity: Identity): Promise<User> {
+        const userRepo = OrmContext.getRepository(User);
+        const identityRepo = OrmContext.getRepository(Identity);
+        const newUser = await userRepo.save(user);
+        identity.userId = newUser.id;
+        await identityRepo.save(identity);
+        return newUser;
+    }
+
+}

package/templates/accounts/src/node/user/user-service.ts

@@ -0,0 +1,36 @@
+import { UserService, UsernameNotFoundError } from '@celljs/security/lib/node';
+import { Value, Component, Autowired } from '@celljs/core';
+import { User, UserType } from '@celljs/security';
+import { UserRepository } from './user-protocol';
+
+@Component({ id: UserService, rebind: true })
+export class DatabaseUserService implements UserService<string, User> {
+
+    @Value('cell.security')
+    protected readonly options: any;
+
+    @Autowired(UserRepository)
+    protected userRepository: UserRepository;
+
+    async load(username: string): Promise<User> {
+        const userEntity = await this.userRepository.getByUsername(username);
+        if (userEntity) {
+            return {
+                type: UserType.Database,
+                username: userEntity.id + '',
+                password: userEntity.password,
+                login: userEntity.username,
+                avatar: userEntity.picture,
+                email: userEntity.email,
+                nickname: userEntity.nickname,
+                accountNonExpired: true,
+                accountNonLocked: true,
+                credentialsNonExpired: true,
+                enabled: !userEntity.blocked,
+                policies: []
+            };
+        }
+
+        throw new UsernameNotFoundError(`Could not find: ${username}`);
+    }
+}

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

@@ -0,0 +1,7 @@
+cell: 
+  typeorm:
+    ormConfig:
+      - type: better-sqlite3
+        database: mydb.sql
+        synchronize: true
+        logging: true

package/templates/admin-app/cell.yml

@@ -0,0 +1,93 @@
+# 依赖的公共前端 UI 框从 CDN 上加载
+# mode: cdn
+mode: [ database ]
+cell:
+  security:
+    loginRequired: false
+  shell:
+    categories:
+      appCenter:
+        name: 应用中心
+    apps:
+      authentication:
+        name: 云认证
+        icon: Shield
+        categoryId: appCenter
+      accessControl:
+        name: 云授权
+        icon: Validate
+        categoryId: appCenter
+      development:
+        name: 云开发
+        icon: Code
+        categoryId: appCenter
+      configuration:
+        name: 云配置
+        icon: SettingsOption
+        categoryId: appCenter
+      monitor:
+        name: 云监控
+        icon: Monitor
+        categoryId: appCenter
+  widget:
+    widgets:
+      test:
+        type: NavItem
+        area: Nav
+        props:
+          path: /users
+          icon: Group
+          label: 用户管理
+      test2:
+        type: NavItem
+        area: Nav
+        props:
+          path: /depts
+          icon: Organization
+          label: 部门管理
+      test3:
+        type: NavItem
+        area: Nav
+        props:
+          path: /dictionaries
+          icon: Catalog
+          label: 字典管理
+      test4:
+        type: NavItem
+        area: Nav
+        props:
+          path: /menus
+          icon: List
+          label: 菜单管理
+  themes:
+    default:
+      label: 黑色
+      props:
+        global:
+          colors:
+            brand: '#000000'
+    blue:
+      label: 蓝色
+      props:
+        global:
+            colors:
+              brand: '#7D4CDB'
+    green:
+      label: 绿色
+      props:
+        global:
+          colors:
+            brand: '#00C781'
+    yellow:
+      label: 黄色
+      props:
+        global:
+          colors:
+            brand: '#FFCA58'
+    red:
+      label: 红色
+      props:
+        global:
+          colors:
+            brand: '#FF4040'
+

package/templates/admin-app/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "admin-app",
+  "keywords": [
+    "cell-component"
+  ],
+  "version": "0.0.0",
+  "license": "MIT",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@celljs/core": "{{ version }}",
+    "@celljs/react": "{{ version }}",
+    "@celljs/rpc": "{{ version }}",
+    "@celljs/security": "{{ version }}",
+    "@celljs/serve-static": "{{ version }}",
+    "@celljs/shell": "{{ version }}",
+    "@celljs/typeorm": "{{ version }}",
+    "better-sqlite3": "^7.6.2",
+    "react": "^18.2.0",
+    "grommet": "^2.25.1",
+    "typeorm": "^0.3.7"
+  },
+  "devDependencies": {
+    "@celljs/cli": "{{ version }}"
+  },
+  "scripts": {
+    "clean": "rimraf lib dist .cell",
+    "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/admin-app/src/browser/module.ts

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

package/templates/admin-app/src/browser/user.view.tsx

@@ -0,0 +1,40 @@
+import * as React from 'react';
+import { View } from '@celljs/react';
+import { RpcUtil } from '@celljs/rpc';
+import { DataTable } from 'grommet';
+import { UserService, User } from '../common';
+
+function Users() {
+
+    const [ data, setData ] = React.useState<User[]>([]);
+
+    React.useEffect(() => {
+        const userService = RpcUtil.get<UserService>(UserService);
+        userService.list().then(users => setData(users))
+
+    }, [])
+    
+    return (
+        <DataTable
+            margin={{ vertical: 'medium' }}
+            columns={[
+                {
+                    property: 'name',
+                    header: 'Name',
+                    primary: true
+                },
+                {
+                    property: 'age',
+                    header: 'Age'
+                }
+            ]}
+            data={data}
+        >
+
+        </DataTable>
+    );
+}
+
+@View({ index: true, component: Users})
+@View({ path: 'users', component: Users})
+export default class {}

package/templates/admin-app/src/common/index.ts

@@ -0,0 +1 @@
+export * from './user-protocol';

package/templates/admin-app/src/common/user-protocol.ts

@@ -0,0 +1,23 @@
+export const UserService = Symbol('UserService');
+
+export interface UserService {
+
+    list(): Promise<User[]>;
+
+    get(id: number): Promise<User | null>;
+
+    remove(id: number): Promise<void>
+
+    modify(user: User): Promise<void>;
+
+    create(user: User): Promise<User>;
+}
+
+export interface User {
+    
+    id: number;
+
+    name: string;
+
+    age: number;
+}

package/templates/admin-app/src/node/entity/index.ts

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

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

@@ -0,0 +1,15 @@
+import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
+import { User as IUser } from '../../common';
+
+@Entity()
+export class User implements IUser {
+    
+    @PrimaryGeneratedColumn()
+    id: number;
+
+    @Column()
+    name: string;
+
+    @Column()
+    age: number;
+}

package/templates/admin-app/src/node/module.ts

@@ -0,0 +1,8 @@
+import './user-service';
+import * as entities from './entity';
+import { autoBind } from '@celljs/core';
+import { autoBindEntities } from '@celljs/typeorm';
+
+autoBindEntities(entities)
+
+export default autoBind();