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

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
@@ -23,7 +24,7 @@ Create one client per trusted API origin. Inject getToken; do not copy Token sto
 
 Pass params for query serialization and signal/timeoutMs for cancellation/deadlines. Null/undefined query values are omitted; use a string for literal null. Do not duplicate query encoding or timeout controllers in domain clients.
 
-Use get/post/put/patch/delete for payloads, request for data plus status and headers. Explicitly choose json, text or blob for endpoints without the standard success envelope. FormData owns its boundary. Pass Query's signal through; do not wrap cancellation as network failure.
+Use get/post/put/patch/delete for payloads, request for data plus status and headers. Explicitly choose json, text or blob for endpoints without the standard success envelope. FormData owns its boundary. The client sends no User-Agent of its own (Safari and Firefox would otherwise require every cross-origin API to allow it in CORS); set one explicitly only for a server-to-server call that needs it. Pass Query's signal through; do not wrap cancellation as network failure.
 
 ## Error handling
 

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/client.js

@@ -57,6 +57,7 @@ function createHttpClient(config) {
       if (options.body instanceof FormData) headers.delete("Content-Type");
       if (timeout > 0) timer = setTimeout(() => controller.abort(sdkError("REQUEST_TIMEOUT", { status: 0, kind: "timeout" })), timeout);
       const requestHeaders = new axios.AxiosHeaders(Object.fromEntries(headers));
+      if (!requestHeaders.has("User-Agent")) requestHeaders.set("User-Agent", false);
       if (options.body instanceof FormData) requestHeaders.setContentType("multipart/form-data");
       const response = await transport.request({
         url: url.href,

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.5",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -53,6 +53,9 @@
       "import": "./dist/server/index.js",
       "default": "./dist/server/index.js"
     },
+    "./types": {
+      "types": "./dist/types.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {