@jahands/dagger-helpers 0.3.0 → 0.5.0

package/dist/convert/camel-to-snake.d.ts

@@ -0,0 +1,53 @@
+type IsLower<C extends string> = Lowercase<C> extends Uppercase<C> ? false : C extends Lowercase<C> ? true : false;
+type IsUpper<C extends string> = Lowercase<C> extends Uppercase<C> ? false : C extends Uppercase<C> ? true : false;
+type IsDigit<C extends string> = C extends `${number}` ? true : false;
+type CamelToSnakeInner<S extends string, PrevChar extends string = ''> = S extends '' ? '' : S extends `${infer First}${infer Rest}` ? IsUpper<First> extends true ? IsLower<PrevChar> extends true ? `_${Uppercase<First>}${CamelToSnakeInner<Rest, First>}` : IsDigit<PrevChar> extends true ? `_${Uppercase<First>}${CamelToSnakeInner<Rest, First>}` : Rest extends `${infer NextChar}${string}` ? IsLower<NextChar> extends true ? `_${Uppercase<First>}${CamelToSnakeInner<Rest, First>}` : `${Uppercase<First>}${CamelToSnakeInner<Rest, First>}` : `${Uppercase<First>}${CamelToSnakeInner<Rest, First>}` : IsDigit<First> extends true ? IsLower<PrevChar> extends true ? `_${First}${CamelToSnakeInner<Rest, First>}` : `${First}${CamelToSnakeInner<Rest, First>}` : `${Uppercase<First>}${CamelToSnakeInner<Rest, First>}` : '';
+/**
+ * Type helper to convert a camelCase/PascalCase string literal type
+ * to an UPPER_SNAKE_CASE string literal type. Handles common cases
+ * including transitions from lower to upper, letters to digits, and basic acronyms.
+ *
+ * Examples:
+ *   'userId' -> 'USER_ID'
+ *   'userName' -> 'USER_NAME'
+ *   'isActive' -> 'IS_ACTIVE'
+ *   'APIKey' -> 'API_KEY'
+ *   'version10' -> 'VERSION_10'
+ *   'apiV2Client' -> 'API_V2_CLIENT'
+ */
+type CamelToSnakeCase<S extends string> = S extends `${infer First}${infer Rest}` ? `${Uppercase<First>}${CamelToSnakeInner<Rest, First>}` : Uppercase<S>;
+/**
+ * Converts a camelCase or PascalCase string to UPPER_SNAKE_CASE.
+ * Handles acronyms and numbers within the string.
+ *
+ * **Examples:**
+ * ```
+ *   'helloWorld' -> 'HELLO_WORLD'
+ *   'HelloWorld' -> 'HELLO_WORLD'
+ *   'someAPIKey' -> 'SOME_API_KEY'
+ *   'getHttpResponseCode' -> 'GET_HTTP_RESPONSE_CODE'
+ *   'version10' -> 'VERSION_10' // Fixed
+ *   'version10Alpha' -> 'VERSION_10_ALPHA' // Fixed
+ *   'apiV2Client' -> 'API_V2_CLIENT'
+ *   'releaseV10' -> 'RELEASE_V10'
+ *   'version2Data' -> 'VERSION_2_DATA' // Fixed
+ *   'word' -> 'WORD'
+ *```
+ * @param str The input string in camelCase or PascalCase format.
+ * @returns The converted string in UPPER_SNAKE_CASE format.
+ */
+export declare function camelToSnake(str: string): string;
+/**
+ * Converts an object's keys from camelCase/PascalCase to UPPER_SNAKE_CASE.
+ * Provides compile-time type safety for the converted keys based on common patterns.
+ *
+ * @template T The type of the input object.
+ * @param input The object with camelCase/PascalCase keys.
+ * @returns A new object with the same values but UPPER_SNAKE_CASE keys,
+ *          with an inferred type reflecting the key transformation.
+ */
+export declare function convertToSnake<T extends Record<string, any>>(input: T): {
+    [K in keyof T as CamelToSnakeCase<K & string>]: T[K];
+};
+export {};
+//# sourceMappingURL=camel-to-snake.d.ts.map

