@kalutskii/foundation 0.6.20 → 0.6.21

package/dist/index.d.ts

@@ -174,6 +174,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))`
@@ -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.21",
   "description": "Typescript collection of most common utilities, schemas and functions among private projects.",
   "type": "module",
   "repository": {