@longzai-intelligence-transport/http-adapter-bun 0.1.23 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,19 +1,13 @@
1
1
  # @longzai-intelligence-transport/http-adapter-bun
2
2
 
3
- ## 意图
3
+ Longzai Intelligence Transport 的 HTTP Bun 适配器包,对接 Bun 运行时的路由处理器与服务端能力。
4
4
 
5
- 为 Longzai Intelligence 传输层 HTTP 协议提供 Bun 适配器,对接 Bun 原生路由处理器与服务端能力。
5
+ ## 简介
6
6
 
7
- ## 定位
7
+ 治理 Bun 场景下的 HTTP 传输接入:复用 HTTP 契约层的类型与契约,对接 Bun 原生路由处理器,作为 Bun 服务端场景的传输接入层。
8
8
 
9
- HTTP 协议的 Bun 适配器包,基于 HTTP 核心包构建,对接 Bun 运行时的路由处理器与服务端能力,作为 Bun 场景下的 HTTP 传输接入层。
10
-
11
- ## 核心能力
9
+ ## 能力
12
10
 
13
11
  - 对接 Bun 原生路由处理器
14
- - 复用 HTTP 核心包的类型与契约
15
- - 支撑 Bun 服务端场景下的 HTTP 传输
16
-
17
- ## 实现情况
18
-
19
- 已完成对 HTTP 核心包与 Bun 运行时的依赖接入,并以 Bun 作为对等依赖承载服务端能力,可作为可发布包对外提供。
12
+ - 复用 HTTP 契约层的类型与契约
13
+ - Bun 服务端场景的 HTTP 传输支撑
package/dist/index.d.ts CHANGED
@@ -82,9 +82,21 @@ type BunRouteHandler<_TContext = unknown> = (request: Request) => Promise<Respon
82
82
  /**
83
83
  * Bun 路由处理器选项
84
84
  *
85
+ * @typeParam TRoute - 路由定义类型
85
86
  * @typeParam TContext - 自定义上下文类型
86
87
  */