package/dist/convert/camel-to-snake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-to-snake.d.ts","sourceRoot":"","sources":["../../src/convert/camel-to-snake.ts"],"names":[],"mappings":"AAGA,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAC5B,SAAS,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAA;AAElF,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAC5B,SAAS,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAA;AAElF,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,CAAA;AAIrE,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,EAAE,IAEpE,CAAC,SAAS,EAAE,GACT,EAAE,GAEH,CAAC,SAAS,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,GAItC,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,GAE1B,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,GAC5B,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,GAC7B,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAExD,IAAI,SAAS,GAAG,MAAM,QAAQ,GAAG,MAAM,EAAE,GACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,GAC7B,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GACvD,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAExD,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAEzD,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,GAE1B,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,GAC5B,IAAI,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAE7C,GAAG,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAG5C,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAExD,EAAE,CAAA;AAEN;;;;;;;;;;;;GAYG;AACH,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,GAE/E,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAEtD,SAAS,CAAC,CAAC,CAAC,CAAA;AAEd;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,KAAK,EAAE,CAAC,GAEN;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAe1D"}

package/dist/convert/camel-to-snake.js

@@ -0,0 +1,66 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Converts a camelCase or PascalCase string to UPPER_SNAKE_CASE.
+ * Handles acronyms and numbers within the string.
+ *
+ * **Examples:**
+ * ```
+ *   'helloWorld' -> 'HELLO_WORLD'
+ *   'HelloWorld' -> 'HELLO_WORLD'
+ *   'someAPIKey' -> 'SOME_API_KEY'
+ *   'getHttpResponseCode' -> 'GET_HTTP_RESPONSE_CODE'
+ *   'version10' -> 'VERSION_10' // Fixed
+ *   'version10Alpha' -> 'VERSION_10_ALPHA' // Fixed
+ *   'apiV2Client' -> 'API_V2_CLIENT'
+ *   'releaseV10' -> 'RELEASE_V10'
+ *   'version2Data' -> 'VERSION_2_DATA' // Fixed
+ *   'word' -> 'WORD'
+ *```
+ * @param str The input string in camelCase or PascalCase format.
+ * @returns The converted string in UPPER_SNAKE_CASE format.
+ */
+export function camelToSnake(str) {
+    if (!str) {
+        return '';
+    }
+    // The sequence matters:
+    const result = str
+        // 1. Add _ before an uppercase letter that is followed by a lowercase letter,
+        //    but only if the uppercase letter is not the start of the string and
+        //    is preceded by another uppercase letter (handles acronyms like APIKey -> API_Key).
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')
+        // 2. Add _ before an uppercase letter that is preceded by a lowercase letter or a digit.
+        //    (handles helloWorld -> hello_World, version10Update -> version10_Update, apiV2Client -> api_V2Client)
+        .replace(/([a-z\d])([A-Z])/g, '$1_$2')
+        // 3. Add _ between a lowercase letter and a number.
+        //    (handles version10 -> version_10, but NOT V10 -> V_10 because V is uppercase)
+        .replace(/([a-z])(\d)/g, '$1_$2');
+    // Convert the entire result to uppercase
+    return result.toUpperCase();
+}
+/**
+ * Converts an object's keys from camelCase/PascalCase to UPPER_SNAKE_CASE.
+ * Provides compile-time type safety for the converted keys based on common patterns.
+ *
+ * @template T The type of the input object.
+ * @param input The object with camelCase/PascalCase keys.
+ * @returns A new object with the same values but UPPER_SNAKE_CASE keys,
+ *          with an inferred type reflecting the key transformation.
+ */
+export function convertToSnake(input
+// Apply the mapped type with key remapping using the type helper
+) {
+    const output = {}; // Initialize as 'any' or '{}'
+    for (const key in input) {
+        if (Object.prototype.hasOwnProperty.call(input, key)) {
+            const snakeCaseKey = camelToSnake(key); // Runtime conversion
+            output[snakeCaseKey] = input[key];
+        }
+    }
+    // Type assertion: We trust the runtime `camelToSnake` logic produces keys
+    // matching the structure defined by the `CamelToSnakeCase` type helper.
+    // This is needed because TS can't perfectly verify the runtime logic
+    // against the complex type-level logic for all possible inputs.
+    return output;
+}
+//# sourceMappingURL=camel-to-snake.js.map

