@forklaunch/common 0.3.14 → 0.4.1

package/lib/index.d.mts

@@ -1,3 +1,200 @@
+/**
+ * Utility types for string manipulation and validation
+ */
+/**
+ * Remove leading separators from a string
+ */
+type RemoveLeadingSeparators<S extends string> = S extends `${' ' | '-' | '_' | '.' | '/' | ':'}${infer Rest}` ? RemoveLeadingSeparators<Rest> : S;
+/**
+ * Split a string by separators (space, dash, underscore, dot, slash, colon)
+ */
+type SplitBySeparators<S extends string> = S extends `${infer First}${' ' | '-' | '_' | '.' | '/' | ':'}${infer Rest}` ? [First, ...SplitBySeparators<Rest>] : S extends '' ? [] : [S];
+/**
+ * Capitalize the first letter of a string
+ */
+type Capitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Uppercase<First>}${Rest}` : S;
+/**
+ * Convert the first letter to lowercase
+ */
+type Uncapitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Lowercase<First>}${Rest}` : S;
+/**
+ * Remove all non-alphanumeric characters from a string
+ */
+type RemoveNonAlphanumeric<S extends string> = S extends `${infer First}${infer Rest}` ? First extends 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' ? `${First}${RemoveNonAlphanumeric<Rest>}` : RemoveNonAlphanumeric<Rest> : '';
+/**
+ * Remove leading numbers from a string to make it a valid identifier
+ */
+type RemoveLeadingNumbers<S extends string> = S extends `${infer First}${infer Rest}` ? First extends '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' ? RemoveLeadingNumbers<Rest> : S : S;
+/**
+ * Join an array of strings into camelCase
+ */
+type JoinCamelCase<T extends readonly string[]> = T extends readonly [
+    infer First,
+    ...infer Rest
+] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? Uncapitalize<RemoveNonAlphanumeric<First>> : `${Uncapitalize<RemoveNonAlphanumeric<First>>}${JoinCamelCaseCapitalized<Rest>}` : never : never : '';
+/**
+ * Join remaining parts with capitalized first letters
+ */
+type JoinCamelCaseCapitalized<T extends readonly string[]> = T extends readonly [infer First, ...infer Rest] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? Capitalize<RemoveNonAlphanumeric<First>> : `${Capitalize<RemoveNonAlphanumeric<First>>}${JoinCamelCaseCapitalized<Rest>}` : never : never : '';
+/**
+ * Convert a string to a valid TypeScript identifier in camelCase
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @example
+ * ```typescript
+ * type Example1 = CamelCaseIdentifier<"hello-world">; // "helloWorld"
+ * type Example2 = CamelCaseIdentifier<"my_var_name">; // "myVarName"
+ * type Example3 = CamelCaseIdentifier<"some.property.name">; // "somePropertyName"
+ * type Example4 = CamelCaseIdentifier<"123invalid">; // "invalid"
+ * type Example5 = CamelCaseIdentifier<"hello world">; // "helloWorld"
+ * type Example6 = CamelCaseIdentifier<"API-Key">; // "aPIKey"
+ * type Example7 = CamelCaseIdentifier<"/organization/base">; // "organizationBase"
+ * ```
+ */
+type CamelCaseIdentifier<S extends string> = RemoveLeadingNumbers<JoinCamelCase<SplitBySeparators<RemoveLeadingSeparators<S>>>> extends infer Result ? Result extends string ? Result extends '' ? S : Result : S : S;
+/**
+ * Improved version that handles consecutive uppercase letters better
+ * by converting them to proper camelCase
+ */
+type LowerCaseWord<S extends string> = Lowercase<S>;
+/**
+ * More intuitive camelCase conversion that properly handles abbreviations
+ *
+ * @example
+ * ```typescript
+ * type Example1 = PrettyCamelCase<"API-Key">; // "apiKey"
+ * type Example2 = PrettyCamelCase<"HTTP-Response">; // "httpResponse"
+ * type Example3 = PrettyCamelCase<"user-ID">; // "userId"
+ * ```
+ */
+type JoinPrettyCamelCase<T extends readonly string[]> = T extends readonly [
+    infer First,
+    ...infer Rest
+] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? LowerCaseWord<RemoveNonAlphanumeric<First>> : `${LowerCaseWord<RemoveNonAlphanumeric<First>>}${JoinPrettyCamelCaseCapitalized<Rest>}` : never : never : '';
+type JoinPrettyCamelCaseCapitalized<T extends readonly string[]> = T extends readonly [infer First, ...infer Rest] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? Capitalize<LowerCaseWord<RemoveNonAlphanumeric<First>>> : `${Capitalize<LowerCaseWord<RemoveNonAlphanumeric<First>>>}${JoinPrettyCamelCaseCapitalized<Rest>}` : never : never : '';
+/**
+ * Pretty camelCase conversion that handles abbreviations more intuitively
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @example
+ * ```typescript
+ * type Example1 = PrettyCamelCase<"API-Key">; // "apiKey"
+ * type Example2 = PrettyCamelCase<"HTTP-Response">; // "httpResponse"
+ * type Example3 = PrettyCamelCase<"user-ID">; // "userId"
+ * type Example4 = PrettyCamelCase<"get-user-by-id">; // "getUserById"
+ * type Example5 = PrettyCamelCase<"/organization/base">; // "organizationBase"
+ * ```
+ */
+type PrettyCamelCase<S extends string> = RemoveLeadingNumbers<JoinPrettyCamelCase<SplitBySeparators<RemoveLeadingSeparators<S>>>> extends infer Result ? Result extends string ? Result extends '' ? S : Result : S : S;
+/**
+ * Alternative implementation using a more comprehensive approach
+ * for complex cases with better handling of edge cases
+ */
+type ValidIdentifier<S extends string> = CamelCaseIdentifier<S>;
+
+/**
+ * Runtime string utility functions that mirror the TypeScript utility types
+ */
+
+/**
+ * Remove leading separators from a string
+ */
+declare function removeLeadingSeparators(str: string): string;
+/**
+ * Split a string by separators (space, dash, underscore, dot, slash, colon)
+ */
+declare function splitBySeparators(str: string): string[];
+/**
+ * Remove all non-alphanumeric characters from a string
+ */
+declare function removeNonAlphanumeric(str: string): string;
+/**
+ * Remove leading numbers from a string to make it a valid identifier
+ */
+declare function removeLeadingNumbers(str: string): string;
+/**
+ * Capitalize the first letter of a string
+ */
+declare function capitalize(str: string): string;
+/**
+ * Convert the first letter to lowercase
+ */
+declare function uncapitalize(str: string): string;
+/**
+ * Convert a string to a valid TypeScript identifier in camelCase
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @param str - The input string to transform
+ * @returns The camelCase identifier or the original string if transformation fails
+ *
+ * @example
+ * ```typescript
+ * toCamelCaseIdentifier("hello-world"); // "helloWorld"
+ * toCamelCaseIdentifier("my_var_name"); // "myVarName"
+ * toCamelCaseIdentifier("some.property.name"); // "somePropertyName"
+ * toCamelCaseIdentifier("123invalid"); // "invalid"
+ * toCamelCaseIdentifier("hello world"); // "helloWorld"
+ * toCamelCaseIdentifier("API-Key"); // "aPIKey"
+ * toCamelCaseIdentifier("/organization/base"); // "organizationBase"
+ * ```
+ */
+declare function toCamelCaseIdentifier<T extends string>(str: T): CamelCaseIdentifier<T>;
+/**
+ * Pretty camelCase conversion that handles abbreviations more intuitively
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @param str - The input string to transform
+ * @returns The pretty camelCase identifier or the original string if transformation fails
+ *
+ * @example
+ * ```typescript
+ * toPrettyCamelCase("API-Key"); // "apiKey"
+ * toPrettyCamelCase("HTTP-Response"); // "httpResponse"
+ * toPrettyCamelCase("user-ID"); // "userId"
+ * toPrettyCamelCase("get-user-by-id"); // "getUserById"
+ * toPrettyCamelCase("/organization/base"); // "organizationBase"
+ * ```
+ */
+declare function toPrettyCamelCase<T extends string>(str: T): PrettyCamelCase<T>;
+/**
+ * Alternative implementation using a more comprehensive approach
+ * for complex cases with better handling of edge cases
+ */
+declare function toValidIdentifier<T extends string>(str: T): ValidIdentifier<T>;
+/**
+ * Check if a string is a valid JavaScript/TypeScript identifier
+ */
+declare function isValidIdentifier(str: string): boolean;
+/**
+ * Get detailed information about the transformation process
+ * Useful for debugging and understanding how the transformation works
+ */
+declare function getTransformationInfo(str: string): {
+    original: string;
+    withoutLeadingSeparators: string;
+    parts: string[];
+    camelCase: string;
+    prettyCamelCase: string;
+    withoutLeadingNumbers: string;
+    prettyCamelCaseWithoutLeadingNumbers: string;
+    isValid: boolean;
+};
+
+/**
+ * An empty object literal constant.
+ *
+ * This constant represents an empty object with no properties.
+ * It is commonly used as a default value or placeholder when
+ * an empty object is needed.
+ *
+ * @example
+ * ```typescript
+ * const defaultConfig = emptyObject;
+ * const merged = { ...emptyObject, ...userConfig };
+ * ```
+ */
+declare const emptyObject: {};
+
 /**
  * Extracts the names of arguments from a function's string representation.
  * This is useful for reflection and debugging purposes.
@@ -48,13 +245,9 @@ declare function isRecord(obj: unknown): obj is Record<string, unknown>;
  */
 declare function isTrue(value: true): true;
 
