@kalutskii/foundation 0.1.6 → 0.1.9

package/README.md

@@ -1,6 +1,7 @@
 # @kalutskii/foundation
 
-Collection of utilities, types, and helpers for building typed API contracts and responses in TypeScript projects. Designed for use in Bun/Node.js and Cloudflare Workers environments.
+Collection of utilities, types, and helpers for building typed API contracts and responses in TypeScript projects.
+Designed for use in Bun/Node.js and Cloudflare Workers environments.
 
 ## What this package provides
 
@@ -62,7 +63,7 @@ declare function getUser(): Promise<APIContractResult<User>>;
 
 const safe = await fetchSafely(getUser);
 if (safe.error) {
-  console.error(safe.error.message);
+  console.error(safe.error);
 } else {
   console.log(safe.data.name);
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ErrorHandler, Context, TypedResponse } from 'hono';
+import { ErrorHandler, MiddlewareHandler, Context, TypedResponse } from 'hono';
 import { z, ZodNumber } from 'zod';
 import { Locale } from 'date-fns';
 
@@ -25,7 +25,7 @@ type FetchResult<T> = {
     error: null;
     data: T;
 } | {
-    error: Error;
+    error: string;
     data: null;
 };
 
@@ -51,6 +51,12 @@ declare function fetchAndThrow<TResult extends APIContractResult<unknown>>(fetch
  */
 declare const onHandlerError: ErrorHandler;
 
+/**
+ * Request logging middleware for Hono, providing detailed logs for each incoming request.
+ * Example log output: [12:12:12 (+4 UTC)] hono     | POST 200  123ms /api/v1/users (search=term)
+ */
+declare const honoLoggingHandler: MiddlewareHandler;
+
 /**
  * Type utility that recursively transforms all Date fields to string, as well as handling arrays and objects.
  * This is necessary for proper typing when working with RPC, as JSON does not support the Date type directly.
@@ -144,4 +150,4 @@ declare const log: {
     error: (message: string, service?: string, stack?: string) => void;
 };
 
-export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, SUCCESS_STATUS_CODES, type SerializeDates, type SuccessStatusCode, asQueryBoolean, asQueryNumber, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, log, onHandlerError, respond, safeExecute, success };
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, SUCCESS_STATUS_CODES, type SerializeDates, type SuccessStatusCode, asQueryBoolean, asQueryNumber, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, log, onHandlerError, respond, safeExecute, success };

package/dist/index.js

@@ -14,7 +14,7 @@ function failure({ status, error }) {
 async function fetchSafely(fetcher) {
   const response = await fetcher();
   if (response.kind === "error")
-    return { error: new Error(response.error), data: null };
+    return { error: response.error, data: null };
   return { error: null, data: response.data };
 }
 async function fetchAndThrow(fetcher) {
@@ -109,6 +109,22 @@ var onHandlerError = (error, c) => {
   return c.json(response, response.status);
 };
 
+// src/hono/hono.logging.ts
+import { blue as blue2, bold, dim as dim2, white as white2 } from "kleur/colors";
+var honoLoggingHandler = async (c, next) => {
+  const requestUrl = new URL(c.req.url);
+  const searchParams = requestUrl.searchParams.toString();
+  const startTime = performance.now();
+  await next();
+  const duration = Math.round(performance.now() - startTime);
+  const coloredMethod = bold(blue2(c.req.method.padEnd(4)));
+  const coloredStatus = getColoredHTTPStatus(c.res.status)(String(c.res.status).padEnd(4));
+  const coloredTime = dim2(`${duration}ms`.padStart(6));
+  const coloredPath = white2(c.req.path.padEnd(44));
+  const coloredSearchParams = searchParams ? dim2(` (${searchParams})`) : "";
+  log.info(`${coloredMethod} ${coloredStatus} ${coloredTime} ${coloredPath}${coloredSearchParams}`, "hono");
+};
+
 // src/hono/hono.respond.ts
 function respond(c, options) {
   return c.json(success({ status: options.status, data: options.data ?? {} }), options.status);
@@ -159,6 +175,7 @@ export {
   getFormattedTime,
   getUTCOffset,
   getZonedTime,
+  honoLoggingHandler,
   log,
   onHandlerError,
   respond,

package/package.json

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