@nvwa-app/sdk-functions 6.48.0 → 6.49.0

package/dist/index.d.mts

@@ -142,7 +142,11 @@ interface CapabilityExecuteResponse<Data = unknown> {
 }
 /**
  * 在 Edge Function 中调用已开通的 Nvwa capability（经 Server internal HMAC 路由）。
- * 需在环境中配置 NVWA_SERVER_BASE_URL、NVWA_INTERNAL_SECRET、NVWA_PROJECT_CODE（与 Runtime nvwa.json server 块一致）。
+ *
+ * 环境变量与 nvwa.json `server` 一致；**优先使用 `NVWA_*`**（Agent Pod 会注入），未设置时可回退：
+ * - `NVWA_SERVER_BASE_URL` → `WORKSPACE_BASE_URL`
+ * - `NVWA_INTERNAL_SECRET` → `RUNTIME_PROJECT_INTERNAL_KEY`
+ * - `NVWA_PROJECT_CODE` → `PROJECT_CODE`
  */
 declare function executeCapability<Result = unknown>(capabilityName: string, param?: unknown, options?: ExecuteCapabilityOptions): Promise<Result | undefined>;
 

package/dist/index.d.ts

@@ -142,7 +142,11 @@ interface CapabilityExecuteResponse<Data = unknown> {
 }
 /**
  * 在 Edge Function 中调用已开通的 Nvwa capability（经 Server internal HMAC 路由）。
- * 需在环境中配置 NVWA_SERVER_BASE_URL、NVWA_INTERNAL_SECRET、NVWA_PROJECT_CODE（与 Runtime nvwa.json server 块一致）。
+ *
+ * 环境变量与 nvwa.json `server` 一致；**优先使用 `NVWA_*`**（Agent Pod 会注入），未设置时可回退：
+ * - `NVWA_SERVER_BASE_URL` → `WORKSPACE_BASE_URL`
+ * - `NVWA_INTERNAL_SECRET` → `RUNTIME_PROJECT_INTERNAL_KEY`
+ * - `NVWA_PROJECT_CODE` → `PROJECT_CODE`
  */
 declare function executeCapability<Result = unknown>(capabilityName: string, param?: unknown, options?: ExecuteCapabilityOptions): Promise<Result | undefined>;
 

package/dist/index.js

@@ -366,27 +366,29 @@ async function hmacSha256Hex(secret, content) {
   return bytesToHex(new Uint8Array(signature));
 }
 function resolveServerBaseUrl(explicit) {
-  const url = explicit ?? getEnv("NVWA_SERVER_BASE_URL");
+  const url = explicit ?? getEnv("NVWA_SERVER_BASE_URL") ?? getEnv("WORKSPACE_BASE_URL");
   if (!url) {
     throw new Error(
-      "NVWA_SERVER_BASE_URL is not set; executeCapability requires Workspace server base URL (same as nvwa.json server.baseUrl)"
+      "Workspace server base URL is not set; set NVWA_SERVER_BASE_URL (preferred) or WORKSPACE_BASE_URL \u2014 same as nvwa.json server.baseUrl"
     );
   }
   return url.replace(/\/$/, "");
 }
 function resolveInternalSecret(explicit) {
-  const s = explicit ?? getEnv("NVWA_INTERNAL_SECRET");
+  const s = explicit ?? getEnv("NVWA_INTERNAL_SECRET") ?? getEnv("RUNTIME_PROJECT_INTERNAL_KEY");
   if (!s) {
     throw new Error(
-      "NVWA_INTERNAL_SECRET is not set; must match project runtime internal HMAC secret"
+      "Internal HMAC secret is not set; set NVWA_INTERNAL_SECRET (preferred) or RUNTIME_PROJECT_INTERNAL_KEY \u2014 same as nvwa.json server.internalSecret"
     );
   }
   return s;
 }
 function resolveProjectCode(explicit) {
-  const c = explicit ?? getEnv("NVWA_PROJECT_CODE");
+  const c = explicit ?? getEnv("NVWA_PROJECT_CODE") ?? getEnv("PROJECT_CODE");
   if (!c) {
-    throw new Error("NVWA_PROJECT_CODE is not set");
+    throw new Error(
+      "Project code is not set; set NVWA_PROJECT_CODE (preferred) or PROJECT_CODE"
+    );
   }
   return c;
 }

package/dist/index.mjs

@@ -317,27 +317,29 @@ async function hmacSha256Hex(secret, content) {
   return bytesToHex(new Uint8Array(signature));
 }
 function resolveServerBaseUrl(explicit) {
-  const url = explicit ?? getEnv("NVWA_SERVER_BASE_URL");
+  const url = explicit ?? getEnv("NVWA_SERVER_BASE_URL") ?? getEnv("WORKSPACE_BASE_URL");
   if (!url) {
     throw new Error(
-      "NVWA_SERVER_BASE_URL is not set; executeCapability requires Workspace server base URL (same as nvwa.json server.baseUrl)"
+      "Workspace server base URL is not set; set NVWA_SERVER_BASE_URL (preferred) or WORKSPACE_BASE_URL \u2014 same as nvwa.json server.baseUrl"
     );
   }
   return url.replace(/\/$/, "");
 }
 function resolveInternalSecret(explicit) {
-  const s = explicit ?? getEnv("NVWA_INTERNAL_SECRET");
+  const s = explicit ?? getEnv("NVWA_INTERNAL_SECRET") ?? getEnv("RUNTIME_PROJECT_INTERNAL_KEY");
   if (!s) {
     throw new Error(
-      "NVWA_INTERNAL_SECRET is not set; must match project runtime internal HMAC secret"
+      "Internal HMAC secret is not set; set NVWA_INTERNAL_SECRET (preferred) or RUNTIME_PROJECT_INTERNAL_KEY \u2014 same as nvwa.json server.internalSecret"
     );
   }
   return s;
 }
 function resolveProjectCode(explicit) {
-  const c = explicit ?? getEnv("NVWA_PROJECT_CODE");
+  const c = explicit ?? getEnv("NVWA_PROJECT_CODE") ?? getEnv("PROJECT_CODE");
   if (!c) {
-    throw new Error("NVWA_PROJECT_CODE is not set");
+    throw new Error(
+      "Project code is not set; set NVWA_PROJECT_CODE (preferred) or PROJECT_CODE"
+    );
   }
   return c;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nvwa-app/sdk-functions",
-  "version": "6.48.0",
+  "version": "6.49.0",
   "description": "NVWA Edge Functions SDK: db, payment gateway, auth, provider list. Use in Deno: import from 'npm:@nvwa-app/sdk-functions'.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -24,7 +24,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@nvwa-app/sdk-shared": "^6.48.0",
+    "@nvwa-app/sdk-shared": "^6.49.0",
     "drizzle-orm": "^0.44.7",
     "postgres": "^3.4.8"
   },