-declare class InMemoryFile extends File {
+declare class InMemoryBlob extends Blob {
     content: string;
-    constructor(content: string, name: string, { type, endings, lastModified }: {
-        type?: string;
-        endings?: 'transparent' | 'native';
-        lastModified?: number;
-    });
+    constructor(content: string);
 }
 
 /**
@@ -72,6 +265,26 @@ declare class InMemoryFile extends File {
  */
 declare function noop(..._args: unknown[]): void;
 
+/**
+ * Converts a path with Express-style parameters to OpenAPI-compliant format.
+ *
+ * Express-style parameters use the format `:paramName` (e.g., `/users/:id`),
+ * while OpenAPI uses curly braces `{paramName}` (e.g., `/users/{id}`).
+ *
+ * @param path - The path string containing Express-style parameters
+ * @returns The path string with OpenAPI-compliant parameter format
+ *
+ * @example
+ * ```typescript
+ * openApiCompliantPath('/users/:id/posts/:postId')
+ * // Returns: '/users/{id}/posts/{postId}'
+ *
+ * openApiCompliantPath('/api/v1/products/:productId/reviews/:reviewId')
+ * // Returns: '/api/v1/products/{productId}/reviews/{reviewId}'
+ * ```
+ */
+declare function openApiCompliantPath(path: string): string;
+
 declare function readableStreamToAsyncIterable<T>(stream: ReadableStream<T>): AsyncIterable<T>;
 
 declare function safeParse<T>(input: unknown): T;
@@ -104,6 +317,37 @@ declare function safeParse<T>(input: unknown): T;
  */
 declare function safeStringify(arg: unknown): string;
 
+/**
+ * Removes a trailing slash from a path string if present.
+ *
+ * @param path - The path string to process
+ * @returns The path string with trailing slash removed
+ * @example
+ * removeTrailingSlash('/users/'); // '/users'
+ * removeTrailingSlash('/users');  // '/users'
+ */
+declare function removeTrailingSlash(path: string): string;
+/**
+ * Removes a double leading slash from a path string if present.
+ *
+ * @param path - The path string to process
+ * @returns The path string with double leading slash removed
+ * @example
+ * removeDoubleLeadingSlash('//users'); // '/users'
+ * removeDoubleLeadingSlash('/users');  // '/users'
+ */
+declare function removeDoubleLeadingSlash(path: string): string;
+/**
+ * Sanitizes a path string by removing both trailing slashes and double leading slashes.
+ *
+ * @param path - The path string to process
+ * @returns The sanitized path string
+ * @example
+ * sanitizePathSlashes('//users/'); // '/users'
+ * sanitizePathSlashes('/users');   // '/users'
+ */
+declare function sanitizePathSlashes(path: string): string;
+
 /**
  * Recursively sorts the keys of an object and its nested objects alphabetically.
  * This is useful for consistent object serialization and comparison.
@@ -125,6 +369,15 @@ declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T): T;
  */
 declare function stripUndefinedProperties<T extends Record<string, unknown>>(obj: T): Partial<T>;
 
+/**
+ * Converts an object to a record.
+ *
+ * @template T - The type of the object to convert.
+ * @param obj - The object to convert.
+ * @returns The record.
+ */
+declare function toRecord<T>(obj: T): Record<string, unknown>;
+
 /**
  * Type representing a DTO (Data Transfer Object) with an id field.
  */
@@ -173,6 +426,19 @@ type InstanceTypeRecord<T extends Record<string, new (...args: never[]) => unkno
     [K in keyof T]: InstanceType<T[K]>;
 };
 