package/dist/convert/camel-to-snake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-to-snake.js","sourceRoot":"","sources":["../../src/convert/camel-to-snake.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAmEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,OAAO,EAAE,CAAA;IACV,CAAC;IAED,wBAAwB;IACxB,MAAM,MAAM,GAAG,GAAG;QACjB,8EAA8E;QAC9E,yEAAyE;QACzE,wFAAwF;SACvF,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;QACzC,yFAAyF;QACzF,2GAA2G;SAC1G,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC;QACtC,oDAAoD;QACpD,mFAAmF;SAClF,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAElC,yCAAyC;IACzC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC7B,KAAQ;AACR,iEAAiE;;IAEjE,MAAM,MAAM,GAAQ,EAAE,CAAA,CAAC,8BAA8B;IAErD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA,CAAC,qBAAqB;YAC5D,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QAClC,CAAC;IACF,CAAC;IAED,0EAA0E;IAC1E,wEAAwE;IACxE,qEAAqE;IACrE,gEAAgE;IAChE,OAAO,MAAkE,CAAA;AAC1E,CAAC"}

package/dist/convert/snake-to-camel.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Helper type to capitalize the first letter of a string literal type.
+ * e.g., 'hello' -> 'Hello'
+ */
+type CapitalizeString<S extends string> = S extends `${infer First}${infer Rest}` ? `${Uppercase<First>}${Rest}` : S;
+/**
+ * Recursively transforms a snake_case string literal type to camelCase.
+ * e.g., 'SOME_API_KEY' -> 'someApiKey'
+ *       'HELLO_WORLD'  -> 'helloWorld'
+ *       'WORD'         -> 'word'
+ */
+type SnakeToCamelCase<S extends string> = S extends `${infer T}_${infer U}` ? `${Lowercase<T>}${CapitalizeString<SnakeToCamelCase<U>>}` : Lowercase<S>;
+/**
+ * Converts a string from snake_case, UPPER_SNAKE_CASE, PascalCase,
+ * or ALL_CAPS to camelCase at runtime.
+ * If the string is already camelCase or lowercase, it remains unchanged.
+ *
+ * @param str The input string in snake_case format.
+ * @returns The converted string in camelCase format.
+ */
+export declare function snakeToCamel(str: string): string;
+/**
+ * Converts an object's keys from snake_case or UPPER_SNAKE_CASE to camelCase.
+ * The return type precisely maps the input keys to their camelCase versions.
+ *
+ * @template T The type of the input object, expected to have string keys.
+ * @param input The object with snake_case keys.
+ * @returns A new object with the same values but camelCase keys, with a specific inferred type.
+ */
+export declare function convertToCamel<T extends Record<string, any>>(input: T): {
+    [K in keyof T as SnakeToCamelCase<K & string>]: T[K];
+};
+export {};
+//# sourceMappingURL=snake-to-camel.d.ts.map

package/dist/convert/snake-to-camel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-to-camel.d.ts","sourceRoot":"","sources":["../../src/convert/snake-to-camel.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,GAC9E,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,GAC5B,CAAC,CAAA;AAEJ;;;;;GAKG;AACH,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GACxE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,GACzD,SAAS,CAAC,CAAC,CAAC,CAAA;AAEf;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA+ChD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,KAAK,EAAE,CAAC,GACN;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAe1D"}

