koatty 4.3.3 → 5.0.0

package/examples/README.md

@@ -1,172 +0,0 @@
-# Koatty Examples
-
-这个目录包含了Koatty框架的各种示例应用，帮助你快速上手和理解框架的使用方法。
-
-## 📚 示例列表
-
-### 🟢 basic-app - 基础应用示例
-
-完整的基础应用示例，展示Koatty框架的核心功能。
-
-**功能特性**:
-- ✅ HTTP路由和控制器
-- ✅ 中间件使用
-- ✅ 服务层和依赖注入
-- ✅ 数据验证（DTO）
-- ✅ 异常处理
-- ✅ AOP切面编程
-- ✅ 静态资源服务
-- ✅ 视图模板
-
-**查看详情**: [basic-app/README.md](./basic-app/README.md)
-
----
-
-### 🔵 graphql-app - GraphQL应用示例 (规划中)
-
-展示如何使用Koatty构建GraphQL API。
-
-**功能特性**:
-- GraphQL Schema定义
-- Resolver实现
-- GraphiQL调试界面
-- DataLoader优化
-
----
-
-### 🟣 grpc-app - gRPC应用示例 (规划中)
-
-展示如何使用Koatty构建gRPC服务。
-
-**功能特性**:
-- Protocol Buffers定义
-- gRPC服务实现
-- 双向流通信
-- 健康检查
-
----
-
-### 🟡 microservices - 微服务示例 (规划中)
-
-展示如何使用Koatty构建微服务架构。
-
-**功能特性**:
-- 服务发现
-- 负载均衡
-- 熔断降级
-- 分布式追踪
-
----
-
-## 🚀 快速开始
-
-### 1. 克隆仓库
-
-```bash
-git clone https://github.com/koatty/koatty-monorepo.git
-cd koatty-monorepo
-```
-
-### 2. 安装依赖
-
-```bash
-pnpm install
-```
-
-### 3. 运行示例
-
-```bash
-# 运行基础应用示例
-cd examples/basic-app
-pnpm dev
-```
-
-### 4. 使用VS Code调试
-
-按 `F5` 启动调试，选择对应的调试配置。
-
----
-
-## 📋 通用要求
-
-所有示例都需要：
-
-- **Node.js**: >= 18.0.0
-- **pnpm**: >= 8.0.0
-
----
-
-## 🏗️ 项目结构
-
-```
-examples/
-├── basic-app/              # 基础应用示例
-│   ├── src/               # 源代码
-│   ├── static/            # 静态资源
-│   ├── view/              # 视图模板
-│   ├── package.json       # 依赖配置
-│   ├── tsconfig.json      # TypeScript配置
-│   └── README.md          # 示例说明
-├── graphql-app/           # GraphQL示例 (规划中)
-├── grpc-app/              # gRPC示例 (规划中)
-├── microservices/         # 微服务示例 (规划中)
-└── README.md              # 本文件
-```
-
----
-
-## 📝 贡献示例
-
-欢迎贡献新的示例！请遵循以下规范：
-
-### 示例结构
-
-```
-your-example/
-├── src/                   # 源代码
-├── package.json           # 必须使用workspace依赖
-├── tsconfig.json          # TypeScript配置
-└── README.md              # 详细说明
-```
-
-### package.json规范
-
-```json
-{
-  "name": "@koatty/example-your-name",
-  "version": "1.0.0",
-  "private": true,
-  "dependencies": {
-    "koatty": "workspace:*"
-  }
-}
-```
-
-### README规范
-
-每个示例必须包含：
-1. 功能描述
-2. 项目结构
-3. 快速开始指南
-4. API示例
-5. 相关链接
-
----
-
-## 🔗 相关链接
-
-- [Koatty主项目](https://github.com/koatty/koatty)
-- [Koatty文档](https://koatty.github.io/)
-- [API文档](https://koatty.github.io/api/)
-- [问题反馈](https://github.com/koatty/koatty/issues)
-
----
-
-## 📄 许可证
-
-所有示例代码均采用 BSD-3-Clause 许可证。
-
----
-
-**享受使用Koatty构建应用！** 🚀
-

package/examples/basic-app/README.md

@@ -1,72 +0,0 @@
-# Koatty Basic Application Example
-
-这是一个基本的 Koatty 应用示例,位于 `packages/koatty/examples/basic-app` 目录下。
-
-## 目录结构
-
-```
-packages/koatty/examples/basic-app/
-├── src/
-│   ├── App.ts              # 应用入口
-│   ├── bootstrap/          # 启动引导
-│   ├── controller/         # 控制器
-│   ├── service/            # 服务层
-│   ├── middleware/         # 中间件
-│   ├── dto/                # 数据传输对象
-│   ├── aspect/             # 切面
-│   ├── plugin/             # 插件
-│   └── config/             # 配置文件
-├── package.json
-└── tsconfig.json
-```
-
-## 安装依赖
-
-```bash
-cd packages/koatty/examples/basic-app
-pnpm install
-```
-
-## 运行
-
-### 开发模式
-
-```bash
-pnpm run dev
-```
-
-### VSCode 调试
-
-1. 在 VSCode 中打开项目根目录
-2. 按 F5 或点击调试面板中的 "Koatty Demo Program"
-3. 可以在 `packages/koatty/src` 目录下的源码中设置断点进行调试
-
-## 导入说明
-
-由于示例项目位于 `packages/koatty/examples/basic-app` 下,使用相对路径导入 Koatty 框架:
-
-```typescript
-// 导入 Koatty 核心功能
-import { Bootstrap } from "../../../src";
-import { Koatty } from "../../../../koatty-core/src";
-import { AppEvent, KoattyApplication } from "../../../../../koatty-core/src";
-```
-
-这样可以直接调试框架源码,无需编译。
-
-## 配置文件
-
-配置文件位于 `src/config/` 目录:
-
-- `config.ts` - 主配置文件
-- `router.ts` - 路由配置
-- `middleware.ts` - 中间件配置
-- `plugin.ts` - 插件配置
-- `db.ts` - 数据库配置
-
-## 项目特点
-
-- ✅ 支持 TypeScript 源码级调试
-- ✅ 使用相对路径直接引用框架源码
-- ✅ 完整的 MVC 架构示例
-- ✅ 包含控制器、服务、中间件、切面等示例代码

package/examples/basic-app/package.json

@@ -1,23 +0,0 @@
-{
-  "name": "@koatty/example-basic-app",
-  "version": "1.0.0",
-  "description": "Koatty framework basic application example",
-  "private": true,
-  "main": "src/App.ts",
-  "keywords": [
-    "koatty",
-    "example",
-    "demo"
-  ],
-  "author": "richenlin",
-  "license": "BSD-3-Clause",
-  "scripts": {
-    "dev": "node --nolazy -r ts-node/register ./src/App.ts"
-  },
-  "devDependencies": {
-    "@types/node": "^25.1.0",
-    "ts-node": "^10.x.x",
-    "tsconfig-paths": "^4.x.x",
-    "typescript": "^5.x.x"
-  }
-}

package/examples/basic-app/pnpm-workspace.yaml

@@ -1,4 +0,0 @@
-# This file ensures pnpm treats this as a standalone workspace
-packages:
-  - '.'
-

package/examples/basic-app/resource/data.json

@@ -1,2 +0,0 @@
-// 静态、不需要编译的数据配置
-// 例如：白名单、配置等

package/examples/basic-app/resource/graphql/User.graphql

@@ -1,22 +0,0 @@
-type Query {
-  getUser(id: ID!, username: String): User!
-}
-
-type Mutation {
-  createUser(input: UserInput!): User!
-}
-
-type User {
-  id: ID!
-  username: String!
-  email: String!
-  phoneNum: String!
-  createdAt: String!
-}
-
-input UserInput {
-  id: ID!
-  username: String!
-  email: String!
-  password: String!
-}

package/examples/basic-app/resource/proto/hello.proto

@@ -1,19 +0,0 @@
-syntax = "proto3";
-
-service Hello {
-  rpc SayHello(SayHelloRequest) returns (SayHelloReply) {}
-}
-
-message SayHelloRequest {
-  uint64 id = 1;
-  string name = 2;
-  PhoneType phone = 3;
-}
-
-message SayHelloReply { string message = 1; }
-
-enum PhoneType {
-  MOBILE = 0; // proto3版本中，首成员必须为0，成员不应有相同的值
-  HOME = 1;
-  WORK = 2;
-}

package/examples/basic-app/test-app.js

@@ -1,28 +0,0 @@
-const path = require('path');
-process.env.UV_THREADPOOL_SIZE = '128';
-process.env.TS_NODE_TRANSPILE_ONLY = 'true';
-process.env.TS_NODE_PROJECT = './tsconfig.json';
-
-console.log('🔍 Starting application test...');
-console.log('Node version:', process.version);
-console.log('');
-
-require('ts-node/register');
-
-try {
-  console.log('📦 Loading App module...');
-  const appModule = require('./src/App.ts');
-  console.log('✅ App module loaded:', Object.keys(appModule));
-  console.log('');
-  console.log('🎯 Bootstrap decorator should have executed');
-  console.log('');
-  
-  // Keep process alive
-  setTimeout(() => {
-    console.log('⏱️  5 seconds passed, exiting');
-    process.exit(0);
-  }, 5000);
-} catch (err) {
-  console.error('❌ Error:', err);
-  process.exit(1);
-}

package/examples/basic-app/test-logger.js

@@ -1,19 +0,0 @@
-const path = require('path');
-process.env.TS_NODE_TRANSPILE_ONLY = 'true';
-require('ts-node/register');
-
-console.log('Testing Logger.Fatal...\n');
-
-const { Logger } = require('../../src/util/Logger');
-
-console.log('Logger methods:', Object.getOwnPropertyNames(Object.getPrototypeOf(Logger)).filter(m => m.includes('atal')));
-console.log('');
-
-console.log('Calling Logger.Fatal with test error...');
-try {
-  Logger.Fatal(new Error('Test fatal error'));
-} catch (e) {
-  console.error('Caught:', e);
-}
-
-console.log('This line should not execute if Fatal calls process.exit');

package/examples/basic-app/test-simple.ts

@@ -1,13 +0,0 @@
-import { Bootstrap, Koatty } from "koatty";
-
-@Bootstrap(() => {
-  console.log("Bootstrap function called");
-})
-export class TestApp extends Koatty {
-  public init() {
-    console.log("Init method called");
-    this.appDebug = true;
-  }
-}
-
-console.log("File loaded");

package/examples/basic-app/view/index.html

@@ -1,25 +0,0 @@
-<!--
- * @Description: 
- * @Usage: 
- * @Author: richen
- * @Date: 2020-12-22 15:57:16
- * @LastEditTime: 2022-03-15 14:23:33
--->
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>
-    <%=title%>
-  </title>
-</head>
-
-<body>
-  <H1>
-    <%=content%>
-  </H1>
-</body>
-
-</html>

package/tsconfig.test.json

@@ -1,16 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "useDefineForClassFields": false,
-    "types": [
-      "jest",
-      "node"
-    ]
-  },
-  "exclude": [
-    "node_modules"
-  ],
-  "include": [
-    "test/*.test.ts"
-  ]
-}