+/**
+ * Type representing an empty object literal.
+ *
+ * This type is derived from the `emptyObject` constant and represents
+ * an object with no properties.
+ *
+ * @example
+ * ```typescript
+ * const obj: EmptyObject = {};
+ * ```
+ */
+type EmptyObject = typeof emptyObject;
+
 type ExclusiveRecord<T, U> = T extends object ? U extends object ? T & Record<Exclude<keyof T, keyof U>, never> : T : T;
 
 /**
@@ -230,6 +496,18 @@ type MakePropertyOptionalIfChildrenOptional<T> = {
     [K in keyof T as AllPropertiesOptional<T[K]> extends true ? never : K]: T[K];
 };
 
+/**
+ * Merges two objects by unioning the values for duplicate keys
+ */
+type MergeUnionOnCollision<T, U> = {
+    [K in keyof T | keyof U]: K extends keyof T ? K extends keyof U ? T[K] | U[K] : T[K] : K extends keyof U ? U[K] : never;
+};
+
+/**
+ * Recursively merges an array of fetchMap objects
+ */
+type MergeArrayOfMaps<T extends readonly Record<string, unknown>[]> = T extends readonly [infer First, ...infer Rest] ? First extends Record<string, unknown> ? Rest extends readonly Record<string, unknown>[] ? Rest extends readonly [] ? First : MergeUnionOnCollision<First, MergeArrayOfMaps<Rest>> : First : Record<string, never> : Record<string, never>;
+
 type MimeType = 'application/json' | 'application/xml' | 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/html' | 'text/plain' | 'image/jpeg' | 'image/png' | 'video/mp4' | 'audio/mpeg' | 'application/pdf' | 'application/zip' | 'application/octet-stream' | string;
 
 /**
@@ -254,9 +532,35 @@ type Prettify<T> = {
  * type Route2 = RemoveTrailingSlash<'/users'>;  // '/users'
  */
 type RemoveTrailingSlash<T extends string> = T extends `${infer Route}/` ? Route : T;
+/**
+ * Type that removes a double leading slash from a string type if present.
+ *
+ * @template T - The string type to process
+ * @example
+ * type Route1 = RemoveDoubleLeadingSlash<'//users'>; // '/users'
+ * type Route2 = RemoveDoubleLeadingSlash<'/users'>;  // '/users'
+ */
+type RemoveDoubleLeadingSlash<T extends string> = T extends `//${infer Route}` ? `/${Route}` : T;
+/**
+ * Type that sanitizes a path string by removing double leading slashes.
+ *
+ * @template T - The string type to process
+ * @example
+ * type Route1 = SanitizePathSlashes<'//users'>; // '/users'
+ * type Route2 = SanitizePathSlashes<'/users'>;  // '/users'
+ */
+type SanitizePathSlashes<T extends string> = RemoveDoubleLeadingSlash<RemoveTrailingSlash<T>>;
+
+/**
+ * Utility type that excludes strings containing forward slashes
+ */
+type StringWithoutSlash<T extends string> = T extends `${string}/${string}` ? 'cannot contain forward slashes' : T;
 
 type TypeSafeFunction = (...args: never[]) => unknown;
 
 type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+type UnionToIntersectionChildren<U> = {
+    [K in keyof U]: UnionToIntersection<U[K]>;
+};
 
-export { type ExclusiveRecord, type Flatten, type FlattenKeys, type FlattenValues, type IdDto, type IdsDto, InMemoryFile, type InstanceTypeRecord, type MakePropertyOptionalIfChildrenOptional, type MimeType, type Prettify, type RecordTimingDto, type RemoveTrailingSlash, type ReturnTypeRecord, type TypeSafeFunction, type UnionToIntersection, extractArgumentNames, getEnvVar, isAsyncGenerator, isNever, isNodeJsWriteableStream, isRecord, isTrue, noop, readableStreamToAsyncIterable, safeParse, safeStringify, sortObjectKeys, stripUndefinedProperties };
+export { type CamelCaseIdentifier, type EmptyObject, type ExclusiveRecord, type Flatten, type FlattenKeys, type FlattenValues, type IdDto, type IdsDto, InMemoryBlob, type InstanceTypeRecord, type MakePropertyOptionalIfChildrenOptional, type MergeArrayOfMaps, type MergeUnionOnCollision, type MimeType, type Prettify, type PrettyCamelCase, type RecordTimingDto, type RemoveDoubleLeadingSlash, type RemoveTrailingSlash, type ReturnTypeRecord, type SanitizePathSlashes, type StringWithoutSlash, type TypeSafeFunction, type UnionToIntersection, type UnionToIntersectionChildren, type ValidIdentifier, capitalize, emptyObject, extractArgumentNames, getEnvVar, getTransformationInfo, isAsyncGenerator, isNever, isNodeJsWriteableStream, isRecord, isTrue, isValidIdentifier, noop, openApiCompliantPath, readableStreamToAsyncIterable, removeDoubleLeadingSlash, removeLeadingNumbers, removeLeadingSeparators, removeNonAlphanumeric, removeTrailingSlash, safeParse, safeStringify, sanitizePathSlashes, sortObjectKeys, splitBySeparators, stripUndefinedProperties, toCamelCaseIdentifier, toPrettyCamelCase, toRecord, toValidIdentifier, uncapitalize };

package/lib/index.d.ts

