@zintrust/core 3.0.4 → 3.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

package/src/http/Kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Kernel.d.ts","sourceRoot":"","sources":["../../../src/http/Kernel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK7E,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAgBpE,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/C,wBAAwB,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC5D,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACpE,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IAGvC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5C,cAAc,IAAI,IAAI,CAAC;IACvB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AA4XD,eAAO,MAAM,MAAM;qBAvEK,OAAO,aAAa,iBAAiB,KAAG,OAAO;EAyErE,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Kernel.d.ts","sourceRoot":"","sources":["../../../src/http/Kernel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK7E,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAgBpE,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/C,wBAAwB,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC5D,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACpE,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IAGvC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5C,cAAc,IAAI,IAAI,CAAC;IACvB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AA8ZD,eAAO,MAAM,MAAM;qBAvEK,OAAO,aAAa,iBAAiB,KAAG,OAAO;EAyErE,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/src/http/Kernel.js

@@ -111,41 +111,39 @@ const maybeSetKernelTraceRoute = (traceSpan, method, routeLabel) => {
         return;
     OpenTelemetry.setHttpRoute(traceSpan.span, method, routeLabel);
 };
-const runKernelPipeline = async (router, globalMiddleware, routeMiddleware, req, res, context, traceSpan) => {
-    const route = resolveRouteWithPreflightFallback(router, req.getMethod(), req.getPath());
-    if (route === null) {
-        const routeLabel = 'not_found';
-        maybeSetKernelTraceRoute(traceSpan, context.method, routeLabel);
-        const handleNotFound = ErrorRouting.handleNotFound;
-        await handleNotFound(req, res, context.requestId);
-        return routeLabel;
-    }
-    // Safe type guard to ensure route.routePath is a non-empty string before calling .trim()
-    const hasNonEmptyRoutePath = (r) => {
-        if (typeof r !== 'object' || r === null)
-            return false;
-        const rp = r.routePath;
-        return typeof rp === 'string' && rp.trim() !== '';
+const runMiddlewareChain = async (middleware, req, res, terminal) => {
+    let index = 0;
+    const next = async () => {
+        if (index < middleware.length) {
+            const mw = middleware[index++];
+            await mw(req, res, next);
+            return;
+        }
+        await terminal();
     };
-    const routeLabel = hasNonEmptyRoutePath(route) ? route.routePath : req.getPath();
-    maybeSetKernelTraceRoute(traceSpan, context.method, routeLabel);
-    // Use a typed view of the matched route to avoid unsafe member access
-    const matchedRoute = route;
-    // Coerce route params (which may be undefined or non-string) into the
-    // expected Record<string, string> shape required by Request.setParams.
+    await next();
+};
+// Safe type guard to ensure route.routePath is a non-empty string before calling .trim()
+const hasNonEmptyRoutePath = (r) => {
+    if (typeof r !== 'object' || r === null)
+        return false;
+    const rp = r.routePath;
+    return typeof rp === 'string' && rp.trim() !== '';
+};
+const coerceRouteParams = (params) => {
     const safeParams = {};
-    if (typeof matchedRoute.params === 'object' && matchedRoute.params !== null) {
-        for (const [k, v] of Object.entries(matchedRoute.params)) {
-            if (v === undefined || v === null)
-                continue;
-            safeParams[k] = typeof v === 'string' ? v : String(v);
-        }
+    if (typeof params !== 'object' || params === null)
+        return safeParams;
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined || v === null)
+            continue;
+        safeParams[k] = typeof v === 'string' ? v : String(v);
     }
-    req.setParams(safeParams);
-    const routeMiddlewareNames = getRouteMiddlewareNames(matchedRoute);
-    req.context['traceRouteMiddleware'] = routeMiddlewareNames;
+    return safeParams;
+};
+const resolveWrappedRouteMiddleware = (routeMiddlewareNames, routeMiddleware) => {
     const traceMiddlewareEmitter = getTraceMiddlewareEmitter();
-    const resolvedRouteMiddleware = routeMiddlewareNames
+    return routeMiddlewareNames
         .map((name) => ({ name, middleware: routeMiddleware[name] }))
         .filter((entry) => typeof entry.middleware === 'function')
         .map(({ name, middleware }) => {
@@ -163,17 +161,37 @@ const runKernelPipeline = async (router, globalMiddleware, routeMiddleware, req,
         };
         return wrapped;
     });
-    const middlewareToRun = [...globalMiddleware, ...resolvedRouteMiddleware];
-    let index = 0;
-    const next = async () => {
-        if (index < middlewareToRun.length) {
-            const mw = middlewareToRun[index++];
-            await mw(req, res, next);
-            return;
-        }
+};
+const runNotFoundPipeline = async (globalMiddleware, req, res, context, traceSpan) => {
+    // Run global middleware (including HttpWatcher) so routing 404s are still observed.
+    // Route middleware is intentionally skipped — there is no matched route.
+    const routeLabel = 'not_found';
+    maybeSetKernelTraceRoute(traceSpan, context.method, routeLabel);
+    req.context['traceRouteMiddleware'] = [];
+    const handleNotFound = ErrorRouting.handleNotFound;
+    await runMiddlewareChain(globalMiddleware, req, res, async () => {
+        await handleNotFound(req, res, context.requestId);
+    });
+    return routeLabel;
+};
+const runKernelPipeline = async (router, globalMiddleware, routeMiddleware, req, res, context, traceSpan) => {
+    const route = resolveRouteWithPreflightFallback(router, req.getMethod(), req.getPath());
+    if (route === null) {
+        return runNotFoundPipeline(globalMiddleware, req, res, context, traceSpan);
+    }
+    const matchedRoute = route;
+    const routeLabel = hasNonEmptyRoutePath(matchedRoute) ? matchedRoute.routePath : req.getPath();
+    maybeSetKernelTraceRoute(traceSpan, context.method, routeLabel);
+    req.setParams(coerceRouteParams(matchedRoute.params));
+    const routeMiddlewareNames = getRouteMiddlewareNames(matchedRoute);
+    req.context['traceRouteMiddleware'] = routeMiddlewareNames;
+    const middlewareToRun = [
+        ...globalMiddleware,
+        ...resolveWrappedRouteMiddleware(routeMiddlewareNames, routeMiddleware),
+    ];
+    await runMiddlewareChain(middlewareToRun, req, res, async () => {
         await matchedRoute.handler(req, res);
-    };
-    await next();
+    });
     return routeLabel;
 };
 const finalizeKernelObservability = (context, res, routeLabel, thrown, traceSpan) => {

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v3.0.4
+ * @zintrust/core v3.0.5
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-07-14T19:37:30.278Z
+ *   Built: 2026-07-16T10:25:51.056Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -21,7 +21,7 @@
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.41';
-export const ZINTRUST_BUILD_DATE = '2026-07-14T19:37:30.239Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-07-16T10:25:51.018Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/worker-runtime/rpc-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../../src/worker-runtime/rpc-client.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAWF,eAAO,MAAM,oBAAoB,QAAO,OAAkC,CAAC;AAE3E,eAAO,MAAM,4BAA4B,QAAO,MAI/C,CAAC;AAOF,eAAO,MAAM,8BAA8B,QAAO,OAC0B,CAAC;AAiO7E,wFAAwF;AACxF,eAAO,MAAM,OAAO,GAClB,WAAW,MAAM,EACjB,qBAAqB,MAAM,KAC1B,OAAO,CAAC,SAAS,GAAG,SAAS,CAkB/B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,MAAM,GACjB,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,cAAc,OAAO,KACpB,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,OAAO,GAAU,WAAW,MAAM,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAW5F,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,gBAAgB,EAAE,CAO9D,CAAC"}
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../../src/worker-runtime/rpc-client.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAWF,eAAO,MAAM,oBAAoB,QAAO,OAAkC,CAAC;AAE3E,eAAO,MAAM,4BAA4B,QAAO,MAI/C,CAAC;AAOF,eAAO,MAAM,8BAA8B,QAAO,OAC0B,CAAC;AAkO7E,wFAAwF;AACxF,eAAO,MAAM,OAAO,GAClB,WAAW,MAAM,EACjB,qBAAqB,MAAM,KAC1B,OAAO,CAAC,SAAS,GAAG,SAAS,CAkB/B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,MAAM,GACjB,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,cAAc,OAAO,KACpB,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,OAAO,GAAU,WAAW,MAAM,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAW5F,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,gBAAgB,EAAE,CAO9D,CAAC"}

package/src/worker-runtime/rpc-client.js

@@ -44,6 +44,8 @@ const queuePayload = (extra) => {
     return db === undefined ? extra : { db, ...extra };
 };
 const hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+const isPullJobId = (value) => (typeof value === 'string' && value.trim() !== '') ||
+    (typeof value === 'number' && Number.isFinite(value));
 const parseHeaderEnv = (key) => {
     const raw = Env.get(key, '').trim();
     if (raw === '')
@@ -145,6 +147,24 @@ const call = async (service, method, payload = {}) => {
     }
     return parsed.result;
 };
+const resolvePulledJobPayload = (record) => {
+    if (hasOwn(record, 'payload'))
+        return record['payload'];
+    if (hasOwn(record, 'data'))
+        return record['data'];
+    throw ErrorFactory.createConfigError('Worker queue pull returned a job without payload/data');
+};
+const resolvePulledJobAttempts = (record) => {
+    const rawAttempts = hasOwn(record, 'attempts') ? record['attempts'] : record['attemptsMade'];
+    return typeof rawAttempts === 'number' && Number.isFinite(rawAttempts)
+        ? Math.max(0, Math.floor(rawAttempts))
+        : 0;
+};
+const resolvePulledJobName = (record) => {
+    return typeof record['name'] === 'string' && record['name'].trim() !== ''
+        ? record['name'].trim()
+        : 'default';
+};
 const normalizePulledJob = (raw) => {
     if (raw === null || raw === undefined)
         return undefined;
@@ -153,27 +173,14 @@ const normalizePulledJob = (raw) => {
     }
     const record = raw;
     const rawId = record['id'];
-    if (!((typeof rawId === 'string' && rawId.trim() !== '') ||
-        (typeof rawId === 'number' && Number.isFinite(rawId)))) {
+    if (!isPullJobId(rawId)) {
         throw ErrorFactory.createConfigError('Worker queue pull returned a job without an id');
     }
-    const hasPayload = hasOwn(record, 'payload');
-    const hasData = hasOwn(record, 'data');
-    if (!hasPayload && !hasData) {
-        throw ErrorFactory.createConfigError('Worker queue pull returned a job without payload/data');
-    }
-    const rawAttempts = hasOwn(record, 'attempts') ? record['attempts'] : record['attemptsMade'];
-    const attempts = typeof rawAttempts === 'number' && Number.isFinite(rawAttempts)
-        ? Math.max(0, Math.floor(rawAttempts))
-        : 0;
-    const name = typeof record['name'] === 'string' && record['name'].trim() !== ''
-        ? record['name'].trim()
-        : 'default';
     return {
         id: String(rawId),
-        name,
-        payload: hasPayload ? record['payload'] : record['data'],
-        attempts,
+        name: resolvePulledJobName(record),
+        payload: resolvePulledJobPayload(record),
+        attempts: resolvePulledJobAttempts(record),
     };
 };
 const createZedgiBullMqError = (method, error) => {