87
- type BunRouteHandlerOptions<TContext = unknown> = {
88
+ type BunRouteHandlerOptions<TRoute extends RouteDefinition = RouteDefinition, TContext = unknown> = {
89
+ /**
90
+ * 前置处理钩子
91
+ *
92
+ * 在请求参数验证通过后、业务 handler 执行前调用。可读取路由契约上的
93
+ * metadata 通道(含下游声明的权限/角色元数据),返回 Response 则短路本次请求。
94
+ *
95
+ * @param ctx - 请求上下文(含解析后的 params/query/body)
96
+ * @param route - 当前路由定义(含 metadata 通道载体,闭包内可达)
97
+ * @returns 返回 Response 则短路返回,void/undefined 继续执行 handler
98
+ */
99
+ beforeHandle?: (ctx: BunRequestContext<TContext>, route: TRoute) => Response | void | Promise<Response | void>;
88
100
  /**
89
101
  * 创建自定义上下文的工厂函数
90
102
  *
@@ -311,7 +323,7 @@ declare function parseRequestBody(request: Request): Promise<unknown>;
311
323
  * @param options - 处理器选项
312
324
  * @returns Bun 路由处理函数
313
325
  */
314
- declare function createRouteHandler<TRoute extends RouteDefinition, TContext = unknown>(route: TRoute, handler: RouteHandlerFn<TRoute, TContext>, options?: BunRouteHandlerOptions<TContext>): BunRouteHandler<TContext>;
326
+ declare function createRouteHandler<TRoute extends RouteDefinition, TContext = unknown>(route: TRoute, handler: RouteHandlerFn<TRoute, TContext>, options?: BunRouteHandlerOptions<TRoute, TContext>): BunRouteHandler<TContext>;
315
327
  /**
316
328
  * 创建路由映射
317
329
  *
@@ -365,7 +377,7 @@ declare function createRouteHandler<TRoute extends RouteDefinition, TContext = u
365
377
  * @param options - 处理器选项
366
378
  * @returns Bun 路由映射,可用于 Bun.serve 的 fetch 处理
367
379
  */
368
- declare function createRouteMap<TRoutes extends Record<string, RouteDefinition>, TContext = unknown>(routes: TRoutes, handlers: RoutesMap<TRoutes, TContext>, options?: BunRouteHandlerOptions<TContext>): Record<string, Record<string, BunRouteHandler<TContext>>>;
380
+ declare function createRouteMap<TRoutes extends Record<string, RouteDefinition>, TContext = unknown>(routes: TRoutes, handlers: RoutesMap<TRoutes, TContext>, options?: BunRouteHandlerOptions<RouteDefinition, TContext>): Record<string, Record<string, BunRouteHandler<TContext>>>;
369
381
  /**
370
382
  * 创建 Bun 服务器 fetch 处理器
371
383
  *
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- import{createValidationErrorResponseFromError as e,validateRequest as t}from"@longzai-intelligence-transport/http-core";function n(e){let t=[],n=/:([^/]+)/g,r=n.exec(e);for(;r!==null;)r[1]&&t.push(r[1]),r=n.exec(e);return t}function r(e){let t=n(e),r=e.replace(/:([^/]+)/g,`(?<$1>[^/]+)`);return{regex:RegExp(`^${r}$`),paramNames:t}}function i(e,t){let{regex:n}=r(t),i=new URL(e).pathname,a=n.exec(i);return!a||!a.groups?{}:a.groups}function a(e){let t=new URL(e.url),n={};return t.searchParams.forEach((e,t)=>{let r=n[t];r===void 0?n[t]=e:typeof r==`string`?n[t]=[r,e]:r.push(e)}),n}async function o(e){let t=e.headers.get(`content-type`);if(t){if(t.includes(`application/json`))try{return await e.json()}catch{return}if(t.includes(`multipart/form-data`)){let t=await e.formData(),n={};return t.forEach((e,t)=>{n[t]=e}),n}if(t.includes(`application/x-www-form-urlencoded`)){let t=await e.formData(),n={};return t.forEach((e,t)=>{n[t]=e}),n}if(t.includes(`text/`))return await e.text()}}function s(e){let t=e instanceof Error?e.message:`服务器内部错误`;return new Response(JSON.stringify({success:!1,error:{code:`INTERNAL_ERROR`,message:t},message:t,timestamp:Date.now()}),{status:500,headers:{"Content-Type":`application/json`}})}async function c(e,t,n,r,i,a){let o={request:t,params:n,query:r,body:i};a?.createContext&&(o.context=await a.createContext(o));let s=await e(o);return s instanceof ReadableStream?new Response(s,{status:200,headers:{"Content-Type":`application/octet-stream`}}):new Response(JSON.stringify(s),{status:200,headers:{"Content-Type":`application/json`}})}function l(n,r,l){return async u=>{try{let d=i(u.url,n.path),f=a(u),p=await o(u),m=t(n,{params:d,query:f,body:p});if(!m.success){if(!m.error)return s(Error(`验证失败但未提供错误详情`));if(l?.onValidationError)return await l.onValidationError(m.error,u);let t=e(m.error);return new Response(JSON.stringify(t),{status:400,headers:{"Content-Type":`application/json`}})}return await c(r,u,m.params??{},m.query??{},m.body,l)}catch(e){return l?.onError?l.onError(e,u):s(e)}}}function u(e,t,n){let r={};for(let[i,a]of Object.entries(e)){let e=t[i];if(e){let t=l(a,e,n),i=a.path;r[i]||(r[i]={}),r[i][a.method]=t}}return r}function d(e,t){return async n=>{let r=e[new URL(n.url).pathname];if(!r)return t?.onNotFound?t.onNotFound(n):new Response(JSON.stringify({success:!1,error:{code:`NOT_FOUND`,message:`资源不存在`},message:`资源不存在`,timestamp:Date.now()}),{status:404,headers:{"Content-Type":`application/json`}});let i=r[n.method];return i?i(n):t?.onMethodNotAllowed?t.onMethodNotAllowed(n):new Response(JSON.stringify({success:!1,error:{code:`METHOD_NOT_ALLOWED`,message:`方法不允许`},message:`方法不允许`,timestamp:Date.now()}),{status:405,headers:{"Content-Type":`application/json`}})}}export{d as createFetchHandler,l as createRouteHandler,u as createRouteMap,i as extractPathParams,a as extractQueryParams,o as parseRequestBody,r as pathToRegex};
1
+ import{createValidationErrorResponseFromError as e,validateRequest as t}from"@longzai-intelligence-transport/http-core";function n(e){let t=[],n=/:([^/]+)/g,r=n.exec(e);for(;r!==null;)r[1]&&t.push(r[1]),r=n.exec(e);return t}function r(e){let t=n(e),r=e.replace(/:([^/]+)/g,`(?<$1>[^/]+)`);return{regex:RegExp(`^${r}$`),paramNames:t}}function i(e,t){let{regex:n}=r(t),i=new URL(e).pathname,a=n.exec(i);return!a||!a.groups?{}:a.groups}function a(e){let t=new URL(e.url),n={};return t.searchParams.forEach((e,t)=>{let r=n[t];r===void 0?n[t]=e:typeof r==`string`?n[t]=[r,e]:r.push(e)}),n}async function o(e){let t=e.headers.get(`content-type`);if(t){if(t.includes(`application/json`))try{return await e.json()}catch{return}if(t.includes(`multipart/form-data`)){let t=await e.formData(),n={};return t.forEach((e,t)=>{n[t]=e}),n}if(t.includes(`application/x-www-form-urlencoded`)){let t=await e.formData(),n={};return t.forEach((e,t)=>{n[t]=e}),n}if(t.includes(`text/`))return await e.text()}}function s(e){let t=e instanceof Error?e.message:`服务器内部错误`;return new Response(JSON.stringify({success:!1,error:{code:`INTERNAL_ERROR`,message:t},message:t,timestamp:Date.now()}),{status:500,headers:{"Content-Type":`application/json`}})}async function c(e,t,n,r,i,a){let o={request:t,params:n,query:r,body:i};a?.createContext&&(o.context=await a.createContext(o));let s=await e(o);return s instanceof ReadableStream?new Response(s,{status:200,headers:{"Content-Type":`application/octet-stream`}}):new Response(JSON.stringify(s),{status:200,headers:{"Content-Type":`application/json`}})}function l(n,r,l){return async u=>{try{let d=i(u.url,n.path),f=a(u),p=await o(u),m=t(n,{params:d,query:f,body:p});if(!m.success){if(!m.error)return s(/* @__PURE__ */ Error(`验证失败但未提供错误详情`));if(l?.onValidationError)return await l.onValidationError(m.error,u);let t=e(m.error);return new Response(JSON.stringify(t),{status:400,headers:{"Content-Type":`application/json`}})}if(l?.beforeHandle){let e={request:u,params:m.params??{},query:m.query??{},body:m.body},t=await l.beforeHandle(e,n);if(t instanceof Response)return t}return await c(r,u,m.params??{},m.query??{},m.body,l)}catch(e){return l?.onError?l.onError(e,u):s(e)}}}function u(e,t,n){let r={};for(let[i,a]of Object.entries(e)){let e=t[i];if(e){let t=l(a,e,n),i=a.path;r[i]||(r[i]={}),r[i][a.method]=t}}return r}function d(e,t){return async n=>{let r=e[new URL(n.url).pathname];if(!r)return t?.onNotFound?t.onNotFound(n):new Response(JSON.stringify({success:!1,error:{code:`NOT_FOUND`,message:`资源不存在`},message:`资源不存在`,timestamp:Date.now()}),{status:404,headers:{"Content-Type":`application/json`}});let i=r[n.method];return i?i(n):t?.onMethodNotAllowed?t.onMethodNotAllowed(n):new Response(JSON.stringify({success:!1,error:{code:`METHOD_NOT_ALLOWED`,message:`方法不允许`},message:`方法不允许`,timestamp:Date.now()}),{status:405,headers:{"Content-Type":`application/json`}})}}export{d as createFetchHandler,l as createRouteHandler,u as createRouteMap,i as extractPathParams,a as extractQueryParams,o as parseRequestBody,r as pathToRegex};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@longzai-intelligence-transport/http-adapter-bun",
3
- "version": "0.1.23",
3
+ "version": "0.2.1",
4
4
  "keywords": [
5
5
  "adapter",
6
6
  "bun",
@@ -38,7 +38,7 @@
38
38
  "clean": "lzi-dev-cli clean"
39
39
  },
40
40
  "dependencies": {
41
- "@longzai-intelligence-transport/http-core": "0.1.23"
41
+ "@longzai-intelligence-transport/http-core": "0.2.1"
42
42
  },
43
43
  "devDependencies": {
44
44
  "zod": "^4.4.3"