@@ -1,3 +1,200 @@
+/**
+ * Utility types for string manipulation and validation
+ */
+/**
+ * Remove leading separators from a string
+ */
+type RemoveLeadingSeparators<S extends string> = S extends `${' ' | '-' | '_' | '.' | '/' | ':'}${infer Rest}` ? RemoveLeadingSeparators<Rest> : S;
+/**
+ * Split a string by separators (space, dash, underscore, dot, slash, colon)
+ */
+type SplitBySeparators<S extends string> = S extends `${infer First}${' ' | '-' | '_' | '.' | '/' | ':'}${infer Rest}` ? [First, ...SplitBySeparators<Rest>] : S extends '' ? [] : [S];
+/**
+ * Capitalize the first letter of a string
+ */
+type Capitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Uppercase<First>}${Rest}` : S;
+/**
+ * Convert the first letter to lowercase
+ */
+type Uncapitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Lowercase<First>}${Rest}` : S;
+/**
+ * Remove all non-alphanumeric characters from a string
+ */
+type RemoveNonAlphanumeric<S extends string> = S extends `${infer First}${infer Rest}` ? First extends 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' ? `${First}${RemoveNonAlphanumeric<Rest>}` : RemoveNonAlphanumeric<Rest> : '';
+/**
+ * Remove leading numbers from a string to make it a valid identifier
+ */
+type RemoveLeadingNumbers<S extends string> = S extends `${infer First}${infer Rest}` ? First extends '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' ? RemoveLeadingNumbers<Rest> : S : S;
+/**
+ * Join an array of strings into camelCase
+ */
+type JoinCamelCase<T extends readonly string[]> = T extends readonly [
+    infer First,
+    ...infer Rest
+] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? Uncapitalize<RemoveNonAlphanumeric<First>> : `${Uncapitalize<RemoveNonAlphanumeric<First>>}${JoinCamelCaseCapitalized<Rest>}` : never : never : '';
+/**
+ * Join remaining parts with capitalized first letters
+ */
+type JoinCamelCaseCapitalized<T extends readonly string[]> = T extends readonly [infer First, ...infer Rest] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? Capitalize<RemoveNonAlphanumeric<First>> : `${Capitalize<RemoveNonAlphanumeric<First>>}${JoinCamelCaseCapitalized<Rest>}` : never : never : '';
+/**
+ * Convert a string to a valid TypeScript identifier in camelCase
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @example
+ * ```typescript
+ * type Example1 = CamelCaseIdentifier<"hello-world">; // "helloWorld"
+ * type Example2 = CamelCaseIdentifier<"my_var_name">; // "myVarName"
+ * type Example3 = CamelCaseIdentifier<"some.property.name">; // "somePropertyName"
+ * type Example4 = CamelCaseIdentifier<"123invalid">; // "invalid"
+ * type Example5 = CamelCaseIdentifier<"hello world">; // "helloWorld"
+ * type Example6 = CamelCaseIdentifier<"API-Key">; // "aPIKey"
+ * type Example7 = CamelCaseIdentifier<"/organization/base">; // "organizationBase"
+ * ```
+ */
+type CamelCaseIdentifier<S extends string> = RemoveLeadingNumbers<JoinCamelCase<SplitBySeparators<RemoveLeadingSeparators<S>>>> extends infer Result ? Result extends string ? Result extends '' ? S : Result : S : S;
+/**
+ * Improved version that handles consecutive uppercase letters better
+ * by converting them to proper camelCase
+ */
+type LowerCaseWord<S extends string> = Lowercase<S>;
+/**
+ * More intuitive camelCase conversion that properly handles abbreviations
+ *
+ * @example
+ * ```typescript
+ * type Example1 = PrettyCamelCase<"API-Key">; // "apiKey"
+ * type Example2 = PrettyCamelCase<"HTTP-Response">; // "httpResponse"
+ * type Example3 = PrettyCamelCase<"user-ID">; // "userId"
+ * ```
+ */
+type JoinPrettyCamelCase<T extends readonly string[]> = T extends readonly [
+    infer First,
+    ...infer Rest
+] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? LowerCaseWord<RemoveNonAlphanumeric<First>> : `${LowerCaseWord<RemoveNonAlphanumeric<First>>}${JoinPrettyCamelCaseCapitalized<Rest>}` : never : never : '';
+type JoinPrettyCamelCaseCapitalized<T extends readonly string[]> = T extends readonly [infer First, ...infer Rest] ? First extends string ? Rest extends readonly string[] ? Rest['length'] extends 0 ? Capitalize<LowerCaseWord<RemoveNonAlphanumeric<First>>> : `${Capitalize<LowerCaseWord<RemoveNonAlphanumeric<First>>>}${JoinPrettyCamelCaseCapitalized<Rest>}` : never : never : '';
+/**
+ * Pretty camelCase conversion that handles abbreviations more intuitively
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @example
+ * ```typescript
+ * type Example1 = PrettyCamelCase<"API-Key">; // "apiKey"
+ * type Example2 = PrettyCamelCase<"HTTP-Response">; // "httpResponse"
+ * type Example3 = PrettyCamelCase<"user-ID">; // "userId"
+ * type Example4 = PrettyCamelCase<"get-user-by-id">; // "getUserById"
+ * type Example5 = PrettyCamelCase<"/organization/base">; // "organizationBase"
+ * ```
+ */
+type PrettyCamelCase<S extends string> = RemoveLeadingNumbers<JoinPrettyCamelCase<SplitBySeparators<RemoveLeadingSeparators<S>>>> extends infer Result ? Result extends string ? Result extends '' ? S : Result : S : S;
+/**
+ * Alternative implementation using a more comprehensive approach
+ * for complex cases with better handling of edge cases
+ */
+type ValidIdentifier<S extends string> = CamelCaseIdentifier<S>;
+
+/**
+ * Runtime string utility functions that mirror the TypeScript utility types
+ */
+
+/**
+ * Remove leading separators from a string
+ */
+declare function removeLeadingSeparators(str: string): string;
+/**
+ * Split a string by separators (space, dash, underscore, dot, slash, colon)
+ */
+declare function splitBySeparators(str: string): string[];
+/**
+ * Remove all non-alphanumeric characters from a string
+ */
+declare function removeNonAlphanumeric(str: string): string;
+/**
+ * Remove leading numbers from a string to make it a valid identifier
+ */
+declare function removeLeadingNumbers(str: string): string;
+/**
+ * Capitalize the first letter of a string
+ */
+declare function capitalize(str: string): string;
+/**
+ * Convert the first letter to lowercase
+ */
+declare function uncapitalize(str: string): string;
+/**
+ * Convert a string to a valid TypeScript identifier in camelCase
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @param str - The input string to transform
+ * @returns The camelCase identifier or the original string if transformation fails
+ *
+ * @example
+ * ```typescript
+ * toCamelCaseIdentifier("hello-world"); // "helloWorld"
+ * toCamelCaseIdentifier("my_var_name"); // "myVarName"
+ * toCamelCaseIdentifier("some.property.name"); // "somePropertyName"
+ * toCamelCaseIdentifier("123invalid"); // "invalid"
+ * toCamelCaseIdentifier("hello world"); // "helloWorld"
+ * toCamelCaseIdentifier("API-Key"); // "aPIKey"
+ * toCamelCaseIdentifier("/organization/base"); // "organizationBase"
+ * ```
+ */
+declare function toCamelCaseIdentifier<T extends string>(str: T): CamelCaseIdentifier<T>;
+/**
+ * Pretty camelCase conversion that handles abbreviations more intuitively
+ * Always returns a string, defaulting to the input if transformation fails
+ *
+ * @param str - The input string to transform
+ * @returns The pretty camelCase identifier or the original string if transformation fails
+ *
+ * @example
+ * ```typescript
+ * toPrettyCamelCase("API-Key"); // "apiKey"
+ * toPrettyCamelCase("HTTP-Response"); // "httpResponse"
+ * toPrettyCamelCase("user-ID"); // "userId"
+ * toPrettyCamelCase("get-user-by-id"); // "getUserById"
+ * toPrettyCamelCase("/organization/base"); // "organizationBase"
+ * ```
+ */
+declare function toPrettyCamelCase<T extends string>(str: T): PrettyCamelCase<T>;
+/**
+ * Alternative implementation using a more comprehensive approach
+ * for complex cases with better handling of edge cases
+ */
+declare function toValidIdentifier<T extends string>(str: T): ValidIdentifier<T>;
+/**
+ * Check if a string is a valid JavaScript/TypeScript identifier
+ */
+declare function isValidIdentifier(str: string): boolean;
+/**
+ * Get detailed information about the transformation process
+ * Useful for debugging and understanding how the transformation works
+ */
+declare function getTransformationInfo(str: string): {
+    original: string;
+    withoutLeadingSeparators: string;
+    parts: string[];
+    camelCase: string;
+    prettyCamelCase: string;
+    withoutLeadingNumbers: string;
+    prettyCamelCaseWithoutLeadingNumbers: string;
+    isValid: boolean;
+};
+
+/**
+ * An empty object literal constant.
+ *
+ * This constant represents an empty object with no properties.
+ * It is commonly used as a default value or placeholder when
+ * an empty object is needed.
+ *
+ * @example
+ * ```typescript
+ * const defaultConfig = emptyObject;
+ * const merged = { ...emptyObject, ...userConfig };
+ * ```
+ */
+declare const emptyObject: {};
+
 /**
  * Extracts the names of arguments from a function's string representation.
  * This is useful for reflection and debugging purposes.
@@ -48,13 +245,9 @@ declare function isRecord(obj: unknown): obj is Record<string, unknown>;
  */
 declare function isTrue(value: true): true;
 
