@springbrand/http 0.1.0-alpha.0 → 0.1.0-alpha.10

package/dist/server/index.js

@@ -1,11 +1,22 @@
 import { fail, ok, toErrorResponse } from "./response.js";
 import { SERVICE_TOKEN_HEADER, createServiceRequest, verifyServiceToken } from "./service-auth.js";
+import { limitRequestBody, readBytesLimited, readJson, readJsonLimited, requireIfMatchRevision } from "./body.js";
+import { contentDispositionHeader } from "./content-disposition.js";
+import { errorDiagnostics, redactSensitiveText } from "./error-diagnostics.js";
 import { toSafeDiagnostics } from "../diagnostics.js";
 export {
   SERVICE_TOKEN_HEADER,
+  contentDispositionHeader,
   createServiceRequest,
+  errorDiagnostics,
   fail,
+  limitRequestBody,
   ok,
+  readBytesLimited,
+  readJson,
+  readJsonLimited,
+  redactSensitiveText,
+  requireIfMatchRevision,
   toErrorResponse,
   toSafeDiagnostics,
   verifyServiceToken

package/dist/server/response.js

@@ -1,3 +1,4 @@
+import { httpStatusOf } from "@springbrand/errors";
 import { ApiError, errorDefinitions } from "../errors.js";
 function responseHeaders(options) {
   const requestId = options.requestId ?? crypto.randomUUID();
@@ -22,7 +23,7 @@ function toErrorResponse(error, options = {}) {
   if (error instanceof ApiError && error.kind === "http" && Number.isInteger(error.status) && error.status >= 400 && error.status <= 599 && /^[A-Z][A-Z0-9_]{0,127}$/.test(error.code) && !["NETWORK_ERROR", "REQUEST_TIMEOUT", "RESPONSE_TOO_LARGE"].includes(error.code)) {
     return fail({ status: error.status, code: error.code, message: error.message, errors: error.errors, details: error.details, requestId: options.requestId ?? error.requestId, headers: options.headers });
   }
-  return fail({ status: 500, code: "INTERNAL_ERROR", message: errorDefinitions.INTERNAL_ERROR, ...options });
+  return fail({ status: httpStatusOf("INTERNAL_ERROR"), code: "INTERNAL_ERROR", message: errorDefinitions.INTERNAL_ERROR, ...options });
 }
 export {
   fail,

package/dist/server/service-auth.d.ts

@@ -1,3 +1,10 @@
 export declare const SERVICE_TOKEN_HEADER = "X-SpringBrand-Service-Token";
-export declare function createServiceRequest(baseUrl: string, token: string, path: string | URL, init?: RequestInit): Request;
+/**
+ * 构造绑定来源的服务请求。传入 Request 时会转发它的方法、请求头、请求体和 signal；
+ * 同源 URL 原样使用，其他来源只保留路径和查询参数并绑定到 baseUrl。
+ * 默认删除用户的 Authorization 和 Cookie；只有下游需要按调用者身份鉴权时，才显式传 forwardAuthorization。
+ */
+export declare function createServiceRequest(baseUrl: string | URL, token: string, input: string | URL | Request, init?: RequestInit, behavior?: {
+    forwardAuthorization?: boolean;
+}): Request;
 export declare function verifyServiceToken(provided: string | null | undefined, expected: string): Promise<boolean>;

package/dist/server/service-auth.js

@@ -1,13 +1,31 @@
-import { boundUrl, serviceUrl } from "../url.js";
+import { serviceUrl, boundUrl } from "../url.js";
 const SERVICE_TOKEN_HEADER = "X-SpringBrand-Service-Token";
-function createServiceRequest(baseUrl, token, path, init = {}) {
+function createServiceRequest(baseUrl, token, input, init = {}, behavior = {}) {
   if (!token.trim()) throw new TypeError("Service token is required");
-  const url = boundUrl(serviceUrl(baseUrl), path);
-  const headers = new Headers(init.headers);
-  headers.delete("Authorization");
+  const base = serviceUrl(String(baseUrl));
+  const source = input instanceof Request ? input : void 0;
+  let path = source ? new URL(source.url) : input;
+  if (path instanceof URL && source && path.origin !== base.origin) path = `${path.pathname}${path.search}`;
+  const url = boundUrl(base, path);
+  const headers = new Headers(source?.headers);
+  new Headers(init.headers).forEach((value, key) => headers.set(key, value));
+  if (!behavior.forwardAuthorization) headers.delete("Authorization");
   headers.delete("Cookie");
   headers.set(SERVICE_TOKEN_HEADER, token);
-  return new Request(url, { ...init, headers, credentials: "omit", redirect: "error" });
+  const body = init.body !== void 0 ? init.body : source?.body ?? null;
+  const options = {
+    ...init,
+    method: init.method ?? source?.method ?? "GET",
+    headers,
+    body,
+    signal: init.signal ?? source?.signal ?? null,
+    cache: "no-store",
+    redirect: "manual"
+  };
+  if (body instanceof ReadableStream) options.duplex = "half";
+  if ("credentials" in Request.prototype) options.credentials = "omit";
+  else delete options.credentials;
+  return new Request(url, options);
 }
 async function verifyServiceToken(provided, expected) {
   if (!provided || !expected) return false;

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { ApiError } from "./errors.js";
+import type { ApiError, errorDefinitions } from "./errors.js";
 export type HttpMethod = "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
 export type ResponseMode = "envelope" | "json" | "text" | "blob";
 export type Feedback = "auto" | "inline" | "silent";
@@ -77,6 +77,8 @@ export type HttpRequestOptions = {
     idempotencyKey?: string;
     onUploadProgress?: (progress: UploadProgress) => void;
 };
+/** 替换 SDK 自身产生的提示文案；服务端返回的 errMsg 不受影响。 */
+export type HttpMessages = Partial<Record<keyof typeof errorDefinitions | "MUTATION_RESULT_UNCERTAIN", string>>;
 export type HttpClientConfig = {
     baseUrl: string;
     timeoutMs?: number;
@@ -88,11 +90,16 @@ export type HttpClientConfig = {
     decodeResponse?: (data: unknown, info: ResponseInfo) => unknown;
     decodeError?: (data: unknown, info: ResponseInfo) => ApiError;
     isUnauthorized?: (error: ApiError) => boolean;
-    onUnauthorized?: (error: ApiError) => void;
+    /**
+     * 当前 Bearer 被确认失效时调用。同一 token 的重复失效只处理一次：
+     * 返回 Promise 时，Promise 完成后恢复处理（例如复检会话后 token 仍有效）；返回 void 时直到 token 变化。
+     */
+    onUnauthorized?: (error: ApiError) => void | Promise<unknown>;
     notify?: (notice: RequestNotice) => void;
     onBusinessError?: (error: ApiError, context: ErrorContext) => boolean;
     feedbackOwner?: FeedbackOwner;
     onFailure?: (failure: RequestFailure) => void;
+    messages?: HttpMessages;
     /** 注入标准 Fetch，便于测试或适配宿主；请求仍由 Axios 执行。 */
     fetch?: typeof globalThis.fetch;
 };

package/dist/url.js

@@ -1,6 +1,6 @@
-import { ApiError, errorDefinitions } from "./errors.js";
+import { sdkError } from "./sdk-error.js";
 function invalidUrl() {
-  throw new ApiError({ status: 0, code: "REQUEST_INVALID_INPUT", message: errorDefinitions.REQUEST_INVALID_INPUT, kind: "input" });
+  throw sdkError("REQUEST_INVALID_INPUT", { status: 0, kind: "input" });
 }
 function serviceUrl(baseUrl) {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/http",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.10",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -38,36 +38,64 @@
       "import": "./dist/query.js",
       "default": "./dist/query.js"
     },
+    "./catalog": {
+      "types": "./dist/catalog.d.ts",
+      "import": "./dist/catalog.js",
+      "default": "./dist/catalog.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "import": "./dist/hono.js",
+      "default": "./dist/hono.js"
+    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "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"
+    "axios": "1.20.0",
+    "content-disposition": "2.0.1"
   },
   "peerDependencies": {
-    "@tanstack/react-query": "^5.104.1"
+    "@springbrand/errors": ">=0.0.0-0",
+    "@tanstack/react-query": "^5.104.1",
+    "hono": "^4.12.0",
+    "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-query": {
       "optional": true
+    },
+    "hono": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@tanstack/react-query": "5.104.1",
-    "vitest": "3.2.6",
+    "@types/node": "^20.8.3",
+    "esbuild": "0.27.7",
+    "hono": "4.12.33",
+    "miniflare": "5.20260910.0-alpha",
     "typescript": "^5.0.2",
     "vite": "^5.4.19",
-    "@types/node": "^20.8.3"
+    "vitest": "3.2.6",
+    "zod": "4.6.5",
+    "@springbrand/errors": "0.1.0-alpha.4"
+  },
+  "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"
   }
-}
+}