package/dist/convert/snake-to-camel.js

@@ -0,0 +1,77 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Converts a string from snake_case, UPPER_SNAKE_CASE, PascalCase,
+ * or ALL_CAPS to camelCase at runtime.
+ * If the string is already camelCase or lowercase, it remains unchanged.
+ *
+ * @param str The input string in snake_case format.
+ * @returns The converted string in camelCase format.
+ */
+export function snakeToCamel(str) {
+    if (!str) {
+        return '';
+    }
+    // Case 1: String contains underscores (snake_case)
+    if (str.includes('_')) {
+        let result = '';
+        const parts = str.split('_');
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            if (part) {
+                // Skip empty parts from multiple underscores
+                if (result.length === 0) {
+                    // First non-empty part: lowercase the whole part
+                    result += part.toLowerCase();
+                }
+                else {
+                    // Subsequent non-empty parts: capitalize first letter, rest lowercase
+                    result += part[0].toUpperCase() + part.slice(1).toLowerCase();
+                }
+            }
+        }
+        // Handle case like "_SOME_WORD_" -> "someWord"
+        // If the first character of the original string was '_' and result is empty,
+        // it means the string was only underscores, return ''
+        // If the first part was empty ('_WORD'), result starts lowercase correctly.
+        return result;
+    }
+    // Case 2: String does NOT contain underscores
+    // Check if it's ALL_CAPS (allowing for numbers)
+    const isAllCaps = /^[A-Z0-9]+$/.test(str);
+    if (isAllCaps) {
+        // e.g., "WORD", "TOKEN123" -> "word", "token123"
+        return str.toLowerCase();
+    }
+    // Check if it's PascalCase or already camelCase/lowercase
+    // If the first letter is already lowercase, assume it's camelCase or lowercase
+    if (str[0] === str[0].toLowerCase()) {
+        // e.g., "helloWorld", "word" -> stays the same
+        return str;
+    }
+    // Otherwise, assume it's PascalCase: Lowercase only the first character
+    // e.g., "HelloWorld", "SomeValue" -> "helloWorld", "someValue"
+    return str[0].toLowerCase() + str.slice(1);
+}
+/**
+ * Converts an object's keys from snake_case or UPPER_SNAKE_CASE to camelCase.
+ * The return type precisely maps the input keys to their camelCase versions.
+ *
+ * @template T The type of the input object, expected to have string keys.
+ * @param input The object with snake_case keys.
+ * @returns A new object with the same values but camelCase keys, with a specific inferred type.
+ */
+export function convertToCamel(input) {
+    const output = {};
+    for (const key in input) {
+        if (Object.prototype.hasOwnProperty.call(input, key)) {
+            const camelCaseKey = snakeToCamel(key);
+            output[camelCaseKey] = input[key];
+        }
+    }
+    // We use a type assertion here. While our runtime logic creates the correct
+    // shape, TypeScript's analysis within the loop isn't powerful enough to
+    // automatically verify that 'output' perfectly matches the complex mapped type.
+    // The return type annotation guarantees the type for the caller.
+    return output;
+}
+//# sourceMappingURL=snake-to-camel.js.map