-declare class InMemoryFile extends File {
+declare class InMemoryBlob extends Blob {
     content: string;
-    constructor(content: string, name: string, { type, endings, lastModified }: {
-        type?: string;
-        endings?: 'transparent' | 'native';
-        lastModified?: number;
-    });
+    constructor(content: string);
 }
 
 /**
@@ -72,6 +265,26 @@ declare class InMemoryFile extends File {
  */
 declare function noop(..._args: unknown[]): void;
 
+/**
+ * Converts a path with Express-style parameters to OpenAPI-compliant format.
+ *
+ * Express-style parameters use the format `:paramName` (e.g., `/users/:id`),
+ * while OpenAPI uses curly braces `{paramName}` (e.g., `/users/{id}`).
+ *
+ * @param path - The path string containing Express-style parameters
+ * @returns The path string with OpenAPI-compliant parameter format
+ *
+ * @example
+ * ```typescript
+ * openApiCompliantPath('/users/:id/posts/:postId')
+ * // Returns: '/users/{id}/posts/{postId}'
+ *
+ * openApiCompliantPath('/api/v1/products/:productId/reviews/:reviewId')
+ * // Returns: '/api/v1/products/{productId}/reviews/{reviewId}'
+ * ```
+ */
+declare function openApiCompliantPath(path: string): string;
+
 declare function readableStreamToAsyncIterable<T>(stream: ReadableStream<T>): AsyncIterable<T>;
 
 declare function safeParse<T>(input: unknown): T;
@@ -104,6 +317,37 @@ declare function safeParse<T>(input: unknown): T;
  */
 declare function safeStringify(arg: unknown): string;
 
+/**
+ * Removes a trailing slash from a path string if present.
+ *
+ * @param path - The path string to process
+ * @returns The path string with trailing slash removed
+ * @example
+ * removeTrailingSlash('/users/'); // '/users'
+ * removeTrailingSlash('/users');  // '/users'
+ */
+declare function removeTrailingSlash(path: string): string;
+/**
+ * Removes a double leading slash from a path string if present.
+ *
+ * @param path - The path string to process
+ * @returns The path string with double leading slash removed
+ * @example
+ * removeDoubleLeadingSlash('//users'); // '/users'
+ * removeDoubleLeadingSlash('/users');  // '/users'
+ */
+declare function removeDoubleLeadingSlash(path: string): string;
+/**
+ * Sanitizes a path string by removing both trailing slashes and double leading slashes.
+ *
+ * @param path - The path string to process
+ * @returns The sanitized path string
+ * @example
+ * sanitizePathSlashes('//users/'); // '/users'
+ * sanitizePathSlashes('/users');   // '/users'
+ */
+declare function sanitizePathSlashes(path: string): string;
+
 /**
  * Recursively sorts the keys of an object and its nested objects alphabetically.
  * This is useful for consistent object serialization and comparison.
@@ -125,6 +369,15 @@ declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T): T;
  */
 declare function stripUndefinedProperties<T extends Record<string, unknown>>(obj: T): Partial<T>;
 
+/**
+ * Converts an object to a record.
+ *
+ * @template T - The type of the object to convert.
+ * @param obj - The object to convert.
+ * @returns The record.
+ */
+declare function toRecord<T>(obj: T): Record<string, unknown>;
+
 /**
  * Type representing a DTO (Data Transfer Object) with an id field.
  */
@@ -173,6 +426,19 @@ type InstanceTypeRecord<T extends Record<string, new (...args: never[]) => unkno
     [K in keyof T]: InstanceType<T[K]>;
 };
 
+/**
+ * Type representing an empty object literal.
+ *
+ * This type is derived from the `emptyObject` constant and represents
+ * an object with no properties.
+ *
+ * @example
+ * ```typescript
+ * const obj: EmptyObject = {};
+ * ```
+ */
+type EmptyObject = typeof emptyObject;
+
 type ExclusiveRecord<T, U> = T extends object ? U extends object ? T & Record<Exclude<keyof T, keyof U>, never> : T : T;
 
 /**
@@ -230,6 +496,18 @@ type MakePropertyOptionalIfChildrenOptional<T> = {
     [K in keyof T as AllPropertiesOptional<T[K]> extends true ? never : K]: T[K];
 };
 
+/**
+ * Merges two objects by unioning the values for duplicate keys
+ */
+type MergeUnionOnCollision<T, U> = {
+    [K in keyof T | keyof U]: K extends keyof T ? K extends keyof U ? T[K] | U[K] : T[K] : K extends keyof U ? U[K] : never;
+};
+
+/**
+ * Recursively merges an array of fetchMap objects
+ */
+type MergeArrayOfMaps<T extends readonly Record<string, unknown>[]> = T extends readonly [infer First, ...infer Rest] ? First extends Record<string, unknown> ? Rest extends readonly Record<string, unknown>[] ? Rest extends readonly [] ? First : MergeUnionOnCollision<First, MergeArrayOfMaps<Rest>> : First : Record<string, never> : Record<string, never>;
+
 type MimeType = 'application/json' | 'application/xml' | 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/html' | 'text/plain' | 'image/jpeg' | 'image/png' | 'video/mp4' | 'audio/mpeg' | 'application/pdf' | 'application/zip' | 'application/octet-stream' | string;
 
 /**
@@ -254,9 +532,35 @@ type Prettify<T> = {
  * type Route2 = RemoveTrailingSlash<'/users'>;  // '/users'
  */
 type RemoveTrailingSlash<T extends string> = T extends `${infer Route}/` ? Route : T;
