npm - @kalutskii/foundation - Versions diffs - 0.7.14 → 0.7.16 - Mend

@kalutskii/foundation 0.7.14 → 0.7.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -533,28 +533,36 @@ declare function formatTime(time: Date, { locale, tz }?: {
 /**
  * Recursively replaces dots in a string literal with underscores.
- * Every other character remains unchanged in the resulting type.
+ * Every other character remains unchanged in the resulting literal type.
  *
  * @example
  * type Key = ReplaceDotsWithUnderscores<'foo.bar.baz'>; // `foo_bar_baz`
  */
-type ReplaceDotsWithUnderscores<TValue extends string> = TValue extends `${infer Head}.${infer Tail}` ? `${Head}_${ReplaceDotsWithUnderscores<Tail>}` : TValue;
+type ReplaceDotsWithUnderscores<TValue extends string> = TValue extends `${infer Head}.${infer Tail}` ? `${ReplaceDotsWithUnderscores<Head>}_${ReplaceDotsWithUnderscores<Tail>}` : TValue;
+/**
+ * Recursively replaces hyphens in a string literal with underscores.
+ * Every other character remains unchanged in the resulting literal type.
+ *
+ * @example
+ * type Key = ReplaceHyphensWithUnderscores<'foo-bar-baz'>; // `foo_bar_baz`
+ */
+type ReplaceHyphensWithUnderscores<TValue extends string> = TValue extends `${infer Head}-${infer Tail}` ? `${ReplaceHyphensWithUnderscores<Head>}_${ReplaceHyphensWithUnderscores<Tail>}` : TValue;
 /**
  * Maps string literals to immutable uppercase enum-like keys.
- * Dots become underscores while every value preserves its original literal.
+ * Dots and hyphens become underscores while values preserve their original literals.
  *
  * @example
  * type Statuses = StringEnumRecord<readonly ['review.pending', 'published']>;
  */
 type StringEnumRecord<TValues extends readonly string[]> = Readonly<{
-    [Value in TValues[number] as Uppercase<ReplaceDotsWithUnderscores<Value>>]: Value;
+    [Value in TValues[number] as Uppercase<ReplaceHyphensWithUnderscores<ReplaceDotsWithUnderscores<Value>>>]: Value;
 }>;
 /**
  * Creates an immutable enum-like record from a readonly string array.
- * Keys are uppercased and every dot is replaced with an underscore.
+ * Keys are uppercased and every dot or hyphen is replaced with an underscore.
  *
  * @example
- * createStringEnumRecord(['foo.s', 'baz'] as const); // `{ FOO_S: 'foo.s', BAZ: 'baz' }`
+ * createStringEnumRecord(['foo-bar.s', 'baz'] as const); // `{ FOO_BAR_S: 'foo-bar.s', BAZ: 'baz' }`
  */
 declare function createStringEnumRecord<const T extends readonly string[]>(values: T): StringEnumRecord<T>;
@@ -899,6 +907,15 @@ declare const parseQueryValue: (value: unknown) => unknown;
  * // { page: 2, isActive: true }
  */
 declare const asQuery: <T extends z.ZodTypeAny>(schema: T) => z.ZodPreprocess<T>;
+/**
+ * Recursively converts a domain payload into its string-based query representation.
+ * Objects and arrays are copied while `null` and `undefined` retain their omission semantics.
+ *
+ * @example
+ * preprocessQueryPayload({ page: 2, enabled: true });
+ * // { page: '2', enabled: 'true' }
+ */
+declare function preprocessQueryPayload<TValue>(value: TValue): AsQuery<TValue>;
 /**
  * Checks whether a value is a plain record backed by `Object.prototype`.
@@ -906,4 +923,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, DEFAULT_UPLOAD_MAX_FILE_SIZE, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type FileFormat, type FileFormatConfig, type HonoFileRespondOptions, type HonoRespondOptions, type JWTServiceOptions, type JWTSignOptions, type LogLevel, type MeasuredExecution, type Payload, type PayloadSchema, REDACTED_LOG_VALUE, type ReplaceDotsWithUnderscores, SUCCESS_STATUS_CODES, type Simplify, type StringEnumRecord, type SuccessStatusCode, type UploadFilesValidationOptions, type UploadFilesValidationResult, type UploadPreset, type UploadValidationError, type ZodBulkExcludeSelection, type ZodBulkIncludeSelection, type ZodBulkSelection, ZodJWTService, type ZodPaginationOptions, type ZodSearchSchemaOptions, type ZodUploadFileSchemaOptions, asQuery, createStringEnumRecord, createUploadAccept, createZodSearchWhereSchema, defineUploadPreset, documentUploadPreset, failure, fetchAndThrow, fetchSafely, fileFormat, fileFormatsArray, fileFormatsConfig, fileFormatsRecord, fileRespond, formatTime, generateRandomString, getColoredHTTPStatus, getFileExtension, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, httpStatusColors, imageTransparentUploadPreset, imageUploadPreset, isFileExtensionSupported, isFileFormatSupported, isFileMimeTypeSupported, isPlainObject, log, logLevel, logLevelColors, logLevelsArray, logLevelsRecord, loggingMiddleware, matchesMimeType, measureExecutionTime, normalizeFileExtension, onHandlerError, parseQueryValue, redactSensitiveJSON, redactSensitiveSearchParams, respond, safeExecute, sensitiveLogKeyParts, sqlWhere, success, uploadValidationError, uploadValidationErrorsArray, uploadValidationErrorsRecord, validateUploadFile, validateUploadFiles, zodAtLeastOne, zodBulkSelectionSchema, zodPaginationSchema, zodPaginationShape, zodSearchQuerySchema, zodSearchSchema, zodUploadFileSchema };
+export { type APIContractData, type APIContractError, type APIContractResult, type APIError, type APISuccess, type AsQuery, type AtLeastOne, DEFAULT_UPLOAD_MAX_FILE_SIZE, EXCEPTION_STATUS_CODES, type ExceptionStatusCode, type FetchResult, type FileFormat, type FileFormatConfig, type HonoFileRespondOptions, type HonoRespondOptions, type JWTServiceOptions, type JWTSignOptions, type LogLevel, type MeasuredExecution, type Payload, type PayloadSchema, REDACTED_LOG_VALUE, type ReplaceDotsWithUnderscores, type ReplaceHyphensWithUnderscores, SUCCESS_STATUS_CODES, type Simplify, type StringEnumRecord, type SuccessStatusCode, type UploadFilesValidationOptions, type UploadFilesValidationResult, type UploadPreset, type UploadValidationError, type ZodBulkExcludeSelection, type ZodBulkIncludeSelection, type ZodBulkSelection, ZodJWTService, type ZodPaginationOptions, type ZodSearchSchemaOptions, type ZodUploadFileSchemaOptions, asQuery, createStringEnumRecord, createUploadAccept, createZodSearchWhereSchema, defineUploadPreset, documentUploadPreset, failure, fetchAndThrow, fetchSafely, fileFormat, fileFormatsArray, fileFormatsConfig, fileFormatsRecord, fileRespond, formatTime, generateRandomString, getColoredHTTPStatus, getFileExtension, getFormattedDate, getFormattedTime, getUTCOffset, getZonedTime, httpStatusColors, imageTransparentUploadPreset, imageUploadPreset, isFileExtensionSupported, isFileFormatSupported, isFileMimeTypeSupported, isPlainObject, log, logLevel, logLevelColors, logLevelsArray, logLevelsRecord, loggingMiddleware, matchesMimeType, measureExecutionTime, normalizeFileExtension, onHandlerError, parseQueryValue, preprocessQueryPayload, redactSensitiveJSON, redactSensitiveSearchParams, respond, safeExecute, sensitiveLogKeyParts, sqlWhere, success, uploadValidationError, uploadValidationErrorsArray, uploadValidationErrorsRecord, validateUploadFile, validateUploadFiles, zodAtLeastOne, zodBulkSelectionSchema, zodPaginationSchema, zodPaginationShape, zodSearchQuerySchema, zodSearchSchema, zodUploadFileSchema };

package/dist/index.js CHANGED Viewed

@@ -56,7 +56,7 @@ import { blue, green, red, yellow } from "kleur/colors";
 // src/utilities/enums.utilities.ts
 function createStringEnumRecord(values) {
-  return Object.freeze(Object.fromEntries(values.map((value) => [value.replace(/\./g, "_").toUpperCase(), value])));
+  return Object.freeze(Object.fromEntries(values.map((value) => [value.replaceAll(/[.-]/g, "_").toUpperCase(), value])));
 }
 // src/logging/logging.enums.ts
@@ -524,6 +524,20 @@ var parseQueryValue = (value) => {
   return value;
 };
 var asQuery = (schema) => z5.preprocess(parseQueryValue, schema);
+function preprocessQueryPayload(value) {
+  if (Array.isArray(value)) {
+    return value.map(preprocessQueryPayload);
+  }
+  if (isPlainObject(value)) {
+    const entries = Object.entries(value).map(([key, entryValue]) => {
+      return [key, preprocessQueryPayload(entryValue)];
+    });
+    return Object.fromEntries(entries);
+  }
+  if (value === null || value === void 0)
+    return value;
+  return String(value);
+}
 export {
   DEFAULT_UPLOAD_MAX_FILE_SIZE,
   EXCEPTION_STATUS_CODES,
@@ -570,6 +584,7 @@ export {
   normalizeFileExtension,
   onHandlerError,
   parseQueryValue,
+  preprocessQueryPayload,
   redactSensitiveJSON,
   redactSensitiveSearchParams,
   respond,

package/package.json CHANGED Viewed

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