talizen 0.2.11 → 0.2.13

package/README.md

@@ -216,6 +216,10 @@ export function list(input: { offset?: number }, ctx: TalizenFuncContext) {
 
 `ctx.db`, `ctx.cache`, `ctx.auth`, `ctx.request`, and `ctx.cookies` are injected by the Talizen Func runtime. `talizen/func-runtime` is a type-only authoring module; do not import runtime values from it.
 
+`ctx.request` exposes Fetch-style one-shot body readers. Use `await ctx.request.text()` when a webhook signature must be verified against the exact request bytes, `await ctx.request.json()` for parsed JSON, or `await ctx.request.arrayBuffer()` for binary input. Reading the body sets `ctx.request.bodyUsed`; a second read rejects. `ctx.response.status(code)` sets the actual HTTP response status (100-599), including statuses returned when a Func throws after setting the status. The runtime also provides `TextEncoder` and the HMAC SHA-256 subset of `crypto.subtle` (`importKey`, `sign`, and `verify`) for webhook verification.
+
+Func HTTP responses use the HTTP status code rather than a top-level `ok` field. Successful responses contain `{ result: ... }`; failed responses contain `{ error: ... }`. `invoke()` unwraps `result` for callers.
+
 ## Package Layout
 
 - `talizen/core`: shared runtime config, request helpers, and base data types.

package/core.d.ts

@@ -17,6 +17,8 @@ export interface TalizenClientConfig {
     headers?: HeadersInit;
     fetch?: typeof fetch;
     onFileUploadProcess?: TalizenFileUploadProcessCallback;
+    i18n?: Partial<TalizenLocaleRuntime>;
+    messages?: Record<string, unknown>;
 }
 export interface TalizenRequestOptions extends TalizenClientConfig {
     signal?: AbortSignal;
@@ -25,8 +27,14 @@ export interface TalizenErrorBody {
     code?: number | string;
     message?: string;
 }
+export interface TalizenLocaleRuntime {
+    locale: string;
+    locales: string[];
+    defaultLocale: string;
+}
 export declare function setTalizenConfig(config: TalizenClientConfig): void;
 export declare function getTalizenConfig(): TalizenClientConfig;
+export declare function subscribeTalizenConfig(listener: () => void): () => void;
 declare global {
     var TalizenConfig: TalizenClientConfig | undefined;
 }

package/core.js

@@ -1,13 +1,21 @@
 let talizenConfig = {};
+const talizenConfigListeners = new Set();
 export function setTalizenConfig(config) {
     talizenConfig = {
         ...talizenConfig,
         ...config,
     };
+    talizenConfigListeners.forEach(listener => listener());
 }
 export function getTalizenConfig() {
     return talizenConfig;
 }
+export function subscribeTalizenConfig(listener) {
+    talizenConfigListeners.add(listener);
+    return () => {
+        talizenConfigListeners.delete(listener);
+    };
+}
 export function resolveTalizenConfig(config) {
     // globalThis is the global object in the browser and node.js
     const globalTalizenConfig = typeof globalThis !== "undefined" ? globalThis.TalizenConfig : {};

package/func-runtime.d.ts

@@ -74,6 +74,13 @@ export interface FuncRequestRuntime {
     path: string;
     headers: FuncReadonlyStringMap;
     cookies: FuncReadonlyStringMap;
+    readonly bodyUsed: boolean;
+    text(): Promise<string>;
+    json<T = unknown>(): Promise<T>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export interface FuncResponseRuntime {
+    status(code: number): void;
 }
 export interface FuncCookieSetOptions {
     path?: string;
@@ -96,6 +103,7 @@ export interface TalizenFuncContext {
     trace_id: string;
     extra?: Record<string, unknown>;
     request: FuncRequestRuntime;
+    response: FuncResponseRuntime;
     db: FuncDbRuntime;
     auth: FuncAuthRuntime;
     cache: FuncCacheRuntime;

package/func.d.ts

@@ -4,7 +4,6 @@ export interface FuncLogEntry {
     text: string;
 }
 export interface FuncRunResponse<T = unknown> {
-    ok: boolean;
     result?: T;
     logs?: FuncLogEntry[];
     error?: string;
@@ -13,7 +12,8 @@ export declare class TalizenFuncError extends Error {
     readonly key: string;
     readonly method: string;
     readonly logs: FuncLogEntry[];
-    constructor(key: string, method: string, message: string, logs?: FuncLogEntry[]);
+    readonly status: number;
+    constructor(key: string, method: string, message: string, logs?: FuncLogEntry[], status?: number);
 }
 export declare function invoke<T = unknown>(name: string, input?: unknown, options?: RunFuncOptions): Promise<T>;
 export interface RunFuncOptions extends TalizenRequestOptions {

package/func.js

@@ -1,14 +1,16 @@
-import { requestJson, } from "./core.js";
+import { requestJson, TalizenHttpError, } from "./core.js";
 export class TalizenFuncError extends Error {
     key;
     method;
     logs;
-    constructor(key, method, message, logs) {
+    status;
+    constructor(key, method, message, logs, status = 200) {
         super(message);
         this.name = "TalizenFuncError";
         this.key = key;
         this.method = method;
         this.logs = logs ?? [];
+        this.status = status;
     }
 }
 export async function invoke(name, input, options) {
@@ -23,15 +25,42 @@ export async function runFunc(key, input, options) {
     const method = normalizeFuncMethod(options?.method);
     const timeoutMS = normalizeTimeoutMS(options?.timeoutMS ?? options?.timeoutMs);
     const path = `/func/${encodeFuncKey(normalizedKey)}${method === "main" ? "" : `.${encodeURIComponent(method)}`}${timeoutMS ? `?timeout_ms=${timeoutMS}` : ""}`;
-    const response = await requestJson(path, {
-        method: "POST",
-        body: JSON.stringify(input ?? {}),
-    }, options);
-    if (!response.ok) {
+    let response;
+    try {
+        response = await requestJson(path, {
+            method: "POST",
+            body: JSON.stringify(input ?? {}),
+        }, options);
+    }
+    catch (error) {
+        if (error instanceof TalizenHttpError) {
+            throw new TalizenFuncError(normalizedKey, method, funcHttpErrorMessage(error), undefined, error.status);
+        }
+        throw error;
+    }
+    if (response.error) {
         throw new TalizenFuncError(normalizedKey, method, response.error || "Talizen func failed.", response.logs);
     }
     return response.result;
 }
+function funcHttpErrorMessage(error) {
+    try {
+        const payload = JSON.parse(error.body);
+        if (typeof payload.error === "string") {
+            return payload.error;
+        }
+        if (payload.error && typeof payload.error === "object") {
+            const message = payload.error.message;
+            if (typeof message === "string") {
+                return message;
+            }
+        }
+    }
+    catch {
+        // Fall through to the HTTP error body.
+    }
+    return error.body || error.message || "Talizen func failed.";
+}
 export function parseInvokeName(name) {
     const normalized = normalizeFuncKey(name);
     const lastSlash = normalized.lastIndexOf("/");

package/i18n.d.ts

@@ -1,16 +1,10 @@
 import * as React from "react";
+import { type TalizenLocaleRuntime } from "./core.js";
 /**
- * 当前语言运行时信息。由 Talizen 渲染引擎注入到 `globalThis.__TALIZEN_I18N__`
- * （SSR 与浏览器端注入同一份，避免 hydration 不一致）。站点未开启多语言时为空。
+ * 当前语言运行时信息。由 Talizen 渲染引擎写入 TalizenConfig.i18n
+ * （旧版 globalThis.__TALIZEN_I18N__ 仍作为兼容 fallback）。站点未开启多语言时为空。
  */
-export interface LocaleRuntime {
-    /** 当前生效语言；站点未配置多语言时为 ""。 */
-    locale: string;
-    /** 站点配置的全部语言。 */
-    locales: string[];
-    /** 默认语言（其 URL 无前缀）。 */
-    defaultLocale: string;
-}
+export type LocaleRuntime = TalizenLocaleRuntime;
 declare global {
     var __TALIZEN_I18N__: Partial<LocaleRuntime> | undefined;
 }

package/i18n.js

@@ -1,6 +1,24 @@
 import * as React from "react";
-function readLocaleRuntime() {
-    const d = (typeof globalThis !== "undefined" ? globalThis.__TALIZEN_I18N__ : undefined) ?? {};
+import { getTalizenConfig, subscribeTalizenConfig } from "./core.js";
+let lastSnapshot = null;
+let lastSnapshotI18n;
+let lastSnapshotMessages;
+function readI18nRuntimeConfig() {
+    const config = getTalizenConfig();
+    const fallbackI18n = typeof globalThis !== "undefined" ? globalThis.__TALIZEN_I18N__ : undefined;
+    const fallbackMessages = typeof globalThis !== "undefined" ? globalThis.__TALIZEN_MESSAGES__ : undefined;
+    const i18n = config.i18n ?? fallbackI18n;
+    const messages = config.messages ?? fallbackMessages ?? {};
+    if (lastSnapshot && lastSnapshotI18n === i18n && lastSnapshotMessages === messages) {
+        return lastSnapshot;
+    }
+    lastSnapshotI18n = i18n;
+    lastSnapshotMessages = messages;
+    lastSnapshot = { i18n, messages };
+    return lastSnapshot;
+}
+function normalizeLocaleRuntime(value) {
+    const d = value ?? {};
     const locales = Array.isArray(d.locales) ? d.locales.filter((l) => typeof l === "string") : [];
     return {
         locale: typeof d.locale === "string" ? d.locale : "",
@@ -8,6 +26,9 @@ function readLocaleRuntime() {
         defaultLocale: typeof d.defaultLocale === "string" ? d.defaultLocale : (locales[0] ?? ""),
     };
 }
+function readLocaleRuntime() {
+    return normalizeLocaleRuntime(readI18nRuntimeConfig().i18n);
+}
 /**
  * 读取当前语言运行时信息（当前语言 / 全部语言 / 默认语言）。SSR 与客户端返回一致。
  * 站点未开启多语言时 `locale === ""`。
@@ -17,7 +38,8 @@ function readLocaleRuntime() {
  * ```
  */
 export function useLocale() {
-    return readLocaleRuntime();
+    const snapshot = React.useSyncExternalStore(subscribeTalizenConfig, readI18nRuntimeConfig, readI18nRuntimeConfig);
+    return normalizeLocaleRuntime(snapshot.i18n);
 }
 /**
  * 读取当前语言运行时信息——与 useLocale() 完全等价，但命名为 get*（**不是 hook**），
@@ -67,6 +89,7 @@ export const LOCALE_COOKIE = "CREGHT_LOCALE";
  */
 export function Link(props) {
     const { href, locale, onClick, ...rest } = props;
+    useLocale();
     const finalHref = localizedPath(href, locale);
     const handleClick = (event) => {
         if (locale && typeof document !== "undefined") {
@@ -77,7 +100,7 @@ export function Link(props) {
     return React.createElement("a", { ...rest, href: finalHref, onClick: handleClick });
 }
 function readMessages() {
-    return (typeof globalThis !== "undefined" ? globalThis.__TALIZEN_MESSAGES__ : undefined) ?? {};
+    return readI18nRuntimeConfig().messages;
 }
 function lookupMessage(obj, path) {
     let cur = obj;
@@ -99,8 +122,8 @@ function lookupMessage(obj, path) {
  *
  * UI chrome 用 useTranslations；文章等内容用 CMS 字段级 _i18n（见 listContents/getContent）。
  */
-function buildTranslator(namespace) {
-    const messages = readMessages();
+function buildTranslator(namespace, sourceMessages) {
+    const messages = sourceMessages ?? readMessages();
     const scoped = namespace ? lookupMessage(messages, namespace) : messages;
     const base = (scoped && typeof scoped === "object" ? scoped : {});
     return (key, vars) => {
@@ -112,7 +135,8 @@ function buildTranslator(namespace) {
     };
 }
 export function useTranslations(namespace) {
-    return buildTranslator(namespace);
+    const snapshot = React.useSyncExternalStore(subscribeTalizenConfig, readI18nRuntimeConfig, readI18nRuntimeConfig);
+    return React.useMemo(() => buildTranslator(namespace, snapshot.messages), [namespace, snapshot]);
 }
 /**
  * 读取 UI 文案翻译器——与 useTranslations() 等价，但命名为 get*（**不是 hook**），

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talizen",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Talizen frontend SDK types for cms, form and core.",
   "type": "module",
   "license": "MIT",