@finesoft/front 0.5.1 → 0.5.3

package/dist/types-B1BT0N3t.mjs

@@ -0,0 +1,402 @@
+import { Bt as secureFetch, Xt as isMultiValueSchema } from "./src-BQBfaaPO.mjs";
+import { i as HttpError } from "./host-guard-DDWxLpFL.mjs";
+//#region ../core/src/schema/standard.ts
+/** 工厂：从一个 validate 函数构造实现了 ~standard 的 codec */
+function makeSchema(validate) {
+	return { "~standard": {
+		version: 1,
+		vendor: "finesoft",
+		validate
+	} };
+}
+//#endregion
+//#region ../core/src/schema/primitives.ts
+const fail = (message) => ({ issues: [{ message }] });
+function str(opts = {}) {
+	return makeSchema((value) => {
+		if (typeof value !== "string") return fail("expected a string");
+		if (opts.minLength !== void 0 && value.length < opts.minLength) return fail(`must be at least ${opts.minLength} characters`);
+		if (opts.maxLength !== void 0 && value.length > opts.maxLength) return fail(`must be at most ${opts.maxLength} characters`);
+		if (opts.pattern && !opts.pattern.test(value)) return fail(`must match ${opts.pattern}`);
+		return { value };
+	});
+}
+function inRange(n, opts) {
+	if (opts.min !== void 0 && n < opts.min) return fail(`must be >= ${opts.min}`);
+	if (opts.max !== void 0 && n > opts.max) return fail(`must be <= ${opts.max}`);
+	return null;
+}
+function int(opts = {}) {
+	return makeSchema((value) => {
+		if (typeof value !== "string" || !/^-?\d+$/.test(value)) return fail(`"${String(value)}" is not an integer`);
+		const n = Number(value);
+		return inRange(n, opts) ?? { value: n };
+	});
+}
+function num(opts = {}) {
+	return makeSchema((value) => {
+		if (typeof value !== "string" || !/^-?\d+(\.\d+)?$/.test(value)) return fail(`"${String(value)}" is not a number`);
+		const n = Number(value);
+		return inRange(n, opts) ?? { value: n };
+	});
+}
+const TRUE = /* @__PURE__ */ new Set(["true", "1"]);
+const FALSE = /* @__PURE__ */ new Set(["false", "0"]);
+function bool() {
+	return makeSchema((value) => {
+		if (typeof value === "string" && TRUE.has(value)) return { value: true };
+		if (typeof value === "string" && FALSE.has(value)) return { value: false };
+		return fail(`"${String(value)}" is not a boolean (true/false/1/0)`);
+	});
+}
+function oneOf(values) {
+	return makeSchema((value) => {
+		if (typeof value === "string" && values.includes(value)) return { value };
+		return fail(`"${String(value)}" is not one of: ${values.join(", ")}`);
+	});
+}
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function uuid() {
+	return makeSchema((value) => {
+		if (typeof value === "string" && UUID_RE.test(value)) return { value };
+		return fail(`"${String(value)}" is not a valid UUID`);
+	});
+}
+//#endregion
+//#region ../core/src/schema/modifiers.ts
+function onMissing(codec, fallback) {
+	const multi = isMultiValueSchema(codec);
+	return {
+		...multi ? { multi: true } : {},
+		"~standard": {
+			version: 1,
+			vendor: "finesoft",
+			validate(value) {
+				if (value === void 0 || multi && Array.isArray(value) && value.length === 0) return { value: fallback };
+				return codec["~standard"].validate(value);
+			}
+		}
+	};
+}
+function optional(codec) {
+	return onMissing(codec, void 0);
+}
+function withDefault(codec, fallback) {
+	return onMissing(codec, fallback);
+}
+//#endregion
+//#region ../core/src/http/client.ts
+/**
+* 通用 HTTP 客户端基类
+*
+* 使用方式: 创建子类继承 HttpClient，定义业务方法调用 this.get() / this.post() 等。
+*
+* @example
+* ```ts
+* class MyApiClient extends HttpClient {
+*   async getUser(id: string) {
+*     return this.get<User>(`/users/${id}`);
+*   }
+* }
+* ```
+*/
+var HttpClient = class {
+	baseUrl;
+	defaultHeaders;
+	fetchFn;
+	requestInterceptors;
+	responseInterceptors;
+	contextSignal;
+	constructor(config) {
+		this.baseUrl = config.baseUrl;
+		this.defaultHeaders = config.defaultHeaders ?? {};
+		if (!config.fetch && !config.context) throw new TypeError("HttpClient requires fetch or an execution context");
+		this.fetchFn = secureFetch(config.fetch ?? config.context.fetch, config);
+		this.contextSignal = config.context?.signal;
+		this.requestInterceptors = [...config.requestInterceptors ?? []];
+		this.responseInterceptors = [...config.responseInterceptors ?? []];
+	}
+	/** 动态添加请求拦截器 */
+	useRequestInterceptor(interceptor) {
+		this.requestInterceptors.push(interceptor);
+		return this;
+	}
+	/** 动态添加响应拦截器 */
+	useResponseInterceptor(interceptor) {
+		this.responseInterceptors.push(interceptor);
+		return this;
+	}
+	/** GET 请求，返回解析后的 JSON */
+	async get(path, params, options) {
+		return this.request("GET", path, {
+			...options,
+			params
+		});
+	}
+	/** POST 请求，自动序列化 body 为 JSON */
+	async post(path, body, params, options) {
+		return this.request("POST", path, {
+			...options,
+			body,
+			params
+		});
+	}
+	/** PUT 请求 */
+	async put(path, body, params, options) {
+		return this.request("PUT", path, {
+			...options,
+			body,
+			params
+		});
+	}
+	/** DELETE 请求 */
+	async del(path, params, options) {
+		return this.request("DELETE", path, {
+			...options,
+			params
+		});
+	}
+	/**
+	* 底层请求方法 — 子类可覆写以自定义行为
+	*
+	* 自动处理:
+	* - URL 拼接 (baseUrl + path + params)
+	* - SSRF 防护（IP 字面量同步校验 + 可选 DNS 解析校验）
+	* - 默认 headers 合并
+	* - JSON body 序列化
+	* - 响应 JSON 解析
+	* - 非 2xx 状态码抛出 HttpError
+	*/
+	async request(method, path, options) {
+		options?.signal?.throwIfAborted();
+		const url = this.buildUrl(path, options?.params);
+		const headers = {
+			...this.defaultHeaders,
+			...options?.headers
+		};
+		let init = {
+			method,
+			headers,
+			signal: options?.signal
+		};
+		if (options?.body !== void 0) {
+			if (!Object.keys(headers).some((k) => k.toLowerCase() === "content-type")) headers["Content-Type"] = "application/json";
+			init.body = JSON.stringify(options.body);
+		}
+		for (const interceptor of this.requestInterceptors) init = await interceptor(url, init);
+		const signals = [
+			options?.signal,
+			init.signal,
+			this.contextSignal
+		].filter((signal) => !!signal);
+		const signal = signals.length > 1 ? AbortSignal.any(signals) : signals[0];
+		signal?.throwIfAborted();
+		init = {
+			...init,
+			signal
+		};
+		let response = await this.fetchFn(url, init);
+		signal?.throwIfAborted();
+		for (const interceptor of this.responseInterceptors) response = await interceptor(response, url);
+		if (!response.ok) {
+			const body = await response.text().catch(() => void 0);
+			throw new HttpError(response.status, response.statusText, body);
+		}
+		try {
+			const result = await response.json();
+			signal?.throwIfAborted();
+			return result;
+		} catch (e) {
+			if (e instanceof SyntaxError) throw new HttpError(response.status, "Invalid JSON response", await response.text().catch(() => void 0));
+			throw e;
+		}
+	}
+	/** 构建完整 URL — 子类可覆写以自定义 URL 拼接逻辑 */
+	buildUrl(path, params) {
+		const base = this.baseUrl.endsWith("/") ? this.baseUrl.slice(0, -1) : this.baseUrl;
+		const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+		const url = new URL(`${base}${normalizedPath}`, "http://placeholder");
+		if (params) for (const [k, v] of Object.entries(params)) url.searchParams.set(k, v);
+		if (this.baseUrl.startsWith("http")) return url.toString();
+		return `${url.pathname}${url.search}`;
+	}
+};
+//#endregion
+//#region ../core/src/data/mapper.ts
+function pipe(...mappers) {
+	return (input) => mappers.reduce((acc, mapper) => mapper(acc), input);
+}
+function pipeAsync(...mappers) {
+	return async (input) => {
+		let acc = input;
+		for (const mapper of mappers) acc = await mapper(acc);
+		return acc;
+	};
+}
+/**
+* 将一个 Mapper 应用到数组的每个元素
+*/
+function mapEach(mapper) {
+	return (items) => items.map(mapper);
+}
+//#endregion
+//#region ../core/src/utils/optional.ts
+function isSome(value) {
+	return value !== null && value !== void 0;
+}
+function isNone(value) {
+	return value === null || value === void 0;
+}
+//#endregion
+//#region ../core/src/utils/url.ts
+/**
+* URL 工具函数
+*/
+/** 移除 URL scheme (https://, http://) */
+function removeScheme(url) {
+	return url.replace(/^https?:\/\//, "");
+}
+/** 移除 URL host 部分，保留路径 */
+function removeHost(url) {
+	try {
+		const parsed = new URL(url);
+		return parsed.pathname + parsed.search + parsed.hash;
+	} catch {
+		return url;
+	}
+}
+/** 移除 query 参数 */
+function removeQueryParams(url) {
+	return url.split("?")[0];
+}
+/** 获取 URL 的基础路径（无 query、hash） */
+function getBaseUrl(url) {
+	return url.split("?")[0].split("#")[0];
+}
+/** 构建 URL（路径 + query 参数） */
+function buildUrl(path, params) {
+	if (!params) return path;
+	const searchParams = new URLSearchParams();
+	for (const [key, value] of Object.entries(params)) if (value !== void 0) searchParams.set(key, value);
+	const qs = searchParams.toString();
+	return qs ? `${path}?${qs}` : path;
+}
+//#endregion
+//#region ../core/src/metrics/composite-recorder.ts
+var CompositeEventRecorder = class {
+	recorders;
+	constructor(recorders) {
+		this.recorders = recorders;
+	}
+	record(type, fields) {
+		for (const recorder of this.recorders) recorder.record(type, fields);
+	}
+	async flush() {
+		const pending = [];
+		for (const recorder of this.recorders) if (recorder.flush) pending.push(recorder.flush());
+		await Promise.all(pending);
+	}
+	destroy() {
+		for (const recorder of this.recorders) recorder.destroy?.();
+	}
+};
+//#endregion
+//#region ../core/src/metrics/console-recorder.ts
+var ConsoleEventRecorder = class {
+	prefix;
+	constructor(prefix = "Metrics") {
+		this.prefix = prefix;
+	}
+	record(type, fields) {
+		console.info(`[${this.prefix}:${type}]`, fields ?? "");
+	}
+	async flush() {}
+	destroy() {}
+};
+//#endregion
+//#region ../core/src/metrics/void-recorder.ts
+var VoidEventRecorder = class {
+	record() {}
+	async flush() {}
+	destroy() {}
+};
+//#endregion
+//#region ../core/src/metrics/with-fields-recorder.ts
+var WithFieldsRecorder = class {
+	inner;
+	providers;
+	constructor(inner, providers) {
+		this.inner = inner;
+		this.providers = providers;
+	}
+	record(type, fields) {
+		let merged = {};
+		for (const provider of this.providers) Object.assign(merged, provider.getFields());
+		if (fields) Object.assign(merged, fields);
+		this.inner.record(type, merged);
+	}
+	async flush() {
+		return this.inner.flush?.();
+	}
+	destroy() {
+		this.inner.destroy?.();
+	}
+};
+//#endregion
+//#region ../web/src/models/safe-error-page.ts
+function formatDevError(devError) {
+	if (devError instanceof Error) return devError.stack ?? `${devError.name}: ${devError.message}`;
+	if (typeof devError === "string") return devError;
+	try {
+		return JSON.stringify(devError);
+	} catch {
+		return String(devError);
+	}
+}
+/**
+* Build a BasePage for an error condition. In production, only `publicMessage`
+* makes it into the page. In dev, `devError` (if provided) is appended.
+*/
+function safeErrorPage(options) {
+	const { status, publicMessage, devError, isProduction = true } = options;
+	const showDevError = !isProduction && devError !== void 0;
+	return {
+		id: "error",
+		pageType: "error",
+		title: `Error ${status}`,
+		description: showDevError ? `${publicMessage}\n\n[dev only]\n${formatDevError(devError)}` : publicMessage
+	};
+}
+//#endregion
+//#region ../web/src/middleware/types.ts
+/** 继续执行 */
+function next() {
+	return { kind: "next" };
+}
+/** 重定向到新 URL */
+function redirect(url, status = 302) {
+	return {
+		kind: "redirect",
+		url,
+		status
+	};
+}
+/** URL 重写（不重新加载数据） */
+function rewrite(url) {
+	return {
+		kind: "rewrite",
+		url
+	};
+}
+/** 拒绝访问 */
+function deny(status = 403, message = "Forbidden") {
+	return {
+		kind: "deny",
+		status,
+		message
+	};
+}
+//#endregion
+export { bool as C, str as D, oneOf as E, uuid as O, withDefault as S, num as T, mapEach as _, safeErrorPage as a, HttpClient as b, ConsoleEventRecorder as c, getBaseUrl as d, removeHost as f, isSome as g, isNone as h, rewrite as i, makeSchema as k, CompositeEventRecorder as l, removeScheme as m, next as n, WithFieldsRecorder as o, removeQueryParams as p, redirect as r, VoidEventRecorder as s, deny as t, buildUrl as u, pipe as v, int as w, optional as x, pipeAsync as y };
+
+//# sourceMappingURL=types-B1BT0N3t.mjs.map