@kalutskii/foundation 0.6.9 → 0.6.10

package/dist/index.d.ts

@@ -58,14 +58,6 @@ type FetchResult<T> = {
     data: null;
 };
 
-/**
- * Utility type that simplifies a given type T by flattening its structure.
- * This is particularly useful for improving the readability of complex types.
- */
-type Simplify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-
 type QueryPrimitive = string | number | boolean | bigint | Date | null | undefined;
 /**
  * Recursively transforms all fields of T to `string`, matching how query parameters are serialized.
@@ -74,20 +66,6 @@ type QueryPrimitive = string | number | boolean | bigint | Date | null | undefin
 type AsQuery<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<Required<Pick<T, Keys>> & Partial<Omit<T, Keys>>> : never;
 
 /**
  * Wraps c.json with a typed success payload / (or void data) & possible APIError response.
@@ -227,6 +205,28 @@ declare const log: {
     error: (message: string, service?: string, stack?: string) => void;
 };
 
+/**
+ * Utility type that simplifies a given type T by flattening its structure.
+ * This is particularly useful for improving the readability of complex types.
+ */
+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 = {
     /** The algorithm to use for signing and verifying JWTs. Defaults to 'HS256'. */
@@ -385,6 +385,7 @@ declare const isZodOptional: (schema: z.ZodTypeAny) => schema is z.ZodOptional<z
  */
 declare const unwrapOptional: (schema: z.ZodTypeAny) => z.ZodTypeAny;
 
+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.
@@ -404,4 +405,10 @@ declare const unwrapOptional: (schema: z.ZodTypeAny) => z.ZodTypeAny;
  */
 declare const asQuery: <T extends z.ZodTypeAny>(schema: T) => z.ZodPreprocess<T>;
 
-export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AnyZodObject, type AsQuery, type AtLeastOne, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type FlattenZodShape, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, SUCCESS_STATUS_CODES, type Simplify, type SuccessStatusCode, ZodJWTService, type ZodPaginationOptions, type ZodShape, asQuery, asQuerySchema, failure, fetchAndThrow, fetchSafely, flattenZodShape, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isZodObject, isZodOptional, log, measureExecutionTime, onHandlerError, refinePagination, respond, safeExecute, sqlWhere, success, unwrapOptional, zodPaginationSchema, zodPaginationShape };
+/**
+ * Checks if the given value is a plain object (i.e., an object
+ * that is not null, not an array, and has a prototype of Object).
+ */
+declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AnyZodObject, type AsQuery, type AtLeastOne, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type FlattenZodShape, type JWTServiceOptions, type JWTSignOptions, type MeasuredExecution, type Payload, type PayloadSchema, SUCCESS_STATUS_CODES, type Simplify, type SuccessStatusCode, ZodJWTService, type ZodPaginationOptions, type ZodShape, asQuery, asQuerySchema, failure, fetchAndThrow, fetchSafely, flattenZodShape, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isPlainObject, isZodObject, isZodOptional, log, measureExecutionTime, onHandlerError, parseQueryValue, refinePagination, respond, safeExecute, sqlWhere, success, unwrapOptional, zodPaginationSchema, zodPaginationShape };

package/dist/index.js

@@ -279,6 +279,11 @@ var flattenZodShape = (shape) => {
 var asQuerySchema = (schema) => {
   return z4.object(flattenZodShape(schema.shape)).strict();
 };
+
+// src/zod-validation/zod-validation.utilities.ts
+var isPlainObject = (value) => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
 export {
   EXCEPTION_STATUS_CODES,
   SUCCESS_STATUS_CODES,
@@ -297,11 +302,13 @@ export {
   getUTCOffset,
   getZonedTime,
   honoLoggingHandler,
+  isPlainObject,
   isZodObject,
   isZodOptional,
   log,
   measureExecutionTime,
   onHandlerError,
+  parseQueryValue,
   refinePagination,
   respond,
   safeExecute,

package/package.json

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