fix(core): update

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@api.global/typedrequest',
-  version: '3.0.26',
+  version: '3.0.27',
   description: 'A TypeScript library for making typed requests towards APIs, including facilities for handling requests, routing, and virtual stream handling.'
 }

ts/classes.typedhandler.ts

@@ -1,8 +1,10 @@
 import * as plugins from './plugins.js';
 import { TypedResponseError } from './classes.typedresponseerror.js';
+import { TypedTools } from './classes.typedtools.js';
 
 export type THandlerFunction<T extends plugins.typedRequestInterfaces.ITypedRequest> = (
-  requestArg: T['request']
+  requestArg: T['request'],
+  typedToolsArg?: any
 ) => Promise<T['response']>;
 
 /**
@@ -28,7 +30,8 @@ export class TypedHandler<T extends plugins.typedRequestInterfaces.ITypedRequest
       );
     }
     let typedResponseError: TypedResponseError;
-    const response = await this.handlerFunction(typedRequestArg.request).catch((e) => {
+    const typedtoolsInstance = new TypedTools();
+    const response = await this.handlerFunction(typedRequestArg.request, typedtoolsInstance).catch((e) => {
       if (e instanceof TypedResponseError) {
         typedResponseError = e;
       } else {

ts/classes.typedtools.ts

@@ -0,0 +1,13 @@
+import { TypedResponseError } from './classes.typedresponseerror.js';
+import * as plugins from './plugins.js';
+
+export class TypedTools {
+  public async passGuards<T = any>(guardsArg: plugins.smartguard.Guard<T>[], dataArg: T) {
+    const guardSet = new plugins.smartguard.GuardSet<T>(guardsArg);
+    const guardResult = await guardSet.allGuardsPass(dataArg);
+    if (!guardResult) {
+      const failedHint = await guardSet.getFailedHint(dataArg);
+      throw new TypedResponseError(`guard failed: ${failedHint}`, { failedHint });
+    }
+  }
+}