@kalutskii/foundation 0.7.10 → 0.7.11

package/dist/index.d.ts

@@ -20,10 +20,21 @@ declare function sqlWhere(table: unknown, where: Record<string, unknown>): SQL;
 declare const onHandlerError: ErrorHandler;
 
 /**
- * Logs request method, response status, duration, URL details, and a body preview.
- * Multipart bodies remain unread to avoid buffering uploaded file content into logs.
+ * Options controlling which request details the Hono logger may expose.
+ * Secure mode excludes query parameters and body content from log output.
  */
-declare const honoLoggingHandler: MiddlewareHandler;
+type HonoLoggingOptions = {
+    /**
+     * Prevents query parameters and request bodies from being read or logged.
+     * Defaults to `false`, preserving detailed request logging.
+     */
+    secure?: boolean;
+};
+/**
+ * Creates middleware that logs request metadata and an optional body preview.
+ * Multipart bodies remain unread, while secure mode omits all sensitive input details.
+ */
+declare function honoLoggingHandler(options?: HonoLoggingOptions): MiddlewareHandler;
 
 declare const SUCCESS_STATUS_CODES: readonly [200, 201, 202, 307];
 declare const EXCEPTION_STATUS_CODES: readonly [400, 401, 403, 404, 405, 409, 500];
@@ -832,4 +843,4 @@ declare const asQuery: <T extends z.ZodTypeAny>(schema: T) => z.ZodPreprocess<T>
  */
 declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
 
-export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AsQuery, type AtLeastOne, DEFAULT_UPLOAD_MAX_FILE_SIZE, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type FileFormat, type FileFormatConfig, type HonoFileRespondOptions, type HonoRespondOptions, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, type ReplaceDotsWithUnderscores, SUCCESS_STATUS_CODES, type Simplify, type StringEnumRecord, type SuccessStatusCode, type UploadFilesValidationOptions, type UploadFilesValidationResult, type UploadPreset, type UploadValidationError, type ZodBulkExcludeSelection, type ZodBulkIncludeSelection, type ZodBulkSelection, ZodJWTService, type ZodPaginationOptions, type ZodSearchSchemaOptions, type ZodUploadFileSchemaOptions, asQuery, createStringEnumRecord, createUploadAccept, createZodSearchWhereSchema, defineUploadPreset, documentUploadPreset, failure, fetchAndThrow, fetchSafely, fileFormat, fileFormatsArray, fileFormatsConfig, fileFormatsRecord, fileRespond, formatTime, generateRandomString, getColoredHTTPStatus, getFileExtension, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, imageUploadPreset, isFileExtensionSupported, isFileFormatSupported, isFileMimeTypeSupported, isPlainObject, log, matchesMimeType, measureExecutionTime, normalizeFileExtension, onHandlerError, parseQueryValue, respond, safeExecute, sqlWhere, success, uploadValidationError, uploadValidationErrorsArray, uploadValidationErrorsRecord, validateUploadFile, validateUploadFiles, zodAtLeastOne, zodBulkSelectionSchema, zodPaginationSchema, zodPaginationShape, zodSearchQuerySchema, zodSearchSchema, zodUploadFileSchema };
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AsQuery, type AtLeastOne, DEFAULT_UPLOAD_MAX_FILE_SIZE, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type FileFormat, type FileFormatConfig, type HonoFileRespondOptions, type HonoLoggingOptions, type HonoRespondOptions, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, type ReplaceDotsWithUnderscores, SUCCESS_STATUS_CODES, type Simplify, type StringEnumRecord, type SuccessStatusCode, type UploadFilesValidationOptions, type UploadFilesValidationResult, type UploadPreset, type UploadValidationError, type ZodBulkExcludeSelection, type ZodBulkIncludeSelection, type ZodBulkSelection, ZodJWTService, type ZodPaginationOptions, type ZodSearchSchemaOptions, type ZodUploadFileSchemaOptions, asQuery, createStringEnumRecord, createUploadAccept, createZodSearchWhereSchema, defineUploadPreset, documentUploadPreset, failure, fetchAndThrow, fetchSafely, fileFormat, fileFormatsArray, fileFormatsConfig, fileFormatsRecord, fileRespond, formatTime, generateRandomString, getColoredHTTPStatus, getFileExtension, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, imageUploadPreset, isFileExtensionSupported, isFileFormatSupported, isFileMimeTypeSupported, isPlainObject, log, matchesMimeType, measureExecutionTime, normalizeFileExtension, onHandlerError, parseQueryValue, respond, safeExecute, sqlWhere, success, uploadValidationError, uploadValidationErrorsArray, uploadValidationErrorsRecord, validateUploadFile, validateUploadFiles, zodAtLeastOne, zodBulkSelectionSchema, zodPaginationSchema, zodPaginationShape, zodSearchQuerySchema, zodSearchSchema, zodUploadFileSchema };

package/dist/index.js

@@ -119,29 +119,31 @@ var onHandlerError = (error, c) => {
 
 // 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 body = c.req.header("content-type")?.includes("multipart/form-data") ? (
-    // If the request is multipart/form-data, we avoid reading the body
-    // to prevent consuming the stream, and instead log a placeholder.
-    "[multipart]"
-  ) : (
-    // Otherwise, we read the request body as text and normalize whitespace.
-    (await c.req.raw.clone().text()).replaceAll(/\s+/g, " ").trim()
-  );
-  const bodyPreview = body.length > 80 ? `${body.slice(0, 40)}\u2026${body.slice(-40)}` : body;
-  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(32));
-  const coloredSearchParams = searchParams ? dim2(` (${searchParams})`) : "";
-  const coloredBody = bodyPreview ? dim2(` ${bodyPreview}`) : "";
-  log.info(`${coloredMethod} ${coloredStatus} ${coloredTime} ${coloredPath}${coloredSearchParams}${coloredBody}`, "hono");
-};
+function honoLoggingHandler(options = {}) {
+  return async (c, next) => {
+    const searchParams = new URL(c.req.url).searchParams.toString();
+    const body = c.req.header("content-type")?.includes("multipart/form-data") ? (
+      // Multipart content remains unread to avoid buffering uploaded files;
+      // The placeholder records its presence without exposing any fields;
+      "[multipart]"
+    ) : (
+      // Other bodies are read from a clone and normalized for one-line output;
+      // The original request stream remains available to downstream handlers;
+      (await c.req.raw.clone().text()).replaceAll(/\s+/g, " ").trim()
+    );
+    const bodyPreview = body.length > 60 ? `${body.slice(0, 30)}\u2026${body.slice(-30)}` : body;
+    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(32));
+    const coloredSearchParams = options.secure ? "" : dim2(` (${searchParams})`);
+    const coloredBody = options.secure ? "" : dim2(` ${bodyPreview}`);
+    log.info(`${coloredMethod} ${coloredStatus} ${coloredTime} ${coloredPath}${coloredSearchParams}${coloredBody}`, "hono");
+  };
+}
 
 // src/hono/hono.respond.ts
 function respond(c, options) {

package/package.json

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