@kalutskii/foundation 0.6.11 → 0.6.13

package/dist/index.d.ts

@@ -58,12 +58,12 @@ type FetchResult<T> = {
     data: null;
 };
 
-type QueryPrimitive = string | number | boolean | bigint | Date | null | undefined;
+type QueryPrimitive = string | number | boolean | bigint | Date;
 /**
  * Recursively transforms all fields of T to `string`, matching how query parameters are serialized.
  * Handles nested objects, arrays, and primitive values (including null and undefined as optional).
  */
-type AsQuery<T> = T extends QueryPrimitive ? string : T extends readonly (infer Item)[] ? AsQuery<Item>[] : T extends object ? {
+type AsQuery<T> = T extends null | undefined ? T : T extends QueryPrimitive ? string : T extends readonly (infer Item)[] ? AsQuery<Item>[] : T extends object ? {
     [Key in keyof T]: AsQuery<T[Key]>;
 } : string;
 
@@ -280,8 +280,8 @@ declare class ZodJWTService<TPayloadOrSchema> {
 }
 
 declare const zodPaginationSchema: z.ZodObject<{
-    offset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
-    limit: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
 /**
  * Reusable pagination fields for flat query schemas, allowing for
@@ -291,8 +291,8 @@ declare const zodPaginationSchema: z.ZodObject<{
  * or use `zodPaginationSchema.extend(...)` when building directly from the schema.
  */
 declare const zodPaginationShape: {
-    offset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
-    limit: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 };
 /**
  * TypeScript type representing the pagination options validated by the `zodPaginationSchema`.
@@ -317,21 +317,21 @@ declare const refinePagination: (options?: ZodPaginationOptions) => ZodPaginatio
 
 declare const parseQueryValue: (value: unknown) => unknown;
 /**
- * Query parameters always arrive as strings, even when they semantically represent numbers
- * or booleans, so we preprocess them to convert to the appropriate types before validation.
+ * Preprocesses query-like values before Zod validation.
+ *
+ * Query parameters are string-based by nature, even when they semantically represent
+ * numbers or booleans. This helper converts only clear primitive values, allowing
+ * regular schemas like `z.number()` and `z.boolean()` to validate query input directly.
  *
  * ```ts
- * const schema = z.object({
+ * const schema = asQuery(z.object({
  *   page: z.number().int().positive(),
  *   isActive: z.boolean(),
- * });
+ * }));
  *
- * const queryParams = { page: '2', isActive: 'true' };
- * const result = schema.parse(queryParams); // { page: 2, isActive: true }
+ * schema.parse({ page: '2', isActive: 'true' });
+ * // { page: 2, isActive: true }
  * ```
- *
- * @param schema - The Zod schema to validate the query parameters against.
- * @returns A new Zod schema that preprocesses query parameter values before validation.
  */
 declare const asQuery: <T extends z.ZodTypeAny>(schema: T) => z.ZodPreprocess<T>;
 

package/dist/index.js

@@ -215,13 +215,30 @@ var refinePagination = (options) => ({
 });
 
 // src/zod-pagination/zod-pagination.schemas.ts
+import z from "zod";
+var zodPaginationSchema = z.object({
+  /** Integer representing the starting point for pagination. */
+  offset: z.coerce.number().int().nonnegative().optional(),
+  /** Integer representing the maximum number of items to return. */
+  limit: z.coerce.number().int().positive().optional()
+});
+var zodPaginationShape = zodPaginationSchema.shape;
+
+// src/zod-validation/zod-validation.refiners.ts
 import z2 from "zod";
 
+// src/zod-validation/zod-validation.utilities.ts
+var isPlainObject = (value) => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+
 // src/zod-validation/zod-validation.refiners.ts
-import z from "zod";
 var parseQueryValue = (value) => {
   if (Array.isArray(value))
     return value.map(parseQueryValue);
+  if (isPlainObject(value)) {
+    return Object.fromEntries(Object.entries(value).map(([key, value2]) => [key, parseQueryValue(value2)]));
+  }
   if (typeof value !== "string")
     return value;
   const normalized = value.trim().toLowerCase();
@@ -235,21 +252,7 @@ var parseQueryValue = (value) => {
     return Number(normalized);
   return value;
 };
-var asQuery = (schema) => z.preprocess(parseQueryValue, schema);
-
-// src/zod-pagination/zod-pagination.schemas.ts
-var zodPaginationSchema = z2.object({
-  /** Integer representing the starting point for pagination. */
-  offset: asQuery(z2.number().int().nonnegative()).optional(),
-  /** Integer representing the maximum number of items to return. */
-  limit: asQuery(z2.number().int().positive()).optional()
-});
-var zodPaginationShape = zodPaginationSchema.shape;
-
-// src/zod-validation/zod-validation.utilities.ts
-var isPlainObject = (value) => {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-};
+var asQuery = (schema) => z2.preprocess(parseQueryValue, schema);
 export {
   EXCEPTION_STATUS_CODES,
   SUCCESS_STATUS_CODES,

package/package.json

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