package/dist/convert/snake-to-camel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-to-camel.js","sourceRoot":"","sources":["../../src/convert/snake-to-camel.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAoBvD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,OAAO,EAAE,CAAA;IACV,CAAC;IAED,mDAAmD;IACnD,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YACrB,IAAI,IAAI,EAAE,CAAC;gBACV,6CAA6C;gBAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,iDAAiD;oBACjD,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAA;gBAC7B,CAAC;qBAAM,CAAC;oBACP,sEAAsE;oBACtE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;gBAC/D,CAAC;YACF,CAAC;QACF,CAAC;QACD,+CAA+C;QAC/C,6EAA6E;QAC7E,sDAAsD;QACtD,4EAA4E;QAC5E,OAAO,MAAM,CAAA;IACd,CAAC;IAED,8CAA8C;IAC9C,gDAAgD;IAChD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzC,IAAI,SAAS,EAAE,CAAC;QACf,iDAAiD;QACjD,OAAO,GAAG,CAAC,WAAW,EAAE,CAAA;IACzB,CAAC;IAED,0DAA0D;IAC1D,+EAA+E;IAC/E,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACtC,+CAA+C;QAC/C,OAAO,GAAG,CAAA;IACX,CAAC;IAED,wEAAwE;IACxE,+DAA+D;IAC/D,OAAO,GAAG,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC7B,KAAQ;IAER,MAAM,MAAM,GAAQ,EAAE,CAAA;IAEtB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;YACtC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QAClC,CAAC;IACF,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,gFAAgF;IAChF,iEAAiE;IACjE,OAAO,MAAkE,CAAA;AAC1E,CAAC"}

package/dist/env.d.ts

@@ -1,3 +1,4 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
 import type { Secret } from '@dagger.io/dagger';
 /**
  * Structure stored in AsyncLocalStorage, containing both the fully merged
@@ -11,7 +12,7 @@ export interface EnvContext {
 /**
  * Store for environment variables accessible via AsyncLocalStorage
  */
