@ubean/shared 0.5.2 → 0.6.0-beta.2

package/dist/index.d.ts

@@ -399,6 +399,18 @@ export interface EnvValidationError {
 export declare function defineEnv<S extends EnvSchema>(config: EnvConfig<S>): DefineEnvResult<S>;
 export declare function setRuntimeEnv(env: Record<string, unknown>): void;
 export declare function useRuntimeEnv<T = string>(key: string, defaultValue?: T): T;
+/**
+ * 当前是否运行在 Node 系运行时（Node / Bun / Deno 的 node 兼容层）上。
+ *
+ * 用途：**把 Node 专用能力挡在动态 import 里**。Cloudflare Workers 这类运行时没有 `node:fs`
+ * （即使开 `nodejs_compat` 也不支持），而打包器会把「静态 import 的 node 内建」留在产物里 ——
+ * workerd 在**模块实例化**阶段就会失败（`No such module "node:fs/promises"`），根本轮不到分支
+ * 判断。因此判据必须是运行时的，且 `import()` 必须写在分支内部（动态 import 只在执行时才解析）。
+ *
+ * 判定用 `process.versions.node` 而不是 `typeof process`：bundler 常会把 `process` 替身注入浏览器
+ * 产物，只看 `process` 会在 worker/browser 里误判为真。
+ */
+export declare function isNodeRuntime(): boolean;
 //#endregion
 //#region src/path.d.ts
 /**

package/dist/index.js

@@ -252,6 +252,21 @@ function setRuntimeEnv(env) {
 function useRuntimeEnv(key, defaultValue) {
 	return _runtimeEnv[key] ?? defaultValue;
 }
+/**
+* 当前是否运行在 Node 系运行时（Node / Bun / Deno 的 node 兼容层）上。
+*
+* 用途：**把 Node 专用能力挡在动态 import 里**。Cloudflare Workers 这类运行时没有 `node:fs`
+* （即使开 `nodejs_compat` 也不支持），而打包器会把「静态 import 的 node 内建」留在产物里 ——
+* workerd 在**模块实例化**阶段就会失败（`No such module "node:fs/promises"`），根本轮不到分支
+* 判断。因此判据必须是运行时的，且 `import()` 必须写在分支内部（动态 import 只在执行时才解析）。
+*
+* 判定用 `process.versions.node` 而不是 `typeof process`：bundler 常会把 `process` 替身注入浏览器
+* 产物，只看 `process` 会在 worker/browser 里误判为真。
+*/
+function isNodeRuntime() {
+	const proc = globalThis.process;
+	return typeof proc?.versions?.node === "string" || typeof proc?.versions?.bun === "string";
+}
 //#endregion
 //#region src/string.ts
 /**
@@ -336,4 +351,4 @@ function matchAnyGlob(route, patterns) {
 	return patterns.some((p) => matchGlob(route, p));
 }
 //#endregion
-export { ACTION_BRAND, ActionError, UbeanError, capitalize, createError, defineEnv, errorToResponse, fail, getBasename, getDirname, getExtension, getStem, isActionFailure, isServerAction, isUbeanError, matchAnyGlob, matchGlob, normalizePath, pathToTitle, setRuntimeEnv, useRuntimeEnv };
+export { ACTION_BRAND, ActionError, UbeanError, capitalize, createError, defineEnv, errorToResponse, fail, getBasename, getDirname, getExtension, getStem, isActionFailure, isNodeRuntime, isServerAction, isUbeanError, matchAnyGlob, matchGlob, normalizePath, pathToTitle, setRuntimeEnv, useRuntimeEnv };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/shared",
-  "version": "0.5.2",
+  "version": "0.6.0-beta.2",
   "description": "Shared protocol types, errors, env and universal utilities for ubean",
   "files": [
     "dist"
@@ -29,16 +29,16 @@
   },
   "dependencies": {
     "@standard-schema/spec": "1.1.0",
-    "hono": "4.13.7",
+    "hono": "4.13.8",
     "pathe": "^2.0.3",
     "scule": "^1.3.0",
     "tslog": "^5.2.0",
     "ufo": "1.6.4"
   },
   "devDependencies": {
-    "@types/node": "^26.5.0",
+    "@types/node": "^26.6.1",
     "typescript": "npm:typescript-native-bridge@latest",
-    "vite-plus": "0.3.1"
+    "vite-plus": "0.3.3"
   },
   "scripts": {
     "build": "vp pack",