@kalutskii/foundation 0.6.20 → 0.6.22

package/dist/index.d.ts

@@ -58,29 +58,6 @@ type FetchResult<T> = {
     data: null;
 };
 
-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 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.
- *
- * ```typescript
- * 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.
  * When no data is provided, responds with an empty object {} (purely for type consistency).
@@ -88,7 +65,7 @@ type AtLeastOne<T, Keys extends keyof T = keyof T> = Keys extends keyof T ? Simp
 declare function respond<T extends object = Record<string, never>, S extends SuccessStatusCode = SuccessStatusCode>(c: Context, options: {
     status: S;
     data?: T;
-}): Response & TypedResponse<APISuccess<AsQuery<T>> | APIError, S, 'json'>;
+}): Response & TypedResponse<APISuccess<T> | APIError, S, 'json'>;
 
 /**
  * Factory for creating successful API responses with serializable data.
@@ -174,6 +151,24 @@ declare const formatTime: (time: Date, { locale, tz }?: {
     tz?: string;
 }) => string;
 
+/**
+ * Recursively replaces dots in a string with underscores in a type-safe manner.
+ * Example: `ReplaceDotsWithUnderscores<'foo.bar.baz.ok'>` → `'foo_bar_baz_ok'`.
+ */
+type ReplaceDotsWithUnderscores<T extends string> = T extends `${infer A}.${infer B}` ? `${A}_${ReplaceDotsWithUnderscores<B>}` : T;
+/**
+ * Type-safe record mapping string values to ergonomic enum-like keys.
+ * Keys are uppercased and dots are replaced with underscores.
+ */
+type StringEnumRecord<T extends readonly string[]> = Readonly<{
+    [Value in T[number] as Uppercase<ReplaceDotsWithUnderscores<Value>>]: Value;
+}>;
+/**
+ * Creates an immutable enum-like record from a readonly string array.
+ * Example: `['foo.s', 'baz'] as const` → `{ FOO_S: 'foo.s', BAZ: 'baz' }`.
+ */
+declare function createStringEnumRecord<const T extends readonly string[]>(values: T): StringEnumRecord<T>;
+
 /**
  * Safely executes functions and handles errors without using try/catch in the calling code.
  * Example usage: `safeExecute(() => fetchData(), (error) => console.error(error))`
@@ -300,6 +295,29 @@ declare const zodPaginationShape: {
  */
 type ZodPaginationOptions = z.infer<typeof zodPaginationSchema>;
 
+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 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.
+ *
+ * ```typescript
+ * 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 a partial Zod object schema with:
  * 1. A runtime check ensuring at least one field is non-undefined.
@@ -338,4 +356,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, respond, safeExecute, sqlWhere, success, zodAtLeastOne, 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, type ReplaceDotsWithUnderscores, SUCCESS_STATUS_CODES, type Simplify, type StringEnumRecord, type SuccessStatusCode, ZodJWTService, type ZodPaginationOptions, asQuery, createStringEnumRecord, failure, fetchAndThrow, fetchSafely, formatTime, generateRandomString, getColoredHTTPStatus, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, honoLoggingHandler, isPlainObject, log, measureExecutionTime, onHandlerError, parseQueryValue, respond, safeExecute, sqlWhere, success, zodAtLeastOne, zodPaginationSchema, zodPaginationShape };

package/dist/index.js

@@ -142,6 +142,11 @@ async function fetchAndThrow(fetcher) {
   return response.data;
 }
 
+// src/utilities/enums.utilities.ts
+function createStringEnumRecord(values) {
+  return Object.freeze(Object.fromEntries(values.map((value) => [value.replace(/\./g, "_").toUpperCase(), value])));
+}
+
 // src/utilities/execution.utilities.ts
 async function safeExecute(fn, onError) {
   try {
@@ -260,6 +265,7 @@ export {
   SUCCESS_STATUS_CODES,
   ZodJWTService,
   asQuery,
+  createStringEnumRecord,
   failure,
   fetchAndThrow,
   fetchSafely,

package/package.json

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