+/**
+ * Type that removes a double leading slash from a string type if present.
+ *
+ * @template T - The string type to process
+ * @example
+ * type Route1 = RemoveDoubleLeadingSlash<'//users'>; // '/users'
+ * type Route2 = RemoveDoubleLeadingSlash<'/users'>;  // '/users'
+ */
+type RemoveDoubleLeadingSlash<T extends string> = T extends `//${infer Route}` ? `/${Route}` : T;
+/**
+ * Type that sanitizes a path string by removing double leading slashes.
+ *
+ * @template T - The string type to process
+ * @example
+ * type Route1 = SanitizePathSlashes<'//users'>; // '/users'
+ * type Route2 = SanitizePathSlashes<'/users'>;  // '/users'
+ */
+type SanitizePathSlashes<T extends string> = RemoveDoubleLeadingSlash<RemoveTrailingSlash<T>>;
+
+/**
+ * Utility type that excludes strings containing forward slashes
+ */
+type StringWithoutSlash<T extends string> = T extends `${string}/${string}` ? 'cannot contain forward slashes' : T;
 
 type TypeSafeFunction = (...args: never[]) => unknown;
 
 type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+type UnionToIntersectionChildren<U> = {
+    [K in keyof U]: UnionToIntersection<U[K]>;
+};
 
-export { type ExclusiveRecord, type Flatten, type FlattenKeys, type FlattenValues, type IdDto, type IdsDto, InMemoryFile, type InstanceTypeRecord, type MakePropertyOptionalIfChildrenOptional, type MimeType, type Prettify, type RecordTimingDto, type RemoveTrailingSlash, type ReturnTypeRecord, type TypeSafeFunction, type UnionToIntersection, extractArgumentNames, getEnvVar, isAsyncGenerator, isNever, isNodeJsWriteableStream, isRecord, isTrue, noop, readableStreamToAsyncIterable, safeParse, safeStringify, sortObjectKeys, stripUndefinedProperties };
+export { type CamelCaseIdentifier, type EmptyObject, type ExclusiveRecord, type Flatten, type FlattenKeys, type FlattenValues, type IdDto, type IdsDto, InMemoryBlob, type InstanceTypeRecord, type MakePropertyOptionalIfChildrenOptional, type MergeArrayOfMaps, type MergeUnionOnCollision, type MimeType, type Prettify, type PrettyCamelCase, type RecordTimingDto, type RemoveDoubleLeadingSlash, type RemoveTrailingSlash, type ReturnTypeRecord, type SanitizePathSlashes, type StringWithoutSlash, type TypeSafeFunction, type UnionToIntersection, type UnionToIntersectionChildren, type ValidIdentifier, capitalize, emptyObject, extractArgumentNames, getEnvVar, getTransformationInfo, isAsyncGenerator, isNever, isNodeJsWriteableStream, isRecord, isTrue, isValidIdentifier, noop, openApiCompliantPath, readableStreamToAsyncIterable, removeDoubleLeadingSlash, removeLeadingNumbers, removeLeadingSeparators, removeNonAlphanumeric, removeTrailingSlash, safeParse, safeStringify, sanitizePathSlashes, sortObjectKeys, splitBySeparators, stripUndefinedProperties, toCamelCaseIdentifier, toPrettyCamelCase, toRecord, toValidIdentifier, uncapitalize };

package/lib/index.js

