@weave-js/core 0.15.3 → 0.16.0

package/lib/utils/restoreError.js

@@ -1,5 +1,30 @@
 const errors = require('../errors');
 
+/**
+ * Restore a Weave error from a serialized error payload
+ *
+ * Reconstructs proper error instances from serialized error data received
+ * over the network. Handles all Weave-specific error types with their
+ * specific constructor signatures and fallback to generic Error for
+ * unknown error types.
+ *
+ * Supported error types:
+ * - WeaveError, WeaveRetryableError: Standard errors with message and options
+ * - WeaveParameterValidationError, WeaveBrokerOptionsError: Validation errors
+ * - WeaveServiceNotFoundError, WeaveServiceNotAvailableError: Service errors
+ * - WeaveQueueSizeExceededError, WeaveMaxCallLevelError: Resource errors
+ * - WeaveRequestTimeoutError: Timeout-specific errors with action/node context
+ * - WeaveGracefulStopTimeoutError: Shutdown timeout errors
+ *
+ * @param {Object} errorPayload Serialized error payload from network transport
+ * @param {string} errorPayload.name Error class name
+ * @param {string} errorPayload.message Error message
+ * @param {Object} [errorPayload.data] Error-specific data
+ * @param {string} [errorPayload.stack] Original stack trace
+ * @param {string} [errorPayload.code] Error code
+ * @param {string} [errorPayload.nodeId] Node ID where error occurred
+ * @returns {Error} Restored error instance with proper type and properties
+ */
 const restoreError = (errorPayload) => {
   const ErrorClass = errors[errorPayload.name];
   let error;

package/lib/utils/wrap-handler.js

@@ -0,0 +1,22 @@
+const { isFunction } = require('@weave-js/utils/lib/is-function');
+
+/**
+ * Wrap a function or handler object into a standardized handler format
+ *
+ * Normalizes action and event handlers to ensure consistent structure.
+ * Functions are wrapped into objects with a 'handler' property, while
+ * existing handler objects are passed through unchanged.
+ *
+ * This allows handlers to be defined as either simple functions or
+ * objects with additional properties (middleware, validation, etc).
+ *
+ * @param {Function | import('@weave-js/utils').Handler} action Action function or handler object
+ * @returns {import('@weave-js/utils').Handler} Normalized handler object with 'handler' property
+ * @example
+ * // Function input
+ * wrapHandler((ctx) => { ... }) // Returns: { handler: (ctx) => { ... } }
+ *
+ * // Object input
+ * wrapHandler({ handler: (ctx) => { ... }, cache: true }) // Returns: { handler: (ctx) => { ... }, cache: true }
+ */
+exports.wrapHandler = (action) => isFunction(action) ? { handler: action } : action;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weave-js/core",
-  "version": "0.15.3",
+  "version": "0.16.0",
   "description": "The core package of weave",
   "keywords": [
     "Weave",
@@ -18,6 +18,7 @@
     "Micro"
   ],
   "main": "./lib/index.js",
+  "types": "./types/index.d.ts",
   "scripts": {
     "ci": "jest --watch",
     "test": "NODE_ENV=test jest --no-cache --runInBand",