talizen 0.1.4 → 0.2.0

package/core.d.ts

@@ -36,6 +36,14 @@ export declare class TalizenHttpError extends Error {
     readonly statusText: string;
     readonly body: string;
     readonly bodyJson: TalizenErrorBody | undefined;
-    constructor(status: number, statusText: string, body: string, bodyJson?: TalizenErrorBody);
+    readonly method: string | undefined;
+    readonly url: string | undefined;
+    constructor(status: number, statusText: string, body: string, bodyJson?: TalizenErrorBody, request?: TalizenErrorRequest);
+}
+export interface TalizenErrorRequest {
+    method?: string;
+    url?: string;
 }
 export declare function requestJson<T>(path: string, init?: RequestInit, config?: TalizenRequestOptions): Promise<T>;
+export declare function stripUrlQuery(url: string): string;
+export declare function normalizeRequestMethod(method: string | undefined): string;

package/core.js

@@ -38,13 +38,17 @@ export class TalizenHttpError extends Error {
     statusText;
     body;
     bodyJson;
-    constructor(status, statusText, body, bodyJson) {
-        super(`Talizen request failed: ${status} ${statusText} ${body}`.trim());
+    method;
+    url;
+    constructor(status, statusText, body, bodyJson, request) {
+        super(formatTalizenRequestErrorMessage(status, statusText, body, request));
         this.name = "TalizenHttpError";
         this.status = status;
         this.statusText = statusText;
         this.body = body;
         this.bodyJson = bodyJson;
+        this.method = request?.method;
+        this.url = request?.url;
     }
 }
 export async function requestJson(path, init, config) {
@@ -58,7 +62,12 @@ export async function requestJson(path, init, config) {
     if (init?.body != null && !headers.has("content-type")) {
         headers.set("content-type", "application/json");
     }
-    const response = await resolved.fetch(buildTalizenUrl(path, resolved), {
+    const requestUrl = buildTalizenUrl(path, resolved);
+    const request = {
+        method: normalizeRequestMethod(init?.method),
+        url: stripUrlQuery(requestUrl),
+    };
+    const response = await resolved.fetch(requestUrl, {
         ...init,
         headers,
         signal: resolved.signal,
@@ -66,7 +75,7 @@ export async function requestJson(path, init, config) {
     if (!response.ok) {
         const text = await response.text();
         const bodyJson = parseTalizenErrorBody(text);
-        throw new TalizenHttpError(response.status, response.statusText, text, bodyJson);
+        throw new TalizenHttpError(response.status, response.statusText, text, bodyJson, request);
     }
     const text = await response.text();
     if (text === "") {
@@ -74,6 +83,23 @@ export async function requestJson(path, init, config) {
     }
     return JSON.parse(text);
 }
+export function stripUrlQuery(url) {
+    try {
+        const parsed = new URL(url);
+        parsed.search = "";
+        return parsed.toString();
+    }
+    catch {
+        return url.split("?")[0] ?? url;
+    }
+}
+export function normalizeRequestMethod(method) {
+    return (method ?? "GET").toUpperCase();
+}
+function formatTalizenRequestErrorMessage(status, statusText, body, request) {
+    const requestText = [request?.method, request?.url].filter(Boolean).join(" ");
+    return `Talizen request failed: ${requestText} ${status} ${statusText} ${body}`.replace(/\s+/g, " ").trim();
+}
 function getDefaultBaseUrl() {
     if (typeof window !== "undefined" && window.location?.origin) {
         return window.location.origin;

package/form.js

@@ -1,5 +1,5 @@
 import { buildCaptchaAnswer, runCaptchaVerification, shouldRetryCaptchaSubmit, } from "./captcha-ui.js";
-import { requestJson, resolveTalizenConfig, TalizenHttpError } from "./core.js";
+import { normalizeRequestMethod, requestJson, resolveTalizenConfig, stripUrlQuery, TalizenHttpError, } from "./core.js";
 export async function submitForm(keyOrToken, payload, options) {
     const formKey = getFormKey(keyOrToken);
     const data = await replaceFiles(formKey, payload, "", options);
@@ -116,6 +116,10 @@ async function uploadToSignedUrl(target, file, fieldKey, options) {
     const resolved = resolveTalizenConfig(options);
     const headers = new Headers();
     const body = file;
+    const request = {
+        method: normalizeRequestMethod("PUT"),
+        url: stripUrlQuery(target.uploadUrl),
+    };
     if (file.type) {
         headers.set("content-type", file.type);
     }
@@ -127,7 +131,7 @@ async function uploadToSignedUrl(target, file, fieldKey, options) {
     });
     if (!response.ok) {
         const text = await response.text();
-        throw new Error(`Talizen file upload failed: ${response.status} ${response.statusText} ${text}`.trim());
+        throw new Error(formatUploadError(request, `${response.status} ${response.statusText} ${text}`));
     }
 }
 function uploadWithXhr(target, file, fieldKey, options) {
@@ -135,6 +139,10 @@ function uploadWithXhr(target, file, fieldKey, options) {
         const xhr = new XMLHttpRequest();
         const signal = options.signal;
         const body = file;
+        const request = {
+            method: normalizeRequestMethod("PUT"),
+            url: stripUrlQuery(target.uploadUrl ?? ""),
+        };
         xhr.open("PUT", target.uploadUrl ?? "");
         if (file.type) {
             xhr.setRequestHeader("content-type", file.type);
@@ -150,11 +158,11 @@ function uploadWithXhr(target, file, fieldKey, options) {
                 resolve();
                 return;
             }
-            reject(new Error(`Talizen file upload failed: ${xhr.status} ${xhr.statusText} ${xhr.responseText}`.trim()));
+            reject(new Error(formatUploadError(request, `${xhr.status} ${xhr.statusText} ${xhr.responseText}`)));
         };
         xhr.onerror = () => {
             cleanup();
-            reject(new Error("Talizen file upload failed: network error"));
+            reject(new Error(formatUploadError(request, "network error")));
         };
         xhr.onabort = () => {
             cleanup();
@@ -166,6 +174,9 @@ function uploadWithXhr(target, file, fieldKey, options) {
         xhr.send(body);
     });
 }
+function formatUploadError(request, detail) {
+    return `Talizen file upload failed: ${request.method} ${request.url} ${detail}`.replace(/\s+/g, " ").trim();
+}
 async function sha256(file) {
     const subtle = globalThis.crypto?.subtle;
     if (subtle == null) {

package/i18n.d.ts

@@ -0,0 +1,55 @@
+import * as React from "react";
+/**
+ * 当前语言运行时信息。由 Talizen 渲染引擎注入到 `globalThis.__TALIZEN_I18N__`
+ * （SSR 与浏览器端注入同一份，避免 hydration 不一致）。站点未开启多语言时为空。
+ */
+export interface LocaleRuntime {
+    /** 当前生效语言；站点未配置多语言时为 ""。 */
+    locale: string;
+    /** 站点配置的全部语言。 */
+    locales: string[];
+    /** 默认语言（其 URL 无前缀）。 */
+    defaultLocale: string;
+}
+declare global {
+    var __TALIZEN_I18N__: Partial<LocaleRuntime> | undefined;
+}
+/**
+ * 读取当前语言运行时信息（当前语言 / 全部语言 / 默认语言）。SSR 与客户端返回一致。
+ * 站点未开启多语言时 `locale === ""`。
+ *
+ * ```tsx
+ * const { locale, locales, defaultLocale } = useLocale()
+ * ```
+ */
+export declare function useLocale(): LocaleRuntime;
+/**
+ * 给站内路径加语言前缀（默认语言不加前缀）。不传 `locale` 时使用当前语言。
+ * 站外链接（协议 / 协议相对 URL）与页内锚点（`#...`）原样返回。
+ *
+ * ```ts
+ * localizedPath("/blog")        // zh 页面 → "/zh/blog"；默认语言 → "/blog"
+ * localizedPath("/about", "ja") // → "/ja/about"
+ * ```
+ */
+export declare function localizedPath(path: string, locale?: string): string;
+/** 记住用户显式语言选择的 Cookie 名（检测优先级：Cookie > Accept-Language > 默认）。 */
+export declare const LOCALE_COOKIE = "CREGHT_LOCALE";
+export type LinkProps = React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    /**
+     * 指定则表示「切换到该语言」：`href` 用该语言前缀，并在点击时写 `CREGHT_LOCALE`
+     * Cookie 记住选择。不传则沿用当前语言（普通站内链接）。
+     */
+    locale?: string;
+};
+/**
+ * 语言感知的站内链接，替代裸 `<a>`：自动给 `href` 补当前语言前缀（默认语言不补）。
+ * 传 `locale` 表示语言切换（用该语言前缀，且点击时写 `CREGHT_LOCALE` 记住选择）。
+ *
+ * ```tsx
+ * <Link href="/blog">Blog</Link>            // 跟随当前语言：zh 页面 → /zh/blog
+ * <Link href="/" locale="ja">日本語</Link>  // 切到日文并记住
+ * ```
+ */
+export declare function Link(props: LinkProps): React.ReactElement;

package/i18n.js

@@ -0,0 +1,62 @@
+import * as React from "react";
+function readLocaleRuntime() {
+    const d = (typeof globalThis !== "undefined" ? globalThis.__TALIZEN_I18N__ : undefined) ?? {};
+    const locales = Array.isArray(d.locales) ? d.locales.filter((l) => typeof l === "string") : [];
+    return {
+        locale: typeof d.locale === "string" ? d.locale : "",
+        locales,
+        defaultLocale: typeof d.defaultLocale === "string" ? d.defaultLocale : (locales[0] ?? ""),
+    };
+}
+/**
+ * 读取当前语言运行时信息（当前语言 / 全部语言 / 默认语言）。SSR 与客户端返回一致。
+ * 站点未开启多语言时 `locale === ""`。
+ *
+ * ```tsx
+ * const { locale, locales, defaultLocale } = useLocale()
+ * ```
+ */
+export function useLocale() {
+    return readLocaleRuntime();
+}
+/**
+ * 给站内路径加语言前缀（默认语言不加前缀）。不传 `locale` 时使用当前语言。
+ * 站外链接（协议 / 协议相对 URL）与页内锚点（`#...`）原样返回。
+ *
+ * ```ts
+ * localizedPath("/blog")        // zh 页面 → "/zh/blog"；默认语言 → "/blog"
+ * localizedPath("/about", "ja") // → "/ja/about"
+ * ```
+ */
+export function localizedPath(path, locale) {
+    if (/^([a-z][a-z0-9+.-]*:)?\/\//i.test(path) || path.startsWith("#"))
+        return path;
+    const rt = readLocaleRuntime();
+    const target = locale ?? rt.locale;
+    if (!target || target === rt.defaultLocale)
+        return path;
+    const p = path.startsWith("/") ? path : `/${path}`;
+    return p === "/" ? `/${target}` : `/${target}${p}`;
+}
+/** 记住用户显式语言选择的 Cookie 名（检测优先级：Cookie > Accept-Language > 默认）。 */
+export const LOCALE_COOKIE = "CREGHT_LOCALE";
+/**
+ * 语言感知的站内链接，替代裸 `<a>`：自动给 `href` 补当前语言前缀（默认语言不补）。
+ * 传 `locale` 表示语言切换（用该语言前缀，且点击时写 `CREGHT_LOCALE` 记住选择）。
+ *
+ * ```tsx
+ * <Link href="/blog">Blog</Link>            // 跟随当前语言：zh 页面 → /zh/blog
+ * <Link href="/" locale="ja">日本語</Link>  // 切到日文并记住
+ * ```
+ */
+export function Link(props) {
+    const { href, locale, onClick, ...rest } = props;
+    const finalHref = localizedPath(href, locale);
+    const handleClick = (event) => {
+        if (locale && typeof document !== "undefined") {
+            document.cookie = `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; path=/; max-age=31536000; samesite=lax`;
+        }
+        onClick?.(event);
+    };
+    return React.createElement("a", { ...rest, href: finalHref, onClick: handleClick });
+}

package/index.d.ts

@@ -2,6 +2,7 @@ export * from "./core.js";
 export * from "./cms.js";
 export * from "./captcha-ui.js";
 export * from "./form.js";
+export * from "./i18n.js";
 type OneOrMany<T> = T | Array<T>;
 export interface MetadataTitle {
     default?: string;
@@ -72,3 +73,29 @@ export interface Metadata {
     openGraph?: OpenGraphMetadata | null;
     icons?: MetadataIcons | null;
 }
+/**
+ * A single site-level redirect rule, aligned with Next.js `redirects()` semantics.
+ *
+ * Declare rules in the `redirects` array of `talizen.config.ts`. A matching
+ * request is redirected before the page renders, so redirects take precedence
+ * over pages and `/public` files.
+ */
+export interface Redirect {
+    /**
+     * Source path to match. Supports exact matches (`/old-page`) and a trailing
+     * wildcard segment (`/blog/*`).
+     */
+    source: string;
+    /**
+     * Redirect target. May be an internal path (`/new-page`), a wildcard
+     * backreference (`/posts/*`), an absolute URL (`https://example.com/x`), or a
+     * protocol-relative URL (`//example.com/x`). Internal paths keep the original
+     * query string.
+     */
+    destination: string;
+    /**
+     * `true` issues a 308 permanent redirect (best for SEO); `false` issues a 307
+     * temporary redirect.
+     */
+    permanent: boolean;
+}

package/index.js

@@ -2,3 +2,4 @@ export * from "./core.js";
 export * from "./cms.js";
 export * from "./captcha-ui.js";
 export * from "./form.js";
+export * from "./i18n.js";

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "talizen",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Talizen frontend SDK types for cms, form and core.",
   "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/talizen/talizen.git"
+  },
   "sideEffects": false,
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -27,6 +31,10 @@
     "./form": {
       "types": "./form.d.ts",
       "import": "./form.js"
+    },
+    "./i18n": {
+      "types": "./i18n.d.ts",
+      "import": "./i18n.js"
     }
   }
 }