feat: add http cookies (#235)

<!--
Thank you for your pull request. Please review below requirements.
Bug fixes and new features should include tests and possibly benchmarks.
Contributors guide:
https://github.com/eggjs/egg/blob/master/CONTRIBUTING.md

感谢您贡献代码。请确认下列 checklist 的完成情况。
Bug 修复和新功能必须包含测试，必要时请附上性能测试。
Contributors guide:
https://github.com/eggjs/egg/blob/master/CONTRIBUTING.md
-->

##### Checklist
<!-- Remove items that do not apply. For completed items, change [ ] to
[x]. -->

- [ ] `npm test` passes
- [ ] tests and/or benchmarks are included
- [ ] documentation is changed or added
- [ ] commit message follows commit guidelines

##### Affected core subsystem(s)
<!-- Provide affected core subsystem(s). -->


##### Description of change
<!-- Provide a description of the change below this comment. -->

<!--
- any feature?
- close https://github.com/eggjs/egg/ISSUE_URL
-->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit


- **New Features**
- Introduced a new `Cookies` decorator for handling HTTP cookie
parameters.
	- Added a new class `HTTPCookies` for enhanced cookie management.
	- Expanded HTTP parameter handling to include cookies.

- **Bug Fixes**
	- Improved robustness in cookie handling within HTTP requests.

- **Tests**
	- Enhanced test cases to validate cookie handling in HTTP requests.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: akitaSummer

core/controller-decorator/package.json

@@ -39,6 +39,7 @@
   "dependencies": {
     "@eggjs/aop-decorator": "^3.42.0",
     "@eggjs/core-decorator": "^3.42.0",
+    "@eggjs/cookies": "^3.0.1",
     "@eggjs/tegg-common-util": "^3.42.0",
     "@eggjs/tegg-metadata": "^3.42.0",
     "@eggjs/tegg-types": "^3.42.0",

core/controller-decorator/src/decorator/http/HTTPParam.ts

@@ -79,3 +79,13 @@ export function Request() {
     HTTPInfoUtil.setHTTPMethodParamType(HTTPParamType.REQUEST, parameterIndex, controllerClazz, methodName);
   };
 }
+
+export function Cookies() {
+  return function(target: any, propertyKey: PropertyKey, parameterIndex: number) {
+    assert(typeof propertyKey === 'string',
+      `[controller/${target.name}] expect method name be typeof string, but now is ${String(propertyKey)}`);
+    const methodName = propertyKey as string;
+    const controllerClazz = target.constructor as EggProtoImplClass;
+    HTTPInfoUtil.setHTTPMethodParamType(HTTPParamType.COOKIES, parameterIndex, controllerClazz, methodName);
+  };
+}

core/controller-decorator/src/model/HTTPCookies.ts

@@ -0,0 +1,2 @@
+import { Cookies } from '@eggjs/cookies';
+export class HTTPCookies extends Cookies {}

core/controller-decorator/src/model/HTTPMethodMeta.ts

@@ -78,6 +78,15 @@ export class PathParamMeta extends ParamMeta {
   }
 }
 
+export class CookiesParamMeta extends ParamMeta {
+  type = HTTPParamType.COOKIES;
+
+  validate() {
+    return;
+  }
+}
+
+
 export class HTTPMethodMeta implements MethodMeta {
   public readonly name: string;
   public readonly path: string;
@@ -139,6 +148,9 @@ export class ParamMetaUtil {
       case HTTPParamType.REQUEST: {
         return new RequestParamMeta();
       }
+      case HTTPParamType.COOKIES: {
+        return new CookiesParamMeta();
+      }
       default:
         assert.fail('never arrive');
     }

core/controller-decorator/src/model/index.ts

@@ -2,3 +2,4 @@ export * from './HTTPMethodMeta';
 export * from './HTTPControllerMeta';
 export * from './HTTPRequest';
 export * from './HTTPResponse';
+export * from './HTTPCookies';

core/types/controller-decorator/model/types.ts

@@ -45,4 +45,5 @@ export enum HTTPParamType {
   PARAM = 'PARAM',
   REQUEST = 'REQUEST',
   HEADERS = 'HEADERS',
+  COOKIES = 'COOKIES',
 }

plugin/controller/lib/impl/http/HTTPMethodRegister.ts

@@ -9,6 +9,7 @@ import {
   PathParamMeta,
   QueriesParamMeta,
   QueryParamMeta,
+  HTTPCookies,
 } from '@eggjs/tegg';
 import { EggContainerFactory } from '@eggjs/tegg-runtime';
 import { EggPrototype } from '@eggjs/tegg-metadata';
@@ -97,6 +98,10 @@ export class HTTPMethodRegister {
             args[index] = new HTTPRequest(ctx);
             break;
           }
+          case HTTPParamType.COOKIES: {
+            args[index] = new HTTPCookies(ctx, []);
+            break;
+          }
           default:
             assert.fail('never arrive');
         }

plugin/controller/test/fixtures/apps/http-inject-app/app/controller/AppController.ts

@@ -7,6 +7,8 @@ import {
   Middleware,
   Request,
   HTTPRequest,
+  Cookies,
+  HTTPCookies,
 } from '@eggjs/tegg';
 import { countMw } from '../middleware/count_mw';
 
@@ -20,14 +22,16 @@ export class AppController {
     method: HTTPMethodEnum.POST,
     path: '/testRequest',
   })
-  async testRequest(@Context() ctx: EggContext, @Request() request: HTTPRequest) {
+
+  async testRequest(@Context() ctx: EggContext, @Request() request: HTTPRequest, @Cookies() cookies: HTTPCookies) {
     const traceId = await ctx.tracer.traceId;
     return {
       success: true,
       traceId,
       headers: Object.fromEntries(request.headers),
       method: request.method,
       requestBody: await request.text(),
+      cookies: cookies.get('test', { signed: false }),
     };
   }
 }

plugin/controller/test/http/request.test.ts

@@ -41,11 +41,13 @@ describe('plugin/controller/test/http/request.test.ts', () => {
         .post('/apps/testRequest')
         .send(param)
         .set('test', headerKey)
+        .set('cookie', 'test=foo')
         .expect(200)
         .expect(res => {
           assert(res.body.headers.test === headerKey);
           assert(res.body.method === 'POST');
           assert(res.body.requestBody === JSON.stringify(param));
+          assert(res.body.cookies === 'foo');
         });
     });
   }