@kalutskii/foundation 0.6.13 → 0.6.17

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { SQL } from 'drizzle-orm';
+import { SQL, Simplify as Simplify$1 } from 'drizzle-orm';
 import { ErrorHandler, MiddlewareHandler, Context, TypedResponse } from 'hono';
 import { Locale } from 'date-fns';
 import { SymmetricAlgorithm } from 'hono/utils/jwt/jwa';
-import z from 'zod';
+import z, { ZodObject, ZodRawShape, z as z$1 } from 'zod';
 
 /**
  * Builds a Drizzle SQL `where` condition from a plain object.
@@ -66,6 +66,20 @@ type QueryPrimitive = string | number | boolean | bigint | Date;
 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;
+/**
+ * Utility type that ensures at least one property from the specified
+ * keys of a given type T is required, while the rest remain optional.
+ *
+ * This is useful for scenarios where you want to enforce that at least one
+ * of several optional (nullable) properties must be provided in an object.
+ *
+ * ```ts
+ * type Example = AtLeastOne<{ a?: string; b?: number; c?: boolean }>;
+ * // Valid: { a: "hello" }, { b: 42 }, { c: true }, { a: "hello", b: 42 }
+ * // Invalid: {}, { a: undefined, b: undefined, c: undefined }
+ * ```
+ */
+type AtLeastOne<T, Keys extends keyof T = keyof T> = Keys extends keyof T ? Simplify$1<Required<Pick<T, Keys>> & Partial<Omit<T, Keys>>> : never;
 
 /**
  * Wraps c.json with a typed success payload / (or void data) & possible APIError response.
@@ -212,20 +226,6 @@ declare const log: {
 type Simplify<T> = {
     [K in keyof T]: T[K];
 } & {};
-/**
- * Utility type that ensures at least one property from the specified
- * keys of a given type T is required, while the rest remain optional.
- *
- * This is useful for scenarios where you want to enforce that at least one
- * of several optional (nullable) properties must be provided in an object.
- *
- * ```ts
- * type Example = AtLeastOne<{ a?: string; b?: number; c?: boolean }>;
- * // Valid: { a: "hello" }, { b: 42 }, { c: true }, { a: "hello", b: 42 }
- * // Invalid: {}, { a: undefined, b: undefined, c: undefined }
- * ```
- */
-type AtLeastOne<T, Keys extends keyof T = keyof T> = Keys extends keyof T ? Simplify<Required<Pick<T, Keys>> & Partial<Omit<T, Keys>>> : never;
 
 /** Options for configuring the JWT service. */
 type JWTServiceOptions = {
@@ -280,8 +280,8 @@ declare class ZodJWTService<TPayloadOrSchema> {
 }
 
 declare const zodPaginationSchema: z.ZodObject<{
-    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
+    limit: z.ZodOptional<z.ZodDefault<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.ZodCoercedNumber<unknown>>;
-    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
 };
 /**
  * TypeScript type representing the pagination options validated by the `zodPaginationSchema`.
@@ -315,6 +315,18 @@ type ZodPaginationOptions = z.infer<typeof zodPaginationSchema>;
  */
 declare const refinePagination: (options?: ZodPaginationOptions) => ZodPaginationOptions;
 
+/**
+ * Wraps a partial Zod object schema with:
+ * 1. A runtime check ensuring at least one field is non-undefined.
+ * 2. A `.transform()` that narrows the output type to `AtLeastOne<T>`,
+ *    making it directly assignable to domain `*Select` and `*Update` types without casting.
+ *
+ * ```ts
+ * zQuery(zodAtLeastOne(userSelectSchema)) // result: UserSelect ✓
+ * ```
+ */
+declare const zodAtLeastOne: <T extends ZodObject<ZodRawShape>>(schema: T) => z$1.ZodPipe<T, z$1.ZodTransform<Awaited<AtLeastOne<z$1.core.output<T>>>, z$1.core.output<T>>>;
+
 declare const parseQueryValue: (value: unknown) => unknown;
 /**
  * Preprocesses query-like values before Zod validation.
@@ -341,4 +353,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, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, SUCCESS_STATUS_CODES, type Simplify, type SuccessStatusCode, ZodJWTService, type ZodPaginationOptions, asQuery, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isPlainObject, log, measureExecutionTime, onHandlerError, parseQueryValue, refinePagination, respond, safeExecute, sqlWhere, success, zodPaginationSchema, zodPaginationShape };
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AsQuery, type AtLeastOne, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, SUCCESS_STATUS_CODES, type Simplify, type SuccessStatusCode, ZodJWTService, type ZodPaginationOptions, asQuery, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isPlainObject, log, measureExecutionTime, onHandlerError, parseQueryValue, refinePagination, respond, safeExecute, sqlWhere, success, zodAtLeastOne, zodPaginationSchema, zodPaginationShape };

package/dist/index.js

@@ -218,13 +218,21 @@ var refinePagination = (options) => ({
 import z from "zod";
 var zodPaginationSchema = z.object({
   /** Integer representing the starting point for pagination. */
-  offset: z.coerce.number().int().nonnegative().optional(),
+  offset: z.coerce.number().int().nonnegative().default(0).optional(),
   /** Integer representing the maximum number of items to return. */
-  limit: z.coerce.number().int().positive().optional()
+  limit: z.coerce.number().int().positive().default(10).optional()
 });
 var zodPaginationShape = zodPaginationSchema.shape;
 
 // src/zod-validation/zod-validation.refiners.ts
+var DEFAULT_ERROR_MESSAGE = "Invalid input. At least one field must be provided.";
+var zodAtLeastOne = (schema) => schema.superRefine((val, ctx) => {
+  const hasValue = Object.values(val).some((v) => v !== void 0);
+  if (!hasValue)
+    ctx.addIssue({ code: "custom", message: DEFAULT_ERROR_MESSAGE });
+}).transform((val) => val);
+
+// src/zod-validation/zod-validation.parsing.ts
 import z2 from "zod";
 
 // src/zod-validation/zod-validation.utilities.ts
@@ -232,7 +240,7 @@ var isPlainObject = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
 
-// src/zod-validation/zod-validation.refiners.ts
+// src/zod-validation/zod-validation.parsing.ts
 var parseQueryValue = (value) => {
   if (Array.isArray(value))
     return value.map(parseQueryValue);
@@ -279,6 +287,7 @@ export {
   safeExecute,
   sqlWhere,
   success,
+  zodAtLeastOne,
   zodPaginationSchema,
   zodPaginationShape
 };

package/package.json

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