@@ -20,23 +20,133 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // index.ts
 var index_exports = {};
 __export(index_exports, {
-  InMemoryFile: () => InMemoryFile,
+  InMemoryBlob: () => InMemoryBlob,
+  capitalize: () => capitalize,
+  emptyObject: () => emptyObject,
   extractArgumentNames: () => extractArgumentNames,
   getEnvVar: () => getEnvVar,
+  getTransformationInfo: () => getTransformationInfo,
   isAsyncGenerator: () => isAsyncGenerator,
   isNever: () => isNever,
   isNodeJsWriteableStream: () => isNodeJsWriteableStream,
   isRecord: () => isRecord,
   isTrue: () => isTrue,
+  isValidIdentifier: () => isValidIdentifier,
   noop: () => noop,
+  openApiCompliantPath: () => openApiCompliantPath,
   readableStreamToAsyncIterable: () => readableStreamToAsyncIterable,
+  removeDoubleLeadingSlash: () => removeDoubleLeadingSlash,
+  removeLeadingNumbers: () => removeLeadingNumbers,
+  removeLeadingSeparators: () => removeLeadingSeparators,
+  removeNonAlphanumeric: () => removeNonAlphanumeric,
+  removeTrailingSlash: () => removeTrailingSlash,
   safeParse: () => safeParse,
   safeStringify: () => safeStringify,
+  sanitizePathSlashes: () => sanitizePathSlashes,
   sortObjectKeys: () => sortObjectKeys,
-  stripUndefinedProperties: () => stripUndefinedProperties
+  splitBySeparators: () => splitBySeparators,
+  stripUndefinedProperties: () => stripUndefinedProperties,
+  toCamelCaseIdentifier: () => toCamelCaseIdentifier,
+  toPrettyCamelCase: () => toPrettyCamelCase,
+  toRecord: () => toRecord,
+  toValidIdentifier: () => toValidIdentifier,
+  uncapitalize: () => uncapitalize
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/camelCase.ts
+var SEPARATOR_REGEX = /[ \-_./:]+/g;
+var LEADING_SEPARATOR_REGEX = /^[ \-_./:]+/;
+var NON_ALPHANUMERIC_REGEX = /[^a-zA-Z0-9]/g;
+var LEADING_NUMBERS_REGEX = /^[0-9]+/;
+function removeLeadingSeparators(str) {
+  return str.replace(LEADING_SEPARATOR_REGEX, "");
+}
+function splitBySeparators(str) {
+  return str.split(SEPARATOR_REGEX).filter((part) => part.length > 0);
+}
+function removeNonAlphanumeric(str) {
+  return str.replace(NON_ALPHANUMERIC_REGEX, "");
+}
+function removeLeadingNumbers(str) {
+  return str.replace(LEADING_NUMBERS_REGEX, "");
+}
+function capitalize(str) {
+  if (!str) return str;
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function uncapitalize(str) {
+  if (!str) return str;
+  return str.charAt(0).toLowerCase() + str.slice(1);
+}
+function joinCamelCase(parts) {
+  if (parts.length === 0) return "";
+  const cleanedParts = parts.map(removeNonAlphanumeric).filter((part) => part.length > 0);
+  if (cleanedParts.length === 0) return "";
+  const [first, ...rest] = cleanedParts;
+  return uncapitalize(first) + rest.map(capitalize).join("");
+}
+function joinPrettyCamelCase(parts) {
+  if (parts.length === 0) return "";
+  const cleanedParts = parts.map((part) => removeNonAlphanumeric(part.toLowerCase())).filter((part) => part.length > 0);
+  if (cleanedParts.length === 0) return "";
+  const [first, ...rest] = cleanedParts;
+  return first + rest.map(capitalize).join("");
+}
+function toCamelCaseIdentifier(str) {
+  if (typeof str !== "string") return String(str);
+  try {
+    const withoutLeadingSeparators = removeLeadingSeparators(str);
+    const parts = splitBySeparators(withoutLeadingSeparators);
+    const camelCased = joinCamelCase(parts);
+    const withoutLeadingNumbers = removeLeadingNumbers(camelCased);
+    return withoutLeadingNumbers || str;
+  } catch {
+    return str;
+  }
+}
+function toPrettyCamelCase(str) {
+  if (typeof str !== "string") return String(str);
+  try {
+    const withoutLeadingSeparators = removeLeadingSeparators(str);
+    const parts = splitBySeparators(withoutLeadingSeparators);
+    const camelCased = joinPrettyCamelCase(parts);
+    const withoutLeadingNumbers = removeLeadingNumbers(camelCased);
+    return withoutLeadingNumbers || str;
+  } catch {
+    return str;
+  }
+}
+function toValidIdentifier(str) {
+  return toCamelCaseIdentifier(str);
+}
+function isValidIdentifier(str) {
+  if (typeof str !== "string" || str.length === 0) return false;
+  if (!/^[a-zA-Z_$]/.test(str)) return false;
+  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(str);
+}
+function getTransformationInfo(str) {
+  const withoutLeadingSeparators = removeLeadingSeparators(str);
+  const parts = splitBySeparators(withoutLeadingSeparators);
+  const camelCase = joinCamelCase(parts);
+  const prettyCamelCase = joinPrettyCamelCase(parts);
+  const withoutLeadingNumbers = removeLeadingNumbers(camelCase);
+  const prettyCamelCaseWithoutLeadingNumbers = removeLeadingNumbers(prettyCamelCase);
+  return {
+    original: str,
+    withoutLeadingSeparators,
+    parts,
+    camelCase,
+    prettyCamelCase,
+    withoutLeadingNumbers,
+    prettyCamelCaseWithoutLeadingNumbers,
+    isValid: isValidIdentifier(withoutLeadingNumbers)
+  };
+}
+
+// src/emptyObject.ts
+var emptyObject = {};
+
 // src/extractArgumentNames.ts
 function extractArgumentNames(func) {
   const fnStr = func.toString();
@@ -96,18 +206,10 @@ function isTrue(value) {
   return value;
 }
 
-// src/InMemoryFile.ts
-var InMemoryFile = class extends File {
-  constructor(content, name, {
-    type,
-    endings,
-    lastModified
-  }) {
-    super([Buffer.from(content)], name, {
-      type,
-      endings,
-      lastModified
-    });
+// src/InMemoryBlob.ts
+var InMemoryBlob = class extends Blob {
+  constructor(content) {
+    super([Buffer.from(content)]);
     this.content = content;
   }
 };
@@ -116,6 +218,11 @@ var InMemoryFile = class extends File {
 function noop(..._args) {
 }
 
+// src/openApiCompliantPath.ts
+function openApiCompliantPath(path) {
+  return path.replaceAll(/:(\w+)/g, "{$1}");
+}
+
 // src/readableStreamToAsyncIterable.ts
 async function* readableStreamToAsyncIterable(stream) {
   const reader = stream.getReader();
@@ -212,6 +319,17 @@ function safeStringify(arg) {
   }
 }
 
+// src/slashManipulation.ts
+function removeTrailingSlash(path) {
+  return path.replace(/\/$/, "");
+}
+function removeDoubleLeadingSlash(path) {
+  return path.replace(/^\/\//, "/");
+}
+function sanitizePathSlashes(path) {
+  return removeDoubleLeadingSlash(removeTrailingSlash(path));
+}
+
 // src/sortObjectKeys.ts
 function sortObjectKeys(obj) {
   if (typeof obj !== "object" || obj === null) {
@@ -233,20 +351,42 @@ function stripUndefinedProperties(obj) {
     Object.entries(obj).filter(([, value]) => value !== void 0)
   );
 }
+
+// src/toRecord.ts
+function toRecord(obj) {
+  return obj;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  InMemoryFile,
+  InMemoryBlob,
+  capitalize,
+  emptyObject,
   extractArgumentNames,
   getEnvVar,
+  getTransformationInfo,
   isAsyncGenerator,
   isNever,
   isNodeJsWriteableStream,
   isRecord,
   isTrue,
+  isValidIdentifier,
   noop,
+  openApiCompliantPath,
   readableStreamToAsyncIterable,
+  removeDoubleLeadingSlash,
+  removeLeadingNumbers,
+  removeLeadingSeparators,
+  removeNonAlphanumeric,
+  removeTrailingSlash,
   safeParse,
   safeStringify,
+  sanitizePathSlashes,
   sortObjectKeys,
-  stripUndefinedProperties
+  splitBySeparators,
+  stripUndefinedProperties,
+  toCamelCaseIdentifier,
+  toPrettyCamelCase,
+  toRecord,
+  toValidIdentifier,
+  uncapitalize
 });

package/lib/index.mjs

@@ -1,3 +1,96 @@
+// src/camelCase.ts
+var SEPARATOR_REGEX = /[ \-_./:]+/g;
+var LEADING_SEPARATOR_REGEX = /^[ \-_./:]+/;
+var NON_ALPHANUMERIC_REGEX = /[^a-zA-Z0-9]/g;
+var LEADING_NUMBERS_REGEX = /^[0-9]+/;
+function removeLeadingSeparators(str) {
+  return str.replace(LEADING_SEPARATOR_REGEX, "");
+}
+function splitBySeparators(str) {
+  return str.split(SEPARATOR_REGEX).filter((part) => part.length > 0);
+}
+function removeNonAlphanumeric(str) {
+  return str.replace(NON_ALPHANUMERIC_REGEX, "");
+}
+function removeLeadingNumbers(str) {
+  return str.replace(LEADING_NUMBERS_REGEX, "");
+}
+function capitalize(str) {
+  if (!str) return str;
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function uncapitalize(str) {
+  if (!str) return str;
+  return str.charAt(0).toLowerCase() + str.slice(1);
+}
+function joinCamelCase(parts) {
+  if (parts.length === 0) return "";
+  const cleanedParts = parts.map(removeNonAlphanumeric).filter((part) => part.length > 0);
+  if (cleanedParts.length === 0) return "";
+  const [first, ...rest] = cleanedParts;
+  return uncapitalize(first) + rest.map(capitalize).join("");
+}
+function joinPrettyCamelCase(parts) {
+  if (parts.length === 0) return "";
+  const cleanedParts = parts.map((part) => removeNonAlphanumeric(part.toLowerCase())).filter((part) => part.length > 0);
+  if (cleanedParts.length === 0) return "";
+  const [first, ...rest] = cleanedParts;
+  return first + rest.map(capitalize).join("");
+}
+function toCamelCaseIdentifier(str) {
+  if (typeof str !== "string") return String(str);
+  try {
+    const withoutLeadingSeparators = removeLeadingSeparators(str);
+    const parts = splitBySeparators(withoutLeadingSeparators);
+    const camelCased = joinCamelCase(parts);
+    const withoutLeadingNumbers = removeLeadingNumbers(camelCased);
+    return withoutLeadingNumbers || str;
+  } catch {
+    return str;
+  }
+}
+function toPrettyCamelCase(str) {
+  if (typeof str !== "string") return String(str);
+  try {
+    const withoutLeadingSeparators = removeLeadingSeparators(str);
+    const parts = splitBySeparators(withoutLeadingSeparators);
+    const camelCased = joinPrettyCamelCase(parts);
+    const withoutLeadingNumbers = removeLeadingNumbers(camelCased);
+    return withoutLeadingNumbers || str;
+  } catch {
+    return str;
+  }
+}
+function toValidIdentifier(str) {
+  return toCamelCaseIdentifier(str);
+}
+function isValidIdentifier(str) {
+  if (typeof str !== "string" || str.length === 0) return false;
+  if (!/^[a-zA-Z_$]/.test(str)) return false;
+  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(str);
+}
+function getTransformationInfo(str) {
+  const withoutLeadingSeparators = removeLeadingSeparators(str);
+  const parts = splitBySeparators(withoutLeadingSeparators);
+  const camelCase = joinCamelCase(parts);
+  const prettyCamelCase = joinPrettyCamelCase(parts);
+  const withoutLeadingNumbers = removeLeadingNumbers(camelCase);
+  const prettyCamelCaseWithoutLeadingNumbers = removeLeadingNumbers(prettyCamelCase);
+  return {
+    original: str,
+    withoutLeadingSeparators,
+    parts,
+    camelCase,
+    prettyCamelCase,
+    withoutLeadingNumbers,
+    prettyCamelCaseWithoutLeadingNumbers,
+    isValid: isValidIdentifier(withoutLeadingNumbers)
+  };
+}
+
+// src/emptyObject.ts
+var emptyObject = {};
+
 // src/extractArgumentNames.ts
 function extractArgumentNames(func) {
   const fnStr = func.toString();
@@ -57,18 +150,10 @@ function isTrue(value) {
   return value;
 }
 
-// src/InMemoryFile.ts
-var InMemoryFile = class extends File {
-  constructor(content, name, {
-    type,
-    endings,
-    lastModified
-  }) {
-    super([Buffer.from(content)], name, {
-      type,
-      endings,
-      lastModified
-    });
+// src/InMemoryBlob.ts
+var InMemoryBlob = class extends Blob {
+  constructor(content) {
+    super([Buffer.from(content)]);
     this.content = content;
   }
 };
@@ -77,6 +162,11 @@ var InMemoryFile = class extends File {
 function noop(..._args) {
 }
 
+// src/openApiCompliantPath.ts
+function openApiCompliantPath(path) {
+  return path.replaceAll(/:(\w+)/g, "{$1}");
+}
+
 // src/readableStreamToAsyncIterable.ts
 async function* readableStreamToAsyncIterable(stream) {
   const reader = stream.getReader();
@@ -173,6 +263,17 @@ function safeStringify(arg) {
   }
 }
 
+// src/slashManipulation.ts
+function removeTrailingSlash(path) {
+  return path.replace(/\/$/, "");
+}
+function removeDoubleLeadingSlash(path) {
+  return path.replace(/^\/\//, "/");
+}
+function sanitizePathSlashes(path) {
+  return removeDoubleLeadingSlash(removeTrailingSlash(path));
+}
+
 // src/sortObjectKeys.ts
 function sortObjectKeys(obj) {
   if (typeof obj !== "object" || obj === null) {
@@ -194,19 +295,41 @@ function stripUndefinedProperties(obj) {
     Object.entries(obj).filter(([, value]) => value !== void 0)
   );
 }
+
+// src/toRecord.ts
+function toRecord(obj) {
+  return obj;
+}
 export {
-  InMemoryFile,
+  InMemoryBlob,
+  capitalize,
+  emptyObject,
   extractArgumentNames,
   getEnvVar,
+  getTransformationInfo,
   isAsyncGenerator,
   isNever,
   isNodeJsWriteableStream,
   isRecord,
   isTrue,
+  isValidIdentifier,
   noop,
+  openApiCompliantPath,
   readableStreamToAsyncIterable,
+  removeDoubleLeadingSlash,
+  removeLeadingNumbers,
+  removeLeadingSeparators,
+  removeNonAlphanumeric,
+  removeTrailingSlash,
   safeParse,
   safeStringify,
+  sanitizePathSlashes,
   sortObjectKeys,
-  stripUndefinedProperties
+  splitBySeparators,
+  stripUndefinedProperties,
+  toCamelCaseIdentifier,
+  toPrettyCamelCase,
+  toRecord,
+  toValidIdentifier,
+  uncapitalize
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/common",
-  "version": "0.3.14",
+  "version": "0.4.1",
   "description": "Common package for base types, interfaces, implementations.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -28,16 +28,16 @@
     "lib/**"
   ],
   "devDependencies": {
-    "@eslint/js": "^9.29.0",
-    "@types/node": "^24.0.3",
-    "@typescript/native-preview": "7.0.0-dev.20250619.1",
+    "@eslint/js": "^9.30.1",
+    "@types/node": "^24.0.10",
+    "@typescript/native-preview": "7.0.0-dev.20250702.1",
     "depcheck": "^1.4.7",
-    "eslint": "^9.29.0",
-    "globals": "^16.2.0",
+    "eslint": "^9.30.1",
+    "globals": "^16.3.0",
     "tsup": "^8.5.0",
-    "typedoc": "^0.28.5",
+    "typedoc": "^0.28.7",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.34.1",
+    "typescript-eslint": "^8.35.1",
     "vitest": "^3.2.4"
   },
   "scripts": {