-export declare const envStorage: any;
+export declare const envStorage: AsyncLocalStorage<EnvContext>;
 /**
  * Helper to extract parameter names from a function's source code.
  * Note: This approach using Function.toString() can be fragile and might

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,KAAsC,CAAA;AAE7D;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CA8B1D;AAED;;;GAGG;AAEH,wBAAgB,WAAW,IAAI,eAAe,CA6D7C"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,+BAAsC,CAAA;AAE7D;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CA8B1D;AAED;;;GAGG;AAEH,wBAAgB,WAAW,IAAI,eAAe,CA6D7C"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export { constants } from './constants.js';
 export { ParamsToEnv, envStorage } from './env.js';
 export type { EnvContext } from './env.js';
-export { sh } from './shell.js';
+export { sh, shell } from './shell.js';
+export { getModulePath } from './path.js';
+export { convertToCamel } from './convert/snake-to-camel.js';
+export { convertToSnake } from './convert/camel-to-snake.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/index.js

@@ -1,4 +1,7 @@
 export { constants } from './constants.js';
 export { ParamsToEnv, envStorage } from './env.js';
-export { sh } from './shell.js';
+export { sh, shell } from './shell.js';
+export { getModulePath } from './path.js';
+export { convertToCamel } from './convert/snake-to-camel.js';
+export { convertToSnake } from './convert/camel-to-snake.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAGlD,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAGlD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/path.d.ts

@@ -0,0 +1,12 @@
+export declare function getRepoRoot(cwd?: string): string;
+/**
+ * Get the path to the dagger module.
+ *
+ * Requires `pnpm-lock.yaml` to exist in the repo root.
+ *
+ * @param cwd - The current working directory. **Default:** `process.cwd()`
+ *
+ * @returns The path to the dagger module relative to the repo root
+ */
+export declare function getModulePath(cwd?: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAelD"}

package/dist/path.js

@@ -0,0 +1,33 @@
+import path from 'node:path';
+import { up } from 'empathic/find';
+export function getRepoRoot(cwd) {
+    cwd = cwd ?? process.cwd();
+    const lockfile = up('pnpm-lock.yaml', { cwd });
+    if (!lockfile) {
+        throw new Error('could not determine repo root path: unable to find pnpm-lock.yaml');
+    }
+    return path.dirname(lockfile);
+}
+/**
+ * Get the path to the dagger module.
+ *
+ * Requires `pnpm-lock.yaml` to exist in the repo root.
+ *
+ * @param cwd - The current working directory. **Default:** `process.cwd()`
+ *
+ * @returns The path to the dagger module relative to the repo root
+ */
+export function getModulePath(cwd) {
+    cwd = cwd ?? process.cwd();
+    const lockfile = up('pnpm-lock.yaml', { cwd });
+    if (!lockfile) {
+        throw new Error('could not determine repo root path: unable to find pnpm-lock.yaml');
+    }
+    const repoRoot = path.dirname(lockfile);
+    const daggerJson = up('dagger.json', { cwd, stop: repoRoot });
+    if (!daggerJson) {
+        throw new Error('could not determine dagger.json path: unable to find dagger.json');
+    }
+    return path.relative(repoRoot, path.dirname(daggerJson));
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,MAAM,UAAU,WAAW,CAAC,GAAY;IACvC,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAE1B,MAAM,QAAQ,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;IACrF,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACzC,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAE1B,MAAM,QAAQ,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;IACrF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAEvC,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IACpF,CAAC;IAED,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;AACzD,CAAC"}

package/dist/shell.d.ts

@@ -1,6 +1,8 @@
 /**
  * Run command with bash
  *
+ * @deprecated use shell() instead
+ *
  * @example
  *
  * ```ts
@@ -8,4 +10,17 @@
  * ```
  */
 export declare function sh(input: string | string[]): string[];
+/**
+ * Create a new shell helper with the given shell type
+ *
+ * @param shellName - The name of the shell to use
+ *
+ * @example
+ *
+ * ```ts
+ * const sh = shell('bash')
+ * .withExec(sh('echo hello world!'))
+ * ```
+ */
+export declare function shell(shellName: 'sh' | 'bash' | 'zsh'): (input: string | string[]) => string[];
 //# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CASrD"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAUrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,WACtC,MAAM,GAAG,MAAM,EAAE,KAAG,MAAM,EAAE,CAW3C"}

package/dist/shell.js

@@ -1,6 +1,8 @@
 /**
  * Run command with bash
  *
+ * @deprecated use shell() instead
+ *
  * @example
  *
  * ```ts
@@ -10,9 +12,33 @@
 export function sh(input) {
     const inputAr = Array.isArray(input) ? input : [input];
     const trimmedInput = inputAr.map((i) => i
+        .trim()
         .split('\n')
         .map((l) => l.trim())
         .join('\n'));
     return ['bash', '-c', trimmedInput].flat();
 }
+/**
+ * Create a new shell helper with the given shell type
+ *
+ * @param shellName - The name of the shell to use
+ *
+ * @example
+ *
+ * ```ts
+ * const sh = shell('bash')
+ * .withExec(sh('echo hello world!'))
+ * ```
+ */
+export function shell(shellName) {
+    return (input) => {
+        const inputAr = Array.isArray(input) ? input : [input];
+        const trimmedInput = inputAr.map((i) => i
+            .trim()
+            .split('\n')
+            .map((l) => l.trim())
+            .join('\n'));
+        return [shellName, '-c', trimmedInput].flat();
+    };
+}
 //# sourceMappingURL=shell.js.map

package/dist/shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,EAAE,CAAC,KAAwB;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC;SACC,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,IAAI,CAAC,CACZ,CAAA;IACD,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAA;AAC3C,CAAC"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,EAAE,CAAC,KAAwB;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC;SACC,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,IAAI,CAAC,CACZ,CAAA;IACD,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAA;AAC3C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,SAAgC;IACrD,OAAO,CAAC,KAAwB,EAAY,EAAE;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC;aACC,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,CACZ,CAAA;QACD,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9C,CAAC,CAAA;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jahands/dagger-helpers",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "private": false,
   "description": "dagger.io helpers for my own projects - not meant for public use",
   "keywords": [
@@ -33,7 +33,11 @@
   "files": [
     "dist"
   ],
+  "dependencies": {
+    "empathic": "1.0.0"
+  },
   "devDependencies": {
+    "@types/node": "20.8.3",
     "typescript": "5.5.4",
     "vitest": "2.1.1",
     "@repo/tools": "0.8.1",