@kalutskii/foundation 0.1.11 → 0.2.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ErrorHandler, MiddlewareHandler, Context, TypedResponse } from 'hono';
+import { ErrorHandler, MiddlewareHandler, Context, TypedResponse, ValidationTargets } from 'hono';
 import z$1, { z, ZodNumber } from 'zod';
 import { Locale } from 'date-fns';
 import { SymmetricAlgorithm } from 'hono/utils/jwt/jwa';
@@ -87,6 +87,20 @@ declare function respond<T extends object = Record<string, never>, S extends Suc
     data?: T;
 }): Response & TypedResponse<APISuccess<SerializeDates<T>> | APIError, S, 'json'>;
 
+/** The subset of Hono validation targets supported for payload extraction. */
+type PayloadTarget = Extract<keyof ValidationTargets, 'json' | 'query' | 'param'>;
+/** Raw payload readers for each supported target, keyed by {@link PayloadTarget}. */
+declare const requestReaders: {
+    json: (c: Context) => Promise<unknown>;
+    query: (c: Context) => unknown;
+    param: (c: Context) => unknown;
+};
+/**
+ * Reads the raw payload from the request and validates it against the provided Zod schema.
+ * Throws an `HTTPException(400)` when validation fails or when the payload cannot be read.
+ */
+declare function requirePayload<TSchema extends z.ZodTypeAny>(c: Context, target: PayloadTarget, schema: TSchema): Promise<z.infer<TSchema>>;
+
 /**
  * Returns the current time in the specified timezone.
  * Example: getZonedTime({ tz: 'America/New_York' }) = new Date('2026-03-15T12:00:00Z')
@@ -181,4 +195,4 @@ declare class ZodJWTService<TSchema extends z$1.ZodObject<z$1.ZodRawShape>> {
     verifyOrThrow(token: string, secret: string): Promise<z$1.infer<TSchema>>;
 }
 
-export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, SUCCESS_STATUS_CODES, type SerializeDates, type SuccessStatusCode, ZodJWTService, asQueryBoolean, asQueryNumber, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, log, onHandlerError, respond, safeExecute, success };
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, SUCCESS_STATUS_CODES, type SerializeDates, type SuccessStatusCode, ZodJWTService, asQueryBoolean, asQueryNumber, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, log, onHandlerError, requestReaders, requirePayload, respond, safeExecute, success };

package/dist/index.js

@@ -130,6 +130,9 @@ function respond(c, options) {
   return c.json(success({ status: options.status, data: options.data ?? {} }), options.status);
 }
 
+// src/hono/hono.validation.ts
+import { HTTPException as HTTPException2 } from "hono/http-exception";
+
 // src/utilities/execution.utilities.ts
 async function safeExecute(fn, onError) {
   try {
@@ -141,6 +144,25 @@ async function safeExecute(fn, onError) {
   }
 }
 
+// src/hono/hono.validation.ts
+var FALLBACK_ERROR_MESSAGE = "Failed to read payload";
+var requestReaders = {
+  json: async (c) => c.req.json(),
+  query: (c) => c.req.query(),
+  param: (c) => c.req.param()
+};
+async function requirePayload(c, target, schema) {
+  return safeExecute(async () => {
+    const rawPayload = await requestReaders[target](c);
+    const parsedPayload = await schema.safeParseAsync(rawPayload);
+    if (parsedPayload.success)
+      return parsedPayload.data;
+    throw new HTTPException2(400, { message: parsedPayload.error.message });
+  }, () => {
+    throw new HTTPException2(400, { message: FALLBACK_ERROR_MESSAGE });
+  });
+}
+
 // src/utilities/serialization.utilities.ts
 import { z } from "zod";
 var asQueryNumber = (schema) => z.preprocess((v) => typeof v === "string" ? Number(v) : v, schema);
@@ -208,6 +230,8 @@ export {
   honoLoggingHandler,
   log,
   onHandlerError,
+  requestReaders,
+  requirePayload,
   respond,
   safeExecute,
   success

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalutskii/foundation",
-  "version": "0.1.11",
+  "version": "0.2.1",
   "description": "Typescript collection of most common utilities, schemas and functions among private projects.",
   "type": "module",
   "repository": {