@springbrand/http 0.1.0-alpha.3 → 0.1.0-alpha.4

package/.agents/skills/dune-react-http/SKILL.md

@@ -15,6 +15,7 @@ Read the installed declarations and README before configuring a client. Public e
 | @springbrand/http/query | Optional TanStack React Query integration |
 | @springbrand/http/catalog | Project error catalog: typed HttpError, Zod response schemas, client decoder (zod peer) |
 | @springbrand/http/hono | Hono responders with TypedResponse types for zod-openapi (hono peer) |
+| @springbrand/http/types | Type-only entry for every public type, so consumers emitting declarations stay portable |
 | @springbrand/http/server | Standard Response helpers, bounded body reading, If-Match, Content-Disposition, log diagnostics and service authentication |
 
 ## Client setup

package/README.md

@@ -20,6 +20,7 @@ pnpm add @springbrand/http@alpha
 | `@springbrand/http/query` | createHttpQueryClient、读取重试策略 |
 | `@springbrand/http/catalog` | defineErrorCatalog：项目错误码目录、HttpError、Zod Schema、客户端解码 |
 | `@springbrand/http/hono` | createHonoHttp：ok、httpError 等带 TypedResponse 类型的 Hono 响应 |
+| `@springbrand/http/types` | 只含类型的入口：公共 API 用到的全部类型，供开启 declaration 的使用方生成可移植的声明文件 |
 | `@springbrand/http/server` | ok、fail、toErrorResponse、请求体限长读取、If-Match、Content-Disposition、服务鉴权与日志诊断 |
 
 客户端依赖 Axios。Query、catalog、hono 是独立入口，分别以 `@tanstack/react-query`、`zod`、`hono` 作为可选 peer；只用到哪个入口才需要安装对应依赖，核心和 server 入口都不需要。服务端要求标准 Request、Response 和 Web Crypto，建议 Node.js 24 或兼容运行时。

package/dist/catalog.d.ts

@@ -16,7 +16,7 @@ export type ServerErrorCode<D extends ErrorDefinitions> = {
 export type DetailSchemas<D extends ErrorDefinitions> = {
     readonly [K in ServerErrorCode<D>]?: z.ZodType;
 };
-type DetailsOf<S, C> = C extends keyof S ? S[C] extends z.ZodType ? z.output<S[C]> : undefined : undefined;
+export type DetailsOf<S, C> = C extends keyof S ? S[C] extends z.ZodType ? z.output<S[C]> : undefined : undefined;
 export type HttpErrorOptions<T> = ErrorOptions & {
     errors?: FieldError[];
     details?: T;
@@ -111,4 +111,3 @@ export declare function defineErrorCatalog<const D extends ErrorDefinitions & Re
     }, z.core.$strip>;
 };
 export type ErrorCatalogOf<D extends ErrorDefinitions & Record<RequiredErrorCode, ErrorDefinition>, S extends DetailSchemas<D> = Record<never, never>> = ReturnType<typeof defineErrorCatalog<D, S>>;
-export {};

package/dist/hono.d.ts

@@ -4,19 +4,19 @@ import type { ContentfulStatusCode } from "hono/utils/http-status";
 import type { ErrorDefinition, ErrorDefinitions, RequiredErrorCode } from "./catalog.js";
 import type { ApiError } from "./errors.js";
 import type { FieldError } from "./types.js";
-type CatalogError<D extends ErrorDefinitions, C extends keyof D & string> = ApiError & {
+export type CatalogError<D extends ErrorDefinitions, C extends keyof D & string> = ApiError & {
     readonly code: C;
     readonly status: D[C]["status"];
 };
-type SuccessResponse<T, S extends 200 | 201 | 202> = Response & TypedResponse<JSONParsed<{
+export type SuccessResponse<T, S extends 200 | 201 | 202> = Response & TypedResponse<JSONParsed<{
     success: true;
     msg: T;
     errMsg: "";
     code: "";
 }>, S, "json">;
-type ErrorStatus<D extends ErrorDefinitions, C extends keyof D> = D[C]["status"] & ContentfulStatusCode;
+export type ErrorStatus<D extends ErrorDefinitions, C extends keyof D> = D[C]["status"] & ContentfulStatusCode;
 /** 显式写出响应类型：让 Hono 在泛型 C 未确定时推导 JSONParsed，会在声明文件里丢掉 code 字段。 */
-type ErrorResponse<D extends ErrorDefinitions, C extends keyof D & string> = Response & TypedResponse<{
+export type ErrorResponse<D extends ErrorDefinitions, C extends keyof D & string> = Response & TypedResponse<{
     errMsg: string;
     code: C;
     requestId?: string;
@@ -47,4 +47,3 @@ export declare function createHonoHttp<const D extends ErrorDefinitions & Record
     httpInternalError: (c: Context, message?: string) => ErrorResponse<D, "INTERNAL_ERROR">;
     httpValidationError(c: Context, errors: FieldError[]): ErrorResponse<D, "REQUEST_VALIDATION_FAILED">;
 };
-export {};

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { ApiError, errorDefinitions, isApiError, isRequestCancelled, isTransientHttpError } from "./errors.js";
 export type { ApiErrorOptions, ApiErrorKind } from "./errors.js";
-export type { ApiSuccessResponse, HttpErrorResponse, FieldError, HttpResult, ErrorContext, RequestNotice, RequestFailure, HttpClientConfig, HttpMessages, HttpRequestOptions, HttpMethod, ResponseMode } from "./types.js";
+export type { ApiSuccessResponse, HttpErrorResponse, FieldError, HttpResult, ErrorContext, RequestContext, RequestNotice, RequestFailure, ResponseInfo, HttpClientConfig, HttpMessages, HttpRequestOptions, HttpMethod, ResponseMode, Feedback, FeedbackOwner, QueryScalar, UploadProgress, } from "./types.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/http",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -53,8 +53,18 @@
       "import": "./dist/server/index.js",
       "default": "./dist/server/index.js"
     },
+    "./types": {
+      "types": "./dist/types.d.ts"
+    },
     "./package.json": "./package.json"
   },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "watch": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests --ext ts --max-warnings 0",
+    "test": "vitest run"
+  },
   "dependencies": {
     "axios": "1.20.0",
     "content-disposition": "2.0.1"
@@ -85,12 +95,5 @@
     "vite": "^5.4.19",
     "vitest": "3.2.6",
     "zod": "4.6.5"
-  },
-  "scripts": {
-    "build": "vite build && tsc -p tsconfig.build.json",
-    "watch": "vite build --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src tests --ext ts --max-warnings 0",
-    "test": "vitest run"
   }
-}
+}