@zudojs/api 1.0.0 → 1.0.1

package/README.md

@@ -172,7 +172,11 @@ context.metadata; // read-only snapshot keyed by key name
 
 ## Errors
 
-`normalizeAPIError(error, operationName?)` converts anything thrown into an `APIError`. Non-API errors become an `APIInternalError` with a generic message and the original on `cause` — the internal message is deliberately not copied onto the wrapper, because `BaseError.toJSON()` serializes `message`, `stack` and `cause` regardless of `expose`.
+`normalizeAPIError(error, operationName?)` converts anything thrown into an `APIError`. Non-API errors become an `APIInternalError` with a generic message and the original on `cause`, so `result.error.message` never carries a driver or library message.
+
+`cause` is there for logging, and `BaseError.toJSON()` (the logging form, also used by `JSON.stringify`) serializes it — message and stack included — regardless of `expose`. Do not hand `result.error` to `res.json()` as-is: pick the fields a client may see (`code`, `statusCode`, and `message` only when `expose` is true), or run it through `ErrorSerializer` from `@zudojs/errors`.
+
+Handlers are expected to return a promise, but a hand-rolled operation whose handler returns synchronously is executed the same way.
 
 ## License
 

package/dist/api/executor/executor.core.js

@@ -288,7 +288,11 @@ function withDeadline(promise, timeoutMs, operationName, signal) {
             reject(new APITimeoutError(timeoutMs));
         }, timeoutMs);
         signal?.addEventListener("abort", onAbort, { once: true });
-        promise.then((value) => {
+        // `Promise.resolve` rather than `promise.then`: a hand-rolled operation
+        // whose handler returns synchronously is a legal JavaScript caller, and
+        // calling `.then` on its plain value failed with "promise.then is not a
+        // function" reported as an internal error of the operation.
+        Promise.resolve(promise).then((value) => {
             cleanup();
             resolve(value);
         }, (error) => {

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@zudojs/api",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Application-facing API layer for Zudojs — operation definitions, execution context, interceptors, and transport-agnostic contracts.",
   "license": "MIT",
+  "author": {
+    "name": "Oluwayemi Oyinlola",
+    "url": "https://github.com/oyinlola-tech"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,10 +27,10 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@zudojs/errors": "1.0.0",
-    "@zudojs/constants": "1.0.0",
+    "@zudojs/errors": "1.0.1",
+    "@zudojs/constants": "1.0.1",
     "@zudojs/types": "1.0.0",
-    "@zudojs/schema": "1.0.0"
+    "@zudojs/schema": "1.0.1"
   },
   "devDependencies": {
     "typescript": "7.0.2",