@venizia/dev-configs 0.4.7-4 → 0.4.7

package/README.md

@@ -105,10 +105,10 @@ Every IGNIS package and example does.
 | `@venizia/dev-configs` | Everything below, re-exported |
 | `@venizia/dev-configs/compilers` | `BunCompiler` |
 | `@venizia/dev-configs/testing` | `RejectionHelper` (`rejectionOf`, `expectRejection`), `SpawnHelper` (`spawnSyncBounded`), `RepoTmp` (`findRoot`, `apply`) - test helpers (imports `bun:test`; tests only) |
-| `@venizia/dev-configs/linters` | `oxlintConfigs`, `OxlintConfigs`, `BrowserOxlintConfigs`, `ReactOxlintConfigs`, `LintIgnore`, `namingConventionConfigs`, `reactNamingConventionConfigs`, `houseConfigs`, `reactHouseConfigs`, `eslintConfigs`, `ReactEslintConfigs`, the rule classes and their types |
+| `@venizia/dev-configs/linters` | `oxlintConfigs`, `OxlintConfigs`, `BrowserOxlintConfigs`, `ReactOxlintConfigs`, `LintIgnore`, `namingConventionConfigs`, `reactNamingConventionConfigs`, `houseConfigs`, `reactHouseConfigs`, `eslintConfigs`, the rule classes and their types |
 | `@venizia/dev-configs/linters/oxlint` | `oxlintConfigs`, `OxlintConfigs`, `IOxlintPresetOptions`, `BrowserOxlintConfigs`, `ReactOxlintConfigs`, `LintIgnore`, the rule classes and their types: everything an oxlint config needs, and nothing that loads ESLint. Loads in milliseconds: `/linters` also loads ESLint and its plugins, which an oxlint config never uses |
 | `@venizia/dev-configs/tsconfig.base.json` | Target and lib ES2025, `module` Node16, strict mode (`noImplicitAny` and `useUnknownInCatchVariables` on) with `strictPropertyInitialization` off (DI-injected properties have no initializer), `noEmitOnError`, tests excluded |
-| `@venizia/dev-configs/tsconfig.common.json` | Extends the base and switches `module` and `moduleResolution` to `nodenext` |
+| `@venizia/dev-configs/tsconfig.common.json` | Extends the base and restates `module` as `esnext` and `moduleResolution` as `bundler` |
 | `@venizia/dev-configs/tsconfig.browser.json` | Extends the base for a browser library built with a bundler: `module` ESNext, `moduleResolution` bundler, lib ES2025 + `DOM` + `DOM.Iterable`, `types: []` so no Bun types reach `dist` |
 | `@venizia/dev-configs/tsconfig.react.json` | Extends `tsconfig.browser.json` and sets `jsx: react-jsx` |
 
@@ -250,44 +250,6 @@ conventions, `curly`, `eslint-plugin-n`, plus these IGNIS rules:
 | `@typescript-eslint/no-namespace` | `error` |
 | `unicorn/switch-case-braces` | `['error', 'always']` |
 
-### ReactEslintConfigs
-
-`ReactEslintConfigs.create({ plugins })` is `eslintConfigs` plus what a React frontend needs. The
-plugins come in as options, so a backend installs none of them:
-
-```js
-// eslint.config.mjs
-import { ReactEslintConfigs } from '@venizia/dev-configs';
-import react from 'eslint-plugin-react';
-import reactHooks from 'eslint-plugin-react-hooks';
-import jsxA11y from 'eslint-plugin-jsx-a11y';
-
-export default [
-  { ignores: ['dist/'] },
-  ...ReactEslintConfigs.create({ plugins: { react, reactHooks, jsxA11y } }),
-];
-```
-
-| Adds | Setting |
-| :--- | :--- |
-| React correctness (`jsx-key`, `no-children-prop`, `no-deprecated`, ... - 14 rules) | `error`, `.jsx`/`.tsx` |
-| `jsx-a11y` (`alt-text`, `aria-props`, `aria-role`, `click-events-have-key-events`, `label-has-associated-control`, ... - 15 rules) | `error`, `.jsx`/`.tsx` |
-| `react-hooks/rules-of-hooks` / `exhaustive-deps` | `error`, every source file |
-| `@typescript-eslint/consistent-type-imports` | `['error', { prefer: 'type-imports', fixStyle: 'inline-type-imports', disallowTypeAnnotations: false }]` |
-| `naming-convention` | the base rule, plus PascalCase functions (`function App()`), `.jsx`/`.tsx` |
-| `no-restricted-properties` | `NoRestrictedPropertiesRule.build()` - bans `crypto.randomUUID` |
-
-Nothing in the base is relaxed: frontend code meets the backend's standard, so a floating promise, a
-`void`, a use before declaration or a shadowed name fails the lint as it does in a service.
-
-Rules the automatic JSX runtime or `tsc` already enforce (`react-in-jsx-scope`, `prop-types`,
-`jsx-no-undef`, ...) are left out.
-
-- `reactVersion` defaults to `'detect'`. Under ESLint 10, eslint-plugin-react 7 cannot detect it and
-  aborts - pass the version: `create({ plugins, reactVersion: '19.2' })`.
-- In an `eslint.config.ts`, `eslint-plugin-jsx-a11y` needs `@types/eslint-plugin-jsx-a11y`.
-- `consistent-type-imports` uses `fixStyle: inline-type-imports`, the same as the base preset.
-
 ### BrowserOxlintConfigs
 
 `BrowserOxlintConfigs.create()` is `oxlintConfigs` plus `NoRestrictedPropertiesRule.build()`. That

