@kamaalio/codemods 0.0.1 → 0.0.2

package/dist/commands/run.js

@@ -0,0 +1,91 @@
+import { parseArgs } from 'node:util';
+import { CODEMOD_REGISTRY } from '../codemods/registry.js';
+import { CliUsageError } from '../errors.js';
+import { loadCodemodConfig } from '../kit/config.js';
+import { runCodemod } from '../kit/runner.js';
+const DEFAULT_DRY_RUN_OPTION = false;
+const DEFAULT_NO_LOG_OPTION = false;
+const DEFAULT_PATH_ARG = '.';
+/** Mirrors oclif's `charAliases`: accept the uppercase short flag as an alias for the lowercase one. */
+const UPPERCASE_SHORT_FLAG_ALIASES = { '-C': '-c', '-D': '-d', '-N': '-n' };
+export function makeRunHelpText(name) {
+    return `${CODEMOD_REGISTRY[name].summary}
+
+USAGE
+  $ codemods ${name} [PATH] [-d] [-n] [-c <value>]
+
+ARGUMENTS
+  PATH  The file or directory path to transform (default: ".")
+
+FLAGS
+  -c, --config=<value>  Path to a JSON config file listing the paths to migrate (mutually exclusive with the path argument)
+  -d, --dry              When enabled the transformer will not write to the file but print what would have changed instead
+  -n, --no-log           When enabled no logs will be displayed
+
+EXAMPLES
+  $ codemods ${name}
+  $ codemods ${name} ./src --dry
+`;
+}
+export async function runCodemodCommand(name, argv) {
+    const start = performance.now();
+    const { flags, path } = parseRunArgs(argv);
+    if (flags.config != null && path !== DEFAULT_PATH_ARG) {
+        throw new CliUsageError("Cannot use '--config' together with a path argument. Choose one.");
+    }
+    const config = await resolveConfig(flags, path);
+    await runCodemod(CODEMOD_REGISTRY[name].codemod, config);
+    const end = performance.now();
+    if (config.log !== false) {
+        console.log(`✨ transformation took ${(end - start).toFixed(2)} milliseconds`);
+    }
+}
+function parseRunArgs(argv) {
+    const normalized = argv.map(arg => UPPERCASE_SHORT_FLAG_ALIASES[arg] ?? arg);
+    let values;
+    let positionals;
+    try {
+        ({ values, positionals } = parseArgs({
+            args: normalized,
+            options: {
+                dry: { type: 'boolean', short: 'd', default: DEFAULT_DRY_RUN_OPTION },
+                ['no-log']: { type: 'boolean', short: 'n', default: DEFAULT_NO_LOG_OPTION },
+                config: { type: 'string', short: 'c' },
+            },
+            allowPositionals: true,
+            strict: true,
+        }));
+    }
+    catch (error) {
+        throw new CliUsageError(error instanceof Error ? error.message : String(error));
+    }
+    if (positionals.length > 1) {
+        throw new CliUsageError(`Unexpected argument '${positionals[1]}'.`);
+    }
+    return {
+        flags: {
+            config: values.config,
+            dry: values.dry ?? DEFAULT_DRY_RUN_OPTION,
+            'no-log': values['no-log'] ?? DEFAULT_NO_LOG_OPTION,
+        },
+        path: positionals[0] ?? DEFAULT_PATH_ARG,
+    };
+}
+async function resolveConfig(flags, path) {
+    if (flags.config == null) {
+        return { paths: [path], dry_run: flags.dry, log: !flags['no-log'] };
+    }
+    const config = await loadCodemodConfig(flags.config);
+    if (flags.dry && config.dry_run !== undefined) {
+        throw new CliUsageError("Cannot use '--dry' together with 'dry_run' in the config file. Choose one.");
+    }
+    if (flags['no-log'] && config.log !== undefined) {
+        throw new CliUsageError("Cannot use '--no-log' together with 'log' in the config file. Choose one.");
+    }
+    return {
+        ...config,
+        dry_run: flags.dry || (config.dry_run ?? false),
+        log: flags['no-log'] ? false : (config.log ?? true),
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,3 @@
+/** Thrown for invalid CLI usage (bad flags, conflicting options, unknown commands). */
+export declare class CliUsageError extends Error {
+}

package/dist/errors.js

@@ -0,0 +1,4 @@
+/** Thrown for invalid CLI usage (bad flags, conflicting options, unknown commands). */
+export class CliUsageError extends Error {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,OAAO,aAAc,SAAQ,KAAK;CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { run } from './cli.ts';
+export { default, joiToZodTransformer, JOI_TO_ZOD_LANGUAGE, JOI_TO_ZOD_CODEMOD } from './codemods/joi-to-zod/index.ts';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { run } from './cli.js';
+export { default, joiToZodTransformer, JOI_TO_ZOD_LANGUAGE, JOI_TO_ZOD_CODEMOD } from './codemods/joi-to-zod/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/kit/collections.d.ts

@@ -0,0 +1,3 @@
+type AnyCollection<Value = unknown> = Array<Value> | Set<Value>;
+export declare function collectionIsEmpty<T extends AnyCollection>(collection: T): boolean;
+export {};

package/dist/kit/collections.js

@@ -0,0 +1,9 @@
+function getCollectionCount(collection) {
+    if (Array.isArray(collection))
+        return collection.length;
+    return collection.size;
+}
+export function collectionIsEmpty(collection) {
+    return getCollectionCount(collection) === 0;
+}
+//# sourceMappingURL=collections.js.map

package/dist/kit/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/kit/collections.ts"],"names":[],"mappings":"AAEA,SAAS,kBAAkB,CAA0B,UAAa;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC;IAExD,OAAO,UAAU,CAAC,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAA0B,UAAa;IACtE,OAAO,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/kit/config.d.ts

@@ -0,0 +1,31 @@
+import z from 'zod';
+declare const CodemodConfigSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    log: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CodemodConfig = z.infer<typeof CodemodConfigSchema>;
+declare class ConfigError extends Error {
+    readonly cause: unknown;
+    constructor(message: string, options?: {
+        cause: unknown;
+    });
+}
+export declare class ConfigNotFoundError extends ConfigError {
+    constructor(configPath: string, options?: {
+        cause: unknown;
+    });
+}
+export declare class ConfigParseError extends ConfigError {
+    constructor(configPath: string, options?: {
+        cause: unknown;
+    });
+}
+export declare class ConfigValidationError extends ConfigError {
+    constructor(configPath: string, zodError: z.ZodError, options?: {
+        cause: unknown;
+    });
+}
+export declare function loadCodemodConfig(configPath: string): Promise<CodemodConfig>;
+export declare function loadCodemodConfig<Schema extends z.ZodType<CodemodConfig>>(configPath: string, schema: Schema): Promise<z.infer<Schema>>;
+export {};

package/dist/kit/config.js

@@ -0,0 +1,44 @@
+import fs from 'node:fs/promises';
+import z, { prettifyError } from 'zod';
+import { tryCatch, tryCatchAsync } from './result.js';
+const CodemodConfigSchema = z.object({
+    paths: z.array(z.string().nonempty()).nonempty(),
+    dry_run: z.boolean().optional(),
+    log: z.boolean().optional(),
+});
+class ConfigError extends Error {
+    cause;
+    constructor(message, options) {
+        super(message);
+        this.cause = options?.cause;
+    }
+}
+export class ConfigNotFoundError extends ConfigError {
+    constructor(configPath, options) {
+        super(`No config file found at '${configPath}'. Check that the path is correct.`, options);
+    }
+}
+export class ConfigParseError extends ConfigError {
+    constructor(configPath, options) {
+        const reason = options?.cause instanceof Error ? options.cause.message : String(options?.cause);
+        super(`Config file at '${configPath}' is not valid JSON: ${reason}`, options);
+    }
+}
+export class ConfigValidationError extends ConfigError {
+    constructor(configPath, zodError, options) {
+        super(`Config file at '${configPath}' failed schema validation:\n${prettifyError(zodError)}`, options);
+    }
+}
+export async function loadCodemodConfig(configPath, schema = CodemodConfigSchema) {
+    const readResult = await tryCatchAsync(() => fs.readFile(configPath, { encoding: 'utf-8' }));
+    if (readResult.isErr())
+        throw new ConfigNotFoundError(configPath, { cause: readResult.error });
+    const parsedResult = tryCatch(() => JSON.parse(readResult.value));
+    if (parsedResult.isErr())
+        throw new ConfigParseError(configPath, { cause: parsedResult.error });
+    const validated = await schema.safeParseAsync(parsedResult.value);
+    if (!validated.success)
+        throw new ConfigValidationError(configPath, validated.error);
+    return validated.data;
+}
+//# sourceMappingURL=config.js.map

package/dist/kit/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/kit/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,MAAM,WAAY,SAAQ,KAAK;IACpB,KAAK,CAAU;IAExB,YAAY,OAAe,EAAE,OAA4B;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,UAAkB,EAAE,OAA4B;QAC1D,KAAK,CAAC,4BAA4B,UAAU,oCAAoC,EAAE,OAAO,CAAC,CAAC;IAC7F,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,YAAY,UAAkB,EAAE,OAA4B;QAC1D,MAAM,MAAM,GAAG,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChG,KAAK,CAAC,mBAAmB,UAAU,wBAAwB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,UAAkB,EAAE,QAAoB,EAAE,OAA4B;QAChF,KAAK,CAAC,mBAAmB,UAAU,gCAAgC,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC;CACF;AAOD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,MAAM,GAA6B,mBAAmB;IAEtD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7F,IAAI,UAAU,CAAC,KAAK,EAAE;QAAE,MAAM,IAAI,mBAAmB,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAE/F,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,IAAI,YAAY,CAAC,KAAK,EAAE;QAAE,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;IAEhG,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,MAAM,IAAI,qBAAqB,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAErF,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC"}

package/dist/kit/constants.d.ts

@@ -0,0 +1 @@
+export declare const LANG_TO_EXTENSIONS_MAPPING: Record<string, Set<string>>;

package/dist/kit/constants.js

@@ -0,0 +1,13 @@
+import { Lang } from '@ast-grep/napi';
+const JAVASCRIPT_EXTENSIONS = ['.js', '.cjs', '.mjs'];
+const TYPESCRIPT_EXTENSIONS = JAVASCRIPT_EXTENSIONS.concat(['.ts', '.mts']);
+const JSX_EXTENSIONS = ['.jsx'];
+export const LANG_TO_EXTENSIONS_MAPPING = Object.fromEntries(Object.entries({
+    [Lang.TypeScript]: TYPESCRIPT_EXTENSIONS,
+    ts: TYPESCRIPT_EXTENSIONS,
+    [Lang.Tsx]: JSX_EXTENSIONS.concat(['.tsx']),
+    jsx: JSX_EXTENSIONS,
+    [Lang.JavaScript]: JAVASCRIPT_EXTENSIONS,
+    js: JAVASCRIPT_EXTENSIONS,
+}).map(([key, value]) => [key.toLowerCase(), new Set(value)]));
+//# sourceMappingURL=constants.js.map

package/dist/kit/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/kit/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACtD,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAC5E,MAAM,cAAc,GAAG,CAAC,MAAM,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,0BAA0B,GAAgC,MAAM,CAAC,WAAW,CACvF,MAAM,CAAC,OAAO,CAAC;IACb,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,qBAAqB;IACxC,EAAE,EAAE,qBAAqB;IACzB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3C,GAAG,EAAE,cAAc;IACnB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,qBAAqB;IACxC,EAAE,EAAE,qBAAqB;CAC1B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAC9D,CAAC"}

package/dist/kit/errors.d.ts

@@ -0,0 +1,12 @@
+declare class CodemodError extends Error {
+    readonly cause: unknown;
+    constructor(message: string, options?: {
+        cause: unknown;
+    });
+}
+export declare class CodemodTargetNotFoundError extends CodemodError {
+    constructor(targetPath: string, options?: {
+        cause: unknown;
+    });
+}
+export {};

package/dist/kit/errors.js

@@ -0,0 +1,13 @@
+class CodemodError extends Error {
+    cause;
+    constructor(message, options) {
+        super(message);
+        this.cause = options?.cause;
+    }
+}
+export class CodemodTargetNotFoundError extends CodemodError {
+    constructor(targetPath, options) {
+        super(`No file or directory found at '${targetPath}'`, options);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/kit/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/kit/errors.ts"],"names":[],"mappings":"AAAA,MAAM,YAAa,SAAQ,KAAK;IACrB,KAAK,CAAU;IAExB,YAAY,OAAe,EAAE,OAA4B;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAC1D,YAAY,UAAkB,EAAE,OAA4B;QAC1D,KAAK,CAAC,kCAAkC,UAAU,GAAG,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/kit/result.d.ts

@@ -0,0 +1,4 @@
+import { ResultAsync, type Result } from 'neverthrow';
+export declare function tryCatch<T>(callback: () => T): Result<T, unknown>;
+export declare function tryCatchAsync<T>(callback: () => Promise<T>): ResultAsync<T, unknown>;
+export declare function toError(value: unknown): Error;

package/dist/kit/result.js

@@ -0,0 +1,18 @@
+import { err, ok, ResultAsync } from 'neverthrow';
+export function tryCatch(callback) {
+    try {
+        return ok(callback());
+    }
+    catch (error) {
+        return err(error);
+    }
+}
+export function tryCatchAsync(callback) {
+    return ResultAsync.fromPromise(callback(), e => e);
+}
+export function toError(value) {
+    if (value instanceof Error)
+        return value;
+    return new Error(String(value));
+}
+//# sourceMappingURL=result.js.map

package/dist/kit/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/kit/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AAE/D,MAAM,UAAU,QAAQ,CAAI,QAAiB;IAC3C,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,QAA0B;IACzD,OAAO,WAAW,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/kit/runner.d.ts

@@ -0,0 +1,13 @@
+import type { CodemodConfig } from './config.ts';
+import type { Codemod, RunCodemodResult } from './types.ts';
+type RunCodemodHooks<C extends Codemod = Codemod> = {
+    targetFiltering?: (filepath: string, codemod: C) => boolean;
+    preCodemodRun?: (codemod: C) => Promise<void>;
+    postTransform?: (transformedContent: string, codemod: C) => Promise<string>;
+};
+type RunCodemodOptions<C extends Codemod = Codemod> = {
+    hooks?: RunCodemodHooks<C>;
+    rootPaths?: Array<string>;
+};
+export declare function runCodemod<C extends Codemod = Codemod>(codemod: C, config: CodemodConfig, options?: RunCodemodOptions<C>): Promise<Array<RunCodemodResult>>;
+export {};

package/dist/kit/runner.js

@@ -0,0 +1,126 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import fg from 'fast-glob';
+import { err, ok } from 'neverthrow';
+import { compactMap, groupBy } from '../utils/arrays.js';
+import { collectionIsEmpty } from './collections.js';
+import { LANG_TO_EXTENSIONS_MAPPING } from './constants.js';
+import { CodemodTargetNotFoundError } from './errors.js';
+import { toError, tryCatchAsync } from './result.js';
+function getSupportedExtensions(codemod) {
+    return new Set(Array.from(codemod.languages).reduce((acc, language) => {
+        const mappedExtensions = LANG_TO_EXTENSIONS_MAPPING[language.toLowerCase()];
+        if (mappedExtensions == null)
+            return acc;
+        return acc.concat(Array.from(mappedExtensions));
+    }, []));
+}
+async function transformFile(codemod, fullPath, filepath, hooks, enableLogging, runInDryMode, root) {
+    try {
+        const content = await fs.readFile(fullPath, { encoding: 'utf-8' });
+        const modifiedContent = await codemod.transformer(content, fullPath);
+        const hasChanges = modifiedContent !== content;
+        if (hasChanges) {
+            const transformedContent = await hooks.postTransform(modifiedContent, codemod);
+            if (!runInDryMode) {
+                await fs.writeFile(fullPath, transformedContent);
+            }
+            if (enableLogging) {
+                console.log(`🚀 finished '${codemod.name}'`, { filename: filepath });
+            }
+        }
+        return ok({ hasChanges, content: modifiedContent, fullPath, root });
+    }
+    catch (error) {
+        if (enableLogging) {
+            console.error(`❌ '${codemod.name}' failed to parse file`, filepath, error);
+        }
+        return err(toError(error));
+    }
+}
+async function runPostTransformHook(codemod, results, rootPaths) {
+    const successes = compactMap(results, result => {
+        if (result.isErr())
+            return undefined;
+        return result.value;
+    });
+    const successesGroupedByRoot = groupBy(successes, 'root');
+    const rootPathsWithResults = rootPaths.map(root => ({
+        root,
+        results: successesGroupedByRoot[root] ?? [],
+    }));
+    await Promise.all(rootPathsWithResults.map(r => (codemod.postTransform ?? (async () => { }))(r, codemod)));
+}
+async function resolveDirectoryTargets(codemod, transformationPath, hooks) {
+    const globItems = await fg.glob(['**/*'], { cwd: transformationPath });
+    const extensions = getSupportedExtensions(codemod);
+    const codemodTargetFiltering = codemod.targetFiltering ?? (() => true);
+    const targets = globItems.filter(filepath => {
+        if (!hooks.targetFiltering(filepath, codemod))
+            return false;
+        if (!codemodTargetFiltering(filepath, codemod))
+            return false;
+        return collectionIsEmpty(extensions) || extensions.has(path.extname(filepath));
+    });
+    return targets.map(filepath => ({
+        fullPath: path.resolve(transformationPath, filepath),
+        filepath,
+        root: path.resolve(transformationPath, filepath.split('/')[0] ?? filepath),
+    }));
+}
+function resolveFileTarget(codemod, transformationPath, hooks) {
+    const filepath = path.basename(transformationPath);
+    const extensions = getSupportedExtensions(codemod);
+    const codemodTargetFiltering = codemod.targetFiltering ?? (() => true);
+    const isTarget = hooks.targetFiltering(filepath, codemod) &&
+        codemodTargetFiltering(filepath, codemod) &&
+        (collectionIsEmpty(extensions) || extensions.has(path.extname(filepath)));
+    if (!isTarget)
+        return undefined;
+    const fullPath = path.resolve(transformationPath);
+    return { fullPath, filepath, root: path.dirname(fullPath) };
+}
+async function resolveTargetsForPath(codemod, transformationPath, hooks) {
+    const statResult = await tryCatchAsync(() => fs.stat(transformationPath));
+    if (statResult.isErr()) {
+        throw new CodemodTargetNotFoundError(transformationPath, { cause: toError(statResult.error) });
+    }
+    if (statResult.value.isFile()) {
+        const target = resolveFileTarget(codemod, transformationPath, hooks);
+        return target == null ? [] : [target];
+    }
+    return resolveDirectoryTargets(codemod, transformationPath, hooks);
+}
+function dedupeTargetsByFullPath(targetsPerPath) {
+    const seenFullPaths = new Set();
+    return targetsPerPath.flat().filter(target => {
+        if (seenFullPaths.has(target.fullPath))
+            return false;
+        seenFullPaths.add(target.fullPath);
+        return true;
+    });
+}
+function defaultedHooks(hooks) {
+    const targetFiltering = hooks?.targetFiltering ?? (() => true);
+    const postTransform = hooks?.postTransform ?? (content => Promise.resolve(content));
+    const preCodemodRun = hooks?.preCodemodRun ?? (async () => { });
+    return { targetFiltering, postTransform, preCodemodRun };
+}
+export async function runCodemod(codemod, config, options) {
+    const hooks = defaultedHooks(options?.hooks);
+    const rootPaths = options?.rootPaths ?? [];
+    const enableLogging = config.log ?? true;
+    const runInDryMode = config.dry_run ?? false;
+    await hooks.preCodemodRun(codemod);
+    const targetsPerPath = await Promise.all(config.paths.map(transformationPath => resolveTargetsForPath(codemod, transformationPath, hooks)));
+    const targets = dedupeTargetsByFullPath(targetsPerPath);
+    if (targets.length === 0)
+        return [];
+    if (enableLogging) {
+        console.log(`🧉 '${codemod.name}' targeting ${targets.length} ${targets.length === 1 ? 'file' : 'files'} to transform, chill and grab some maté`);
+    }
+    const results = await Promise.all(targets.map(target => transformFile(codemod, target.fullPath, target.filepath, hooks, enableLogging, runInDryMode, target.root)));
+    await runPostTransformHook(codemod, results, rootPaths);
+    return results;
+}
+//# sourceMappingURL=runner.js.map

package/dist/kit/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/kit/runner.ts"],"names":[],"mappings":"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"}

package/dist/kit/types.d.ts

@@ -0,0 +1,36 @@
+import type { SgRoot } from '@ast-grep/napi';
+import type { NapiLang } from '@ast-grep/napi/types/lang.js';
+import type { TypesMap } from '@ast-grep/napi/types/staticTypes.js';
+import type { Result } from 'neverthrow';
+export type RunCodemodOkResult = {
+    hasChanges: boolean;
+    content: string;
+    fullPath: string;
+    root: string;
+};
+export type RunCodemodResult = Result<RunCodemodOkResult, Error>;
+type CodemodOptions = {
+    postTransform?: Record<string, unknown>;
+};
+export type Codemod = {
+    name: string;
+    languages: Set<NapiLang> | Array<NapiLang>;
+    options?: CodemodOptions;
+    transformer: (content: string, filename?: string, codemod?: Codemod) => Promise<string>;
+    postTransform?: (results: {
+        root: string;
+        results: Array<RunCodemodOkResult>;
+    }, codemod: Codemod) => Promise<void>;
+    targetFiltering?: (filepath: string, codemod: Codemod) => boolean;
+};
+type ModificationsReport = {
+    changesApplied: number;
+};
+export type Modifications = {
+    ast: SgRoot<TypesMap>;
+    report: ModificationsReport;
+    lang: NapiLang;
+    filename: string | undefined;
+    history: Array<SgRoot<TypesMap>>;
+};
+export {};

package/dist/kit/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/kit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/kit/types.ts"],"names":[],"mappings":""}

package/dist/utils/arrays.d.ts

@@ -0,0 +1,2 @@
+export declare function compactMap<TargetElement, TransformedElement>(array: Array<TargetElement>, transformer: (value: TargetElement, index: number) => TransformedElement | null | undefined): Array<TransformedElement>;
+export declare function groupBy<T, K extends keyof T>(array: Array<T>, key: K): Record<string, Array<T>>;

package/dist/utils/arrays.js

@@ -0,0 +1,25 @@
+export function compactMap(array, transformer) {
+    const newArray = [];
+    array.forEach((item, index) => {
+        const transformedItem = transformer(item, index);
+        if (transformedItem == null) {
+            return;
+        }
+        newArray.push(transformedItem);
+    });
+    return newArray;
+}
+export function groupBy(array, key) {
+    return [...array].reduce((acc, current) => {
+        const keyValue = String(current[key]);
+        const existing = acc[keyValue];
+        if (existing == null) {
+            acc[keyValue] = [current];
+        }
+        else {
+            existing.push(current);
+        }
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=arrays.js.map

package/dist/utils/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../src/utils/arrays.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CACxB,KAA2B,EAC3B,WAA2F;IAE3F,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,OAAO,CAAuB,KAAe,EAAE,GAAM;IACnE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/utils/asserts.d.ts

@@ -0,0 +1 @@
+export declare function invariant<Assertion extends boolean>(assertion: Assertion, message?: string): asserts assertion;

package/dist/utils/asserts.js

@@ -0,0 +1,5 @@
+export function invariant(assertion, message) {
+    if (!assertion)
+        throw new Error(message ?? 'Assertion failed');
+}
+//# sourceMappingURL=asserts.js.map

package/dist/utils/asserts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asserts.js","sourceRoot":"","sources":["../../src/utils/asserts.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAA4B,SAAoB,EAAE,OAAgB;IACzF,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAC;AACjE,CAAC"}

package/dist/utils/objects.d.ts

@@ -0,0 +1,5 @@
+type Entry<T> = {
+    [K in keyof T]: [K, T[K]];
+}[keyof T];
+export declare function toEntries<Target extends object>(object: Target): Array<Entry<Target>>;
+export {};

package/dist/utils/objects.js

@@ -0,0 +1,4 @@
+export function toEntries(object) {
+    return Object.entries(object);
+}
+//# sourceMappingURL=objects.js.map

package/dist/utils/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/utils/objects.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,SAAS,CAAwB,MAAc;IAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAyB,CAAC;AACxD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kamaalio/codemods",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "A collection of codemods, runnable as a single CLI.",
   "keywords": [
     "codemod",