package/dist/cli/codemod/connector-imports.d.ts

@@ -0,0 +1,43 @@
+/** The removed `@venizia/ignis/<sub-path>` specifiers and the `@venizia/ignis-connectors/<sub-path>` they became. */
+export declare class ConnectorSpecifiers {
+    static readonly SUBPATHS: ReadonlyArray<string>;
+    static readonly MOVES: ReadonlyMap<string, string>;
+}
+export interface IConnectorImportsResult {
+    output: string;
+    changed: boolean;
+    /** How many specifiers were moved. */
+    rewritten: number;
+}
+/** Rewrites the module specifiers of the removed connector sub-paths. */
+export declare class ConnectorImports {
+    static rewrite(opts: {
+        typescript: typeof import('typescript');
+        fileName: string;
+        source: string;
+    }): IConnectorImportsResult;
+    /**
+     * The `package.json` nearest to `file` (not above `root`), and whether it lists the connectors package; `undefined` when
+     * there is none to read.
+     */
+    static findManifest(opts: {
+        file: string;
+        root: string;
+    }): {
+        path: string;
+        hasConnectors: boolean;
+    } | undefined;
+}
+/**
+ * `devz codemod connector-imports [paths...] [--write | --check]`: moves the removed
+ * `@venizia/ignis/<connector sub-path>` specifiers to `@venizia/ignis-connectors`. It is a dry run unless `--write`
+ * is given. `--check` is the same dry run, and exits 1 while a file would change.
+ */
+export declare class ConnectorImportsCommand {
+    static readonly USAGE = "Usage: devz codemod connector-imports [paths...] [--write | --check]\n\nMoves the connector sub-path imports of @venizia/ignis to @venizia/ignis-connectors. The sub-paths\n@venizia/ignis/postgres, /postgres/node-postgres, /postgres/postgres-js, /postgres/pglite,\n/postgres/supabase, /relational, /sqlite, /sqlite/libsql, /search, /search/controllers, /meilisearch,\n/typesense and /typesense/controllers are removed; each one is the same name under\n@venizia/ignis-connectors, so the rewrite changes only the specifier.\n\nIt reads TypeScript files (.ts, .tsx, .mts, .cts): import and export declarations, import(\"...\"),\nrequire(\"...\"), require.resolve(\"...\") and import.meta.resolve(\"...\"), import(\"...\") types, declare module\n\"...\" and the module name of mock.module(\"...\") style calls. A .js, .cjs or .mjs file is not read: edit it by hand. Other sub-paths of @venizia/ignis (mail, static-asset,\ntesting, websocket, ...) and the root are not touched. The app must list @venizia/ignis-connectors as a\ndirect dependency: it reports each package.json that does not.\n\n  --write    write the changed files (without it, nothing is written)\n  --check    dry run that exits 1 while a file would change (for CI)\n  --help     print this text and exit\n\nWith no flag it lists what would change and writes nothing. Inside a git repository it reads the\nfiles git knows (tracked, or untracked and not ignored), and --write refuses a file with local changes\n(changed, staged or untracked): commit or stash it first, so git can undo the codemod.";
+    static run(opts: {
+        root: string;
+        args: string[];
+    }): Promise<number>;
+}
+//# sourceMappingURL=connector-imports.d.ts.map

package/dist/cli/codemod/connector-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-imports.d.ts","sourceRoot":"","sources":["../../../src/cli/codemod/connector-imports.ts"],"names":[],"mappings":"AA8DA,qHAAqH;AACrH,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAc7C;IAEF,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAKhD;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QACnB,UAAU,EAAE,cAAc,YAAY,CAAC,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,uBAAuB;IAkF3B;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS;CAoCzD;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,KAAK,4hDAAS;WAEjB,GAAG,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAwH1E"}

package/dist/cli/codemod/connector-imports.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorImportsCommand = exports.ConnectorImports = exports.ConnectorSpecifiers = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const files_1 = require("./files");
+const USAGE = `Usage: devz codemod connector-imports [paths...] [--write | --check]
+
+Moves the connector sub-path imports of @venizia/ignis to @venizia/ignis-connectors. The sub-paths
+@venizia/ignis/postgres, /postgres/node-postgres, /postgres/postgres-js, /postgres/pglite,
+/postgres/supabase, /relational, /sqlite, /sqlite/libsql, /search, /search/controllers, /meilisearch,
+/typesense and /typesense/controllers are removed; each one is the same name under
+@venizia/ignis-connectors, so the rewrite changes only the specifier.
+
+It reads TypeScript files (.ts, .tsx, .mts, .cts): import and export declarations, import("..."),
+require("..."), require.resolve("...") and import.meta.resolve("..."), import("...") types, declare module
+"..." and the module name of mock.module("...") style calls. A .js, .cjs or .mjs file is not read: edit it by hand. Other sub-paths of @venizia/ignis (mail, static-asset,
+testing, websocket, ...) and the root are not touched. The app must list @venizia/ignis-connectors as a
+direct dependency: it reports each package.json that does not.
+
+  --write    write the changed files (without it, nothing is written)
+  --check    dry run that exits 1 while a file would change (for CI)
+  --help     print this text and exit
+
+With no flag it lists what would change and writes nothing. Inside a git repository it reads the
+files git knows (tracked, or untracked and not ignored), and --write refuses a file with local changes
+(changed, staged or untracked): commit or stash it first, so git can undo the codemod.`;
+/** A usage error: nothing was read or written. */
+const USAGE_ERROR_CODE = 2;
+const CONNECTORS_PACKAGE = '@venizia/ignis-connectors';
+const OLD_PREFIX = '@venizia/ignis/';
+/** The call names that take a module name as their first argument besides `require` and `import()`. */
+const MODULE_NAME_CALLS = new Set([
+    'module',
+    'mock',
+    'doMock',
+    'unmock',
+    'importActual',
+    'requireActual',
+    'importMock',
+    'requireMock',
+]);
+class ConnectorImportsFlags {
+    static { this.WRITE = '--write'; }
+    static { this.CHECK = '--check'; }
+    static { this.HELP = '--help'; }
+    static { this.HELP_SHORT = '-h'; }
+    static { this.SCHEME_SET = new Set([
+        this.WRITE,
+        this.CHECK,
+        this.HELP,
+        this.HELP_SHORT,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+/** The removed `@venizia/ignis/<sub-path>` specifiers and the `@venizia/ignis-connectors/<sub-path>` they became. */
+class ConnectorSpecifiers {
+    static { this.SUBPATHS = [
+        'postgres',
+        'postgres/node-postgres',
+        'postgres/postgres-js',
+        'postgres/pglite',
+        'postgres/supabase',
+        'relational',
+        'sqlite',
+        'sqlite/libsql',
+        'search',
+        'search/controllers',
+        'meilisearch',
+        'typesense',
+        'typesense/controllers',
+    ]; }
+    static { this.MOVES = new Map(ConnectorSpecifiers.SUBPATHS.map((subpath) => [
+        `${OLD_PREFIX}${subpath}`,
+        `${CONNECTORS_PACKAGE}/${subpath}`,
+    ])); }
+}
+exports.ConnectorSpecifiers = ConnectorSpecifiers;
+/** Rewrites the module specifiers of the removed connector sub-paths. */
+class ConnectorImports {
+    static rewrite(opts) {
+        const { typescript: ts, fileName, source } = opts;
+        const scriptKind = fileName.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+        const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, scriptKind);
+        const edits = [];
+        const consider = (literal) => {
+            if (!literal || !ts.isStringLiteralLike(literal)) {
+                return;
+            }
+            const moved = ConnectorSpecifiers.MOVES.get(literal.text);
+            if (moved === undefined) {
+                return;
+            }
+            const start = literal.getStart(file);
+            const quote = source[start];
+            edits.push({ start, end: literal.getEnd(), text: `${quote}${moved}${quote}` });
+        };
+        const isModuleNameCall = (call) => {
+            const callee = call.expression;
+            if (callee.kind === ts.SyntaxKind.ImportKeyword) {
+                return true;
+            }
+            if (ts.isIdentifier(callee)) {
+                return callee.text === 'require';
+            }
+            if (!ts.isPropertyAccessExpression(callee)) {
+                return false;
+            }
+            if (callee.name.text === 'resolve') {
+                return ((ts.isIdentifier(callee.expression) && callee.expression.text === 'require') ||
+                    ts.isMetaProperty(callee.expression));
+            }
+            return MODULE_NAME_CALLS.has(callee.name.text);
+        };
+        const visit = (node) => {
+            if (ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) {
+                consider(node.moduleSpecifier);
+            }
+            else if (ts.isImportEqualsDeclaration(node)) {
+                if (ts.isExternalModuleReference(node.moduleReference)) {
+                    consider(node.moduleReference.expression);
+                }
+            }
+            else if (ts.isCallExpression(node)) {
+                if (isModuleNameCall(node)) {
+                    consider(node.arguments[0]);
+                }
+            }
+            else if (ts.isModuleDeclaration(node)) {
+                consider(node.name);
+            }
+            else if (ts.isImportTypeNode(node)) {
+                if (ts.isLiteralTypeNode(node.argument)) {
+                    consider(node.argument.literal);
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(file);
+        if (edits.length === 0) {
+            return { output: source, changed: false, rewritten: 0 };
+        }
+        let output = source;
+        for (const edit of edits.sort((a, b) => b.start - a.start)) {
+            output = output.slice(0, edit.start) + edit.text + output.slice(edit.end);
+        }
+        return { output, changed: true, rewritten: edits.length };
+    }
+    /**
+     * The `package.json` nearest to `file` (not above `root`), and whether it lists the connectors package; `undefined` when
+     * there is none to read.
+     */
+    static findManifest(opts) {
+        const { file, root } = opts;
+        let directory = (0, node_path_1.dirname)(file);
+        for (;;) {
+            const candidate = (0, node_path_1.join)(directory, 'package.json');
+            if ((0, node_fs_1.existsSync)(candidate)) {
+                let manifest;
+                try {
+                    manifest = JSON.parse((0, node_fs_1.readFileSync)(candidate, 'utf8'));
+                }
+                catch (error) {
+                    console.warn(`${candidate}  is not valid JSON, so its dependencies were not checked | ${error instanceof Error ? error.message : String(error)}`);
+                    return undefined;
+                }
+                const listed = typeof manifest === 'object' &&
+                    manifest !== null &&
+                    ['dependencies', 'devDependencies', 'peerDependencies'].some((field) => {
+                        const group = Reflect.get(manifest, field);
+                        return typeof group === 'object' && group !== null && CONNECTORS_PACKAGE in group;
+                    });
+                return { path: candidate, hasConnectors: listed };
+            }
+            if (directory === root || (0, node_path_1.dirname)(directory) === directory) {
+                return undefined;
+            }
+            directory = (0, node_path_1.dirname)(directory);
+        }
+    }
+}
+exports.ConnectorImports = ConnectorImports;
+/**
+ * `devz codemod connector-imports [paths...] [--write | --check]`: moves the removed
+ * `@venizia/ignis/<connector sub-path>` specifiers to `@venizia/ignis-connectors`. It is a dry run unless `--write`
+ * is given. `--check` is the same dry run, and exits 1 while a file would change.
+ */
+class ConnectorImportsCommand {
+    static { this.USAGE = USAGE; }
+    static async run(opts) {
+        const { root, args } = opts;
+        if (args.includes(ConnectorImportsFlags.HELP) ||
+            args.includes(ConnectorImportsFlags.HELP_SHORT)) {
+            console.log(USAGE);
+            return 0;
+        }
+        const flags = args.filter((argument) => argument.startsWith('-'));
+        const paths = args.filter((argument) => !argument.startsWith('-'));
+        const unknown = flags.filter((flag) => !ConnectorImportsFlags.isValid(flag));
+        if (unknown.length > 0) {
+            console.error(`devz codemod: unknown option ${unknown.map((flag) => `"${flag}"`).join(', ')}\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const isWrite = flags.includes(ConnectorImportsFlags.WRITE);
+        const isCheck = flags.includes(ConnectorImportsFlags.CHECK);
+        if (isWrite && isCheck) {
+            console.error(`devz codemod: ${ConnectorImportsFlags.WRITE} and ${ConnectorImportsFlags.CHECK} contradict each other\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        let typescript;
+        try {
+            const loaded = await import('typescript');
+            typescript = loaded.default;
+        }
+        catch {
+            console.error('devz codemod: the "typescript" package is required to read your sources');
+            return 1;
+        }
+        const targets = (paths.length > 0 ? paths : ['.']).map((path) => (0, node_path_1.resolve)(root, path));
+        const missing = new Set();
+        let changedCount = 0;
+        let specifierCount = 0;
+        let refusedCount = 0;
+        for (const target of targets) {
+            const files = files_1.CodemodFiles.collect({ target });
+            const dirty = isWrite ? files_1.CodemodFiles.dirty({ target }) : undefined;
+            if (files.length === 0 && paths.length > 0) {
+                console.warn(`devz codemod: no source files under "${(0, node_path_1.relative)(root, target) || target}" (git ignores the path, or it holds none): nothing was read`);
+            }
+            for (const file of files) {
+                const source = (0, node_fs_1.readFileSync)(file, 'utf8');
+                if (!source.includes(OLD_PREFIX)) {
+                    continue;
+                }
+                const result = ConnectorImports.rewrite({ typescript, fileName: file, source });
+                if (!result.changed) {
+                    continue;
+                }
+                const shown = (0, node_path_1.relative)(root, file).split('\\').join('/') || file;
+                if (dirty?.has(file)) {
+                    refusedCount += 1;
+                    console.warn(`refused  ${shown}  has local changes (commit or stash them, then run again)`);
+                    continue;
+                }
+                changedCount += 1;
+                specifierCount += result.rewritten;
+                console.log(`${isWrite ? 'changed' : 'would change'}  ${shown}  (${result.rewritten} specifier(s))`);
+                const manifest = ConnectorImports.findManifest({ file, root });
+                if (manifest && !manifest.hasConnectors) {
+                    missing.add((0, node_path_1.relative)(root, manifest.path).split('\\').join('/') || manifest.path);
+                }
+                if (isWrite) {
+                    (0, node_fs_1.writeFileSync)(file, result.output);
+                }
+            }
+        }
+        console.log(`devz codemod connector-imports: ${changedCount} file(s) ${isWrite ? 'changed' : 'would change'}, ${specifierCount} specifier(s) ${isWrite ? 'moved' : 'would be moved'}` +
+            (refusedCount > 0 ? `, ${refusedCount} refused` : ''));
+        for (const manifestPath of [...missing].sort()) {
+            console.warn(`${manifestPath}  does not list ${CONNECTORS_PACKAGE}: add it as a dependency, because the imports now come from it`);
+        }
+        if (!isWrite && changedCount > 0) {
+            console.log(`Nothing was written. Run again with ${ConnectorImportsFlags.WRITE} to apply, then add the dependency and run your typecheck.`);
+        }
+        if (isWrite && refusedCount > 0) {
+            return 1;
+        }
+        return isCheck && changedCount > 0 ? 1 : 0;
+    }
+}
+exports.ConnectorImportsCommand = ConnectorImportsCommand;
+//# sourceMappingURL=connector-imports.js.map

package/dist/cli/codemod/connector-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-imports.js","sourceRoot":"","sources":["../../../src/cli/codemod/connector-imports.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { CodemodFiles } from './files';\n\nconst USAGE = `Usage: devz codemod connector-imports [paths...] [--write | --check]\n\nMoves the connector sub-path imports of @venizia/ignis to @venizia/ignis-connectors. The sub-paths\n@venizia/ignis/postgres, /postgres/node-postgres, /postgres/postgres-js, /postgres/pglite,\n/postgres/supabase, /relational, /sqlite, /sqlite/libsql, /search, /search/controllers, /meilisearch,\n/typesense and /typesense/controllers are removed; each one is the same name under\n@venizia/ignis-connectors, so the rewrite changes only the specifier.\n\nIt reads TypeScript files (.ts, .tsx, .mts, .cts): import and export declarations, import(\"...\"),\nrequire(\"...\"), require.resolve(\"...\") and import.meta.resolve(\"...\"), import(\"...\") types, declare module\n\"...\" and the module name of mock.module(\"...\") style calls. A .js, .cjs or .mjs file is not read: edit it by hand. Other sub-paths of @venizia/ignis (mail, static-asset,\ntesting, websocket, ...) and the root are not touched. The app must list @venizia/ignis-connectors as a\ndirect dependency: it reports each package.json that does not.\n\n  --write    write the changed files (without it, nothing is written)\n  --check    dry run that exits 1 while a file would change (for CI)\n  --help     print this text and exit\n\nWith no flag it lists what would change and writes nothing. Inside a git repository it reads the\nfiles git knows (tracked, or untracked and not ignored), and --write refuses a file with local changes\n(changed, staged or untracked): commit or stash it first, so git can undo the codemod.`;\n\n/** A usage error: nothing was read or written. */\nconst USAGE_ERROR_CODE = 2;\n\nconst CONNECTORS_PACKAGE = '@venizia/ignis-connectors';\nconst OLD_PREFIX = '@venizia/ignis/';\n\n/** The call names that take a module name as their first argument besides `require` and `import()`. */\nconst MODULE_NAME_CALLS = new Set([\n  'module',\n  'mock',\n  'doMock',\n  'unmock',\n  'importActual',\n  'requireActual',\n  'importMock',\n  'requireMock',\n]);\n\nclass ConnectorImportsFlags {\n  static readonly WRITE = '--write';\n  static readonly CHECK = '--check';\n  static readonly HELP = '--help';\n  static readonly HELP_SHORT = '-h';\n\n  static readonly SCHEME_SET = new Set<string>([\n    this.WRITE,\n    this.CHECK,\n    this.HELP,\n    this.HELP_SHORT,\n  ]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\n/** The removed `@venizia/ignis/<sub-path>` specifiers and the `@venizia/ignis-connectors/<sub-path>` they became. */\nexport class ConnectorSpecifiers {\n  static readonly SUBPATHS: ReadonlyArray<string> = [\n    'postgres',\n    'postgres/node-postgres',\n    'postgres/postgres-js',\n    'postgres/pglite',\n    'postgres/supabase',\n    'relational',\n    'sqlite',\n    'sqlite/libsql',\n    'search',\n    'search/controllers',\n    'meilisearch',\n    'typesense',\n    'typesense/controllers',\n  ];\n\n  static readonly MOVES: ReadonlyMap<string, string> = new Map(\n    ConnectorSpecifiers.SUBPATHS.map((subpath) => [\n      `${OLD_PREFIX}${subpath}`,\n      `${CONNECTORS_PACKAGE}/${subpath}`,\n    ]),\n  );\n}\n\nexport interface IConnectorImportsResult {\n  output: string;\n  changed: boolean;\n  /** How many specifiers were moved. */\n  rewritten: number;\n}\n\n/** Rewrites the module specifiers of the removed connector sub-paths. */\nexport class ConnectorImports {\n  static rewrite(opts: {\n    typescript: typeof import('typescript');\n    fileName: string;\n    source: string;\n  }): IConnectorImportsResult {\n    const { typescript: ts, fileName, source } = opts;\n    const scriptKind = fileName.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS;\n    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, scriptKind);\n    const edits: Array<{ start: number; end: number; text: string }> = [];\n\n    const consider = (literal: import('typescript').Node | undefined) => {\n      if (!literal || !ts.isStringLiteralLike(literal)) {\n        return;\n      }\n\n      const moved = ConnectorSpecifiers.MOVES.get(literal.text);\n      if (moved === undefined) {\n        return;\n      }\n\n      const start = literal.getStart(file);\n      const quote = source[start];\n      edits.push({ start, end: literal.getEnd(), text: `${quote}${moved}${quote}` });\n    };\n\n    const isModuleNameCall = (call: import('typescript').CallExpression): boolean => {\n      const callee = call.expression;\n\n      if (callee.kind === ts.SyntaxKind.ImportKeyword) {\n        return true;\n      }\n\n      if (ts.isIdentifier(callee)) {\n        return callee.text === 'require';\n      }\n\n      if (!ts.isPropertyAccessExpression(callee)) {\n        return false;\n      }\n\n      if (callee.name.text === 'resolve') {\n        return (\n          (ts.isIdentifier(callee.expression) && callee.expression.text === 'require') ||\n          ts.isMetaProperty(callee.expression)\n        );\n      }\n\n      return MODULE_NAME_CALLS.has(callee.name.text);\n    };\n\n    const visit = (node: import('typescript').Node): void => {\n      if (ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) {\n        consider(node.moduleSpecifier);\n      } else if (ts.isImportEqualsDeclaration(node)) {\n        if (ts.isExternalModuleReference(node.moduleReference)) {\n          consider(node.moduleReference.expression);\n        }\n      } else if (ts.isCallExpression(node)) {\n        if (isModuleNameCall(node)) {\n          consider(node.arguments[0]);\n        }\n      } else if (ts.isModuleDeclaration(node)) {\n        consider(node.name);\n      } else if (ts.isImportTypeNode(node)) {\n        if (ts.isLiteralTypeNode(node.argument)) {\n          consider(node.argument.literal);\n        }\n      }\n\n      ts.forEachChild(node, visit);\n    };\n\n    visit(file);\n\n    if (edits.length === 0) {\n      return { output: source, changed: false, rewritten: 0 };\n    }\n\n    let output = source;\n    for (const edit of edits.sort((a, b) => b.start - a.start)) {\n      output = output.slice(0, edit.start) + edit.text + output.slice(edit.end);\n    }\n\n    return { output, changed: true, rewritten: edits.length };\n  }\n\n  /**\n   * The `package.json` nearest to `file` (not above `root`), and whether it lists the connectors package; `undefined` when\n   * there is none to read.\n   */\n  static findManifest(opts: {\n    file: string;\n    root: string;\n  }): { path: string; hasConnectors: boolean } | undefined {\n    const { file, root } = opts;\n    let directory = dirname(file);\n\n    for (;;) {\n      const candidate = join(directory, 'package.json');\n\n      if (existsSync(candidate)) {\n        let manifest: unknown;\n        try {\n          manifest = JSON.parse(readFileSync(candidate, 'utf8'));\n        } catch (error) {\n          console.warn(\n            `${candidate}  is not valid JSON, so its dependencies were not checked | ${error instanceof Error ? error.message : String(error)}`,\n          );\n          return undefined;\n        }\n\n        const listed =\n          typeof manifest === 'object' &&\n          manifest !== null &&\n          ['dependencies', 'devDependencies', 'peerDependencies'].some((field) => {\n            const group: unknown = Reflect.get(manifest, field);\n            return typeof group === 'object' && group !== null && CONNECTORS_PACKAGE in group;\n          });\n\n        return { path: candidate, hasConnectors: listed };\n      }\n\n      if (directory === root || dirname(directory) === directory) {\n        return undefined;\n      }\n\n      directory = dirname(directory);\n    }\n  }\n}\n\n/**\n * `devz codemod connector-imports [paths...] [--write | --check]`: moves the removed\n * `@venizia/ignis/<connector sub-path>` specifiers to `@venizia/ignis-connectors`. It is a dry run unless `--write`\n * is given. `--check` is the same dry run, and exits 1 while a file would change.\n */\nexport class ConnectorImportsCommand {\n  static readonly USAGE = USAGE;\n\n  static async run(opts: { root: string; args: string[] }): Promise<number> {\n    const { root, args } = opts;\n\n    if (\n      args.includes(ConnectorImportsFlags.HELP) ||\n      args.includes(ConnectorImportsFlags.HELP_SHORT)\n    ) {\n      console.log(USAGE);\n      return 0;\n    }\n\n    const flags = args.filter((argument) => argument.startsWith('-'));\n    const paths = args.filter((argument) => !argument.startsWith('-'));\n\n    const unknown = flags.filter((flag) => !ConnectorImportsFlags.isValid(flag));\n    if (unknown.length > 0) {\n      console.error(\n        `devz codemod: unknown option ${unknown.map((flag) => `\"${flag}\"`).join(', ')}\\n${USAGE}`,\n      );\n      return USAGE_ERROR_CODE;\n    }\n\n    const isWrite = flags.includes(ConnectorImportsFlags.WRITE);\n    const isCheck = flags.includes(ConnectorImportsFlags.CHECK);\n\n    if (isWrite && isCheck) {\n      console.error(\n        `devz codemod: ${ConnectorImportsFlags.WRITE} and ${ConnectorImportsFlags.CHECK} contradict each other\\n${USAGE}`,\n      );\n      return USAGE_ERROR_CODE;\n    }\n\n    let typescript: typeof import('typescript');\n    try {\n      const loaded = await import('typescript');\n      typescript = loaded.default;\n    } catch {\n      console.error('devz codemod: the \"typescript\" package is required to read your sources');\n      return 1;\n    }\n\n    const targets = (paths.length > 0 ? paths : ['.']).map((path) => resolve(root, path));\n    const missing = new Set<string>();\n    let changedCount = 0;\n    let specifierCount = 0;\n    let refusedCount = 0;\n\n    for (const target of targets) {\n      const files = CodemodFiles.collect({ target });\n      const dirty = isWrite ? CodemodFiles.dirty({ target }) : undefined;\n\n      if (files.length === 0 && paths.length > 0) {\n        console.warn(\n          `devz codemod: no source files under \"${relative(root, target) || target}\" (git ignores the path, or it holds none): nothing was read`,\n        );\n      }\n\n      for (const file of files) {\n        const source = readFileSync(file, 'utf8');\n\n        if (!source.includes(OLD_PREFIX)) {\n          continue;\n        }\n\n        const result = ConnectorImports.rewrite({ typescript, fileName: file, source });\n\n        if (!result.changed) {\n          continue;\n        }\n\n        const shown = relative(root, file).split('\\\\').join('/') || file;\n\n        if (dirty?.has(file)) {\n          refusedCount += 1;\n          console.warn(\n            `refused  ${shown}  has local changes (commit or stash them, then run again)`,\n          );\n          continue;\n        }\n\n        changedCount += 1;\n        specifierCount += result.rewritten;\n        console.log(\n          `${isWrite ? 'changed' : 'would change'}  ${shown}  (${result.rewritten} specifier(s))`,\n        );\n\n        const manifest = ConnectorImports.findManifest({ file, root });\n        if (manifest && !manifest.hasConnectors) {\n          missing.add(relative(root, manifest.path).split('\\\\').join('/') || manifest.path);\n        }\n\n        if (isWrite) {\n          writeFileSync(file, result.output);\n        }\n      }\n    }\n\n    console.log(\n      `devz codemod connector-imports: ${changedCount} file(s) ${isWrite ? 'changed' : 'would change'}, ${specifierCount} specifier(s) ${isWrite ? 'moved' : 'would be moved'}` +\n        (refusedCount > 0 ? `, ${refusedCount} refused` : ''),\n    );\n\n    for (const manifestPath of [...missing].sort()) {\n      console.warn(\n        `${manifestPath}  does not list ${CONNECTORS_PACKAGE}: add it as a dependency, because the imports now come from it`,\n      );\n    }\n\n    if (!isWrite && changedCount > 0) {\n      console.log(\n        `Nothing was written. Run again with ${ConnectorImportsFlags.WRITE} to apply, then add the dependency and run your typecheck.`,\n      );\n    }\n\n    if (isWrite && refusedCount > 0) {\n      return 1;\n    }\n\n    return isCheck && changedCount > 0 ? 1 : 0;\n  }\n}\n"]}

package/dist/cli/codemod/const-classes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"const-classes.d.ts","sourceRoot":"","sources":["../../../src/cli/codemod/const-classes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,KAAK,WAAW,GAAG,OAAO,EAAE,CAAC;AAU7B,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AA4CD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QACnB,UAAU,EAAE,WAAW,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,4FAA4F;QAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,cAAc,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,iBAAiB;IA4KrB,OAAO,CAAC,MAAM,CAAC,WAAW;IA8C1B,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,aAAa;IAoD5B,OAAO,CAAC,MAAM,CAAC,UAAU;IAQzB,iIAAiI;IACjI,OAAO,CAAC,MAAM,CAAC,SAAS;IA+BxB,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAC,YAAY;IAuB3B,OAAO,CAAC,MAAM,CAAC,SAAS;IAqCxB,OAAO,CAAC,MAAM,CAAC,WAAW;IAuB1B,sHAAsH;IACtH,OAAO,CAAC,MAAM,CAAC,UAAU;IAkCzB,OAAO,CAAC,MAAM,CAAC,QAAQ;IA2BvB,wJAAwJ;IACxJ,OAAO,CAAC,MAAM,CAAC,UAAU;CAqD1B;AA4DD,mEAAmE;AACnE,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,yxDAAS;WAEjB,GAAG,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAuL1E"}
+{"version":3,"file":"const-classes.d.ts","sourceRoot":"","sources":["../../../src/cli/codemod/const-classes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,KAAK,WAAW,GAAG,OAAO,EAAE,CAAC;AAU7B,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AA4CD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QACnB,UAAU,EAAE,WAAW,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,4FAA4F;QAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,cAAc,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,iBAAiB;IA4KrB,OAAO,CAAC,MAAM,CAAC,WAAW;IA8C1B,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,aAAa;IAoD5B,OAAO,CAAC,MAAM,CAAC,UAAU;IAQzB,iIAAiI;IACjI,OAAO,CAAC,MAAM,CAAC,SAAS;IA+BxB,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAC,YAAY;IAuB3B,OAAO,CAAC,MAAM,CAAC,SAAS;IAqCxB,OAAO,CAAC,MAAM,CAAC,WAAW;IAsB1B,sHAAsH;IACtH,OAAO,CAAC,MAAM,CAAC,UAAU;IAkCzB,OAAO,CAAC,MAAM,CAAC,QAAQ;IA2BvB,wJAAwJ;IACxJ,OAAO,CAAC,MAAM,CAAC,UAAU;CAqD1B;AA4DD,mEAAmE;AACnE,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,yxDAAS;WAEjB,GAAG,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAuL1E"}

package/dist/cli/codemod/const-classes.js

@@ -323,7 +323,6 @@ class ConstClasses {
         const { className, typeName, members } = opts;
         const quote = (value) => `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
         const lines = [
-            `/** The values of \`${typeName}\`. */`,
             `export class ${className} {`,
             ...members.map(({ value, key }) => `  static readonly ${key} = ${quote